Azure AgentPlatform client library for JavaScript - versão 1.0.0-beta.1

Este pacote contém um SDK isomorfo (roda tanto em Node.js quanto em navegadores) para Azure cliente AgentPlatform.

Kore.AgentPlatform Provedor de Recursos para gerenciar organizações da Plataforma de Agentes de IA Kore e seus espaços de trabalho.

As organizações são recursos ARM de alto nível rastreados. Cada organização é provisionada junto com um Workspace padrão. Workspaces adicionais são gerenciados como um tipo de recurso proxy filho na Organização usando os verbos ARM PADRÃO (PUT / DELETE / GET / LIST) na URL do workspace.

A autenticação serviço-a-serviço entre Liftr e Kore usa credenciais federadas Microsoft Entra e é aplicada na camada de runtime (não na superfície ARM).

Links principais:

Introdução

Ambientes com suporte no momento

Consulte nossa política de suporte para obter mais detalhes.

Prerequisites

Instalar o pacote @azure/arm-koreaiartemis

Instale a biblioteca cliente Azure AgentPlatform para JavaScript comnpm:

npm install @azure/arm-koreaiartemis

Criar e autenticar um AgentPlatformClient

Para criar um objeto cliente para acessar a API do Azure AgentPlatform, você precisará do endpoint seu recurso do Azure AgentPlatform e de um credentialarquivo . O cliente Azure AgentPlatform pode usar credenciais Microsoft Entra para autenticação. Você pode encontrar o endpoint para seu recurso Azure AgentPlatform no portal do Azure.

Você pode autenticar com o Microsoft Entra ID usando uma credencial da biblioteca @azure/identity ou um token Microsoft Entra existente.

Para usar o provedor DefaultAzureCredential mostrado abaixo ou outros provedores de credenciais fornecidos com o SDK do Azure, instale o pacote @azure/identity:

npm install @azure/identity

Você também precisará registrar uma nova aplicação Microsoft Entra e conceder acesso ao Azure AgentPlatform atribuindo o papel adequado ao seu principal de serviço (nota: funções como "Owner" não concedem as permissões necessárias).

Para mais informações sobre como criar um aplicativo Microsoft Entra, confira este guia.

Usando ambientes semelhantes a Node.js e Node, você pode usar a DefaultAzureCredential classe para autenticar o cliente.

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);

Para ambientes de navegador, use o InteractiveBrowserCredential pacote from @azure/identity para autenticar.

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);

Pacote JavaScript

Para usar essa biblioteca de clientes no navegador, primeiro você precisa usar um empacotador. Para obter detalhes sobre como fazer isso, consulte nossa documentação de agrupamento .

Conceitos principais

AgentPlatformClient

AgentPlatformClienté a interface principal para desenvolvedores que utilizam a biblioteca cliente Azure AgentPlatform. Explore os métodos neste objeto cliente para entender os diferentes recursos do serviço Azure AgentPlatform que você pode acessar.

Troubleshooting

Logging

Habilitar o registro em log pode ajudar a descobrir informações úteis sobre falhas. Para ver um log de solicitações e respostas HTTP, defina a variável de ambiente AZURE_LOG_LEVEL como info. Como alternativa, o registro em log pode ser habilitado em runtime chamando setLogLevel no @azure/logger:

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

Para obter instruções mais detalhadas sobre como habilitar logs, você pode consultar os documentos do pacote @azure/logger.

Próximas Etapas 

Examine os exemplos de diretório para obter exemplos detalhados sobre como usar essa biblioteca.

Contributing

Se você quiser contribuir para esta biblioteca, por favor leia o guia contribuição para saber mais sobre como construir e testar o código.

  • do SDK do Microsoft Azure para JavaScript
  • Última atualização em