Azure AgentPlatform client library for JavaScript - versión 1.0.0-beta.1

Este paquete contiene un SDK isomorfo (que se ejecuta tanto en Node.js como en navegadores) para Azure cliente AgentPlatform.

Kore.AgentPlatform Proveedor de recursos para gestionar organizaciones de la plataforma Kore AI Agent y sus espacios de trabajo.

Las organizaciones son recursos ARM de alto nivel con seguimiento. Cada organización se proporciona junto con un Workspace predeterminado. Los Espacios de Trabajo adicionales se gestionan como un tipo de recurso proxy hijo bajo la Organización usando los verbos estándar ARM (PUT / DELETE / GET / LIST) en la URL del espacio de trabajo.

La autenticación de servicio a servicio entre Liftr y Kore utiliza credenciales federadas de Microsoft Entra y se aplica en la capa de ejecución (no en la superficie ARM).

Vínculos clave:

Cómo empezar

Entornos admitidos actualmente

Consulte nuestra de directiva de soporte técnico de para obtener más información.

Prerequisites

Instalación del paquete @azure/arm-koreaiartemis

Instala la biblioteca cliente de Azure AgentPlatform para JavaScript con npm:

npm install @azure/arm-koreaiartemis

Creación y autenticación de un AgentPlatformClient

Para crear un objeto cliente que pueda acceder a la API de Azure AgentPlatform, necesitarás el endpoint recurso de tu recurso de Azure AgentPlatform y un credentialarchivo . El cliente de Azure AgentPlatform puede utilizar credenciales de Microsoft Entra para autenticarse. Puedes encontrar el endpoint para tu recurso de Azure AgentPlatform en el Azure Portal.

Puedes autenticarte con Microsoft Entra ID usando una credencial de la biblioteca @azure/identity o un token Microsoft Entra existente.

Para usar el proveedor de de DefaultAzureCredential que se muestra a continuación u otros proveedores de credenciales proporcionados con el SDK de Azure, instale el paquete de :

npm install @azure/identity

También tendrás que registrar una nueva aplicación Microsoft Entra y conceder acceso a Azure AgentPlatform asignando el rol adecuado a tu principal de servicio (nota: roles como no "Owner" conceden los permisos necesarios).

Para más información sobre cómo crear una aplicación Microsoft Entra, consulta esta guía.

Con Node.js y entornos similares a nodos, puede usar la clase DefaultAzureCredential para autenticar al 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);

En el caso de los entornos del explorador, use el InteractiveBrowserCredential del paquete de @azure/identity para autenticarse.

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

Paquete de JavaScript

Para usar esta biblioteca cliente en el explorador, primero debe usar un agrupador. Para obtener más información sobre cómo hacerlo, consulte nuestra documentación de agrupación de .

Conceptos clave

AgentPlatformClient

AgentPlatformClientes la interfaz principal para desarrolladores que utilizan la biblioteca cliente Azure AgentPlatform. Explora los métodos en este objeto cliente para entender las diferentes características del servicio Azure AgentPlatform a las que puedes acceder.

Troubleshooting

Logging

Habilitar el registro puede ayudar a descubrir información útil sobre errores. Para ver un registro de solicitudes y respuestas HTTP, establezca la variable de entorno AZURE_LOG_LEVEL en info. Como alternativa, el registro se puede habilitar en tiempo de ejecución llamando a setLogLevel en el @azure/logger:

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

setLogLevel("info");

Para obtener instrucciones más detalladas sobre cómo habilitar los registros, puede consultar los documentos del paquete de @azure/registrador.

Pasos siguientes

Eche un vistazo al directorio de ejemplos para obtener ejemplos detallados sobre cómo usar esta biblioteca.

Contributing

Si quieres contribuir a esta biblioteca, por favor lee la guía contribución para aprender más sobre cómo construir y probar el código.

  • Se actualizó por última vez el