Azure AgentPlatform client library for JavaScript - version 1.0.0-beta.1

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

Kore.AgentPlatform Fornecedor de Recursos para gerir organizações Kore AI Agent Platform e os seus espaços de trabalho.

As organizações são recursos ARM de topo e monitorizados. Cada organização é provisionada juntamente com um Workspace predefinido. Os Workspaces adicionais são geridos 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 utiliza credenciais federadas Microsoft Entra e é aplicada na camada de execução (não na superfície ARM).

Ligações principais:

Introdução

Ambientes atualmente suportados

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

Pré-requisitos

  • Uma assinatura do Azure.

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 aceder à API do Azure AgentPlatform, vai precisar do endpoint seu recurso Azure AgentPlatform e de um credentialarquivo . O cliente Azure AgentPlatform pode usar credenciais Microsoft Entra para autenticar. Pode encontrar o endpoint para o seu recurso Azure AgentPlatform no portal do Azure.

Pode autenticar-se com o Microsoft Entra ID usando uma credencial da biblioteca @azure/identity ou um token Microsoft Entra existente.

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

npm install @azure/identity

Também terá de registar 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 não "Owner" concedem as permissões necessárias).

Para mais informações sobre como criar uma aplicação Microsoft Entra, consulte este guia.

Usando ambientes Node.js e Node-like, você pode usar a classe DefaultAzureCredential 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 do pacote @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 cliente no navegador, primeiro você precisa usar um bundler. Para obter detalhes sobre como fazer isso, consulte nossa documentação de agregação de .

Conceitos principais

AgentPlatformClient

AgentPlatformClienté a interface principal para programadores que utilizam a biblioteca cliente Azure AgentPlatform. Explore os métodos neste objeto cliente para compreender as diferentes funcionalidades do serviço Azure AgentPlatform a que pode aceder.

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 tempo de execução 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.

Passos seguintes

Por favor, dê uma olhada no exemplos diretório para obter exemplos detalhados sobre como usar esta biblioteca.

Contributing

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

  • Última atualização a