你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
该包包含一个同构的 SDK(既能在 Node.js 中运行,也可在浏览器中运行),适用于 AgentPlatform 客户端Azure。
Kore.AgentPlatform 资源提供商,用于管理 Kore AI 代理平台组织及其工作空间。
组织是顶级的跟踪ARM资源。 每个组织都与默认工作区一起配置。 额外的工作区作为子代理资源类型在组织下管理,使用工作区URL上的标准ARM动词(PUT / DELETE / GET / LIST)。
Liftr与Kore之间的服务对服务认证使用联邦的Microsoft Entra凭证,并在运行时层强制执行(而非ARM表面)。
关键链接:
入门
目前支持的环境
- Node.js的 LTS 版本
- 最新版本的 Safari、Chrome、Edge 和 Firefox。
有关更多详细信息,请参阅我们的支持政策。
Prerequisites
安装 @azure/arm-koreaiartemis 包
安装Azure AgentPlatform client library for JavaScript,使用:npm
npm install @azure/arm-koreaiartemis
创建和验证 AgentPlatformClient
要创建客户端对象访问 Azure AgentPlatform API,你需要 Azure AgentPlatform 资源中的 credential和 endpoint 。 Azure AgentPlatform 客户端可以使用 Microsoft Entra 凭证进行认证。
您可以在 Azure 门户 中找到您的 Azure AgentPlatform 资源的端点。
你可以用@azure/identity库中的凭据或现有的Microsoft Entra令牌进行Microsoft Entra ID认证。
若要使用如下所示的 DefaultAzureCredential 提供程序,或 Azure SDK 提供的其他凭据提供程序,请安装 @azure/identity 包:
npm install @azure/identity
你还需要注册一个新的 Microsoft Entra 应用,并通过将合适的角色分配给你的服务主体来授予 Azure AgentPlatform 访问权限(注意:此类"Owner"角色不会授予必要的权限)。
想了解更多关于如何创建 Microsoft Entra 应用的信息,请查看这份指南。
使用 Node.js 和类似 Node 的环境,可以使用 DefaultAzureCredential 类对客户端进行身份验证。
import { AgentPlatformClient } from "@azure/arm-koreaiartemis";
import { DefaultAzureCredential } from "@azure/identity";
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new AgentPlatformClient(new DefaultAzureCredential(), subscriptionId);
对于浏览器环境,请使用 InteractiveBrowserCredential 包中的 @azure/identity 进行身份验证。
import { InteractiveBrowserCredential } from "@azure/identity";
import { AgentPlatformClient } from "@azure/arm-koreaiartemis";
const credential = new InteractiveBrowserCredential({
tenantId: "<YOUR_TENANT_ID>",
clientId: "<YOUR_CLIENT_ID>",
});
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new AgentPlatformClient(credential, subscriptionId);
JavaScript 捆绑包
若要在浏览器中使用此客户端库,首先需要使用捆绑程序。 有关如何执行此操作的详细信息,请参阅我们的 捆绑文档。
重要概念
AgentPlatformClient
AgentPlatformClient是开发者使用 Azure AgentPlatform 客户端库的主要接口。 探索该客户端对象上的方法,了解您可以访问的 Azure AgentPlatform 服务的不同特性。
Troubleshooting
Logging
启用日志记录可能有助于发现有关故障的有用信息。 若要查看 HTTP 请求和响应的日志,请将 AZURE_LOG_LEVEL 环境变量设置为 info。 或者,可以通过在 setLogLevel中调用 @azure/logger 在运行时启用日志记录:
import { setLogLevel } from "@azure/logger";
setLogLevel("info");
有关如何启用日志的更详细说明,可以查看 @azure/记录器包文档。
后续步骤
有关如何使用此库的详细示例,请查看 示例 目录。
Contributing
如果你想为本库贡献内容,请阅读 贡献指南,了解更多关于如何构建和测试代码的信息。