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

Questo pacchetto contiene un SDK isomorfo (che funziona sia in Node.js che nei browser) per Azure client AgentPlatform.

Kore.AgentPlatform Fornitore di risorse per la gestione delle organizzazioni Kore AI Agent Platform e dei loro spazi di lavoro.

Le organizzazioni sono risorse ARM di alto livello con tracciamento. Ogni organizzazione è fornita insieme a uno Workspace predefinito. Gli Workspace aggiuntivi sono gestiti come tipo di risorsa proxy figlio sotto l'Organizzazione utilizzando i verbi standard ARM (PUT / DELETE / GET / LIST) sull'URL dello workspace.

L'autenticazione service-to-service tra Liftr e Kore utilizza credenziali Microsoft Entra federate ed è applicata al livello runtime (non sulla superficie ARM).

Collegamenti chiave:

Come iniziare

Ambienti attualmente supportati

Per altri dettagli, vedere i criteri di supporto .

Prerequisites

Installare il pacchetto @azure/arm-koreaiartemis

Installa la libreria client Azure AgentPlatform per JavaScript con npm:

npm install @azure/arm-koreaiartemis

Creare ed autenticare un AgentPlatformClient

Per creare un oggetto client per accedere all'API Azure AgentPlatform, avrai bisogno della endpoint tua risorsa Azure AgentPlatform e di un credentialfile . Il client Azure AgentPlatform può utilizzare le credenziali Microsoft Entra per autenticarsi. Puoi trovare l'endpoint per la tua risorsa Azure AgentPlatform nell'portale di Azure.

Puoi autenticarti con Microsoft Entra ID usando una credenziale dalla libreria @azure/identity o da un token Microsoft Entra esistente.

Per usare il provider DefaultAzureCredential illustrato di seguito o altri provider di credenziali forniti con Azure SDK, installare il pacchetto :

npm install @azure/identity

Dovrai inoltre registrare una nuova applicazione Microsoft Entra e concedere l'accesso a Azure AgentPlatform assegnando il ruolo appropriato al tuo responsabile di servizio (nota: ruoli come "Owner" non concederanno i permessi necessari).

Per maggiori informazioni su come creare un'applicazione Microsoft Entra, consulta questa guida.

Usando Node.js e ambienti simili a Node, è possibile usare la classe DefaultAzureCredential per autenticare il client.

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

Per gli ambienti del browser, usare il InteractiveBrowserCredential dal pacchetto di @azure/identity per l'autenticazione.

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

Pacchetto JavaScript

Per usare questa libreria client nel browser, è prima necessario usare un bundler. Per informazioni dettagliate su come eseguire questa operazione, vedere la documentazione di creazione di bundle .

Concetti chiave

AgentPlatformClient

AgentPlatformClientè l'interfaccia principale per gli sviluppatori che utilizzano la libreria client Azure AgentPlatform. Esplora i metodi su questo oggetto client per comprendere le diverse funzionalità del servizio Azure AgentPlatform a cui puoi accedere.

Troubleshooting

Logging

L'abilitazione della registrazione può aiutare a individuare informazioni utili sugli errori. Per visualizzare un log di richieste e risposte HTTP, impostare la variabile di ambiente AZURE_LOG_LEVEL su info. In alternativa, la registrazione può essere abilitata in fase di esecuzione chiamando setLogLevel nel @azure/logger:

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

setLogLevel("info");

Per istruzioni più dettagliate su come abilitare i log, è possibile esaminare la documentazione del pacchetto @azure/logger.

Passaggi successivi

Per esempi dettagliati su come usare questa libreria, vedere gli esempi di directory.

Contributing

Se desideri contribuire a questa libreria, leggi la guida contributi per saperne di più su come costruire e testare il codice.

  • Ultimo aggiornamento: