@microsoft/agents-a365-runtime package

Servicio para controlar la autenticación de usuario agente.

Proveedor predeterminado que devuelve la configuración basada en el entorno.

Consideraciones multiinquilino: Este proveedor crea una única instancia de configuración en tiempo de construcción, compartida en todas las solicitudes de un proceso. Los proveedores de nivel de módulo predeterminados (por ejemplo, defaultRuntimeConfigurationProvider) son singletons.

En escenarios multiinquilino, se admiten dos enfoques:

1. Funciones de invalidación dinámica (recomendadas): Pase las funciones de invalidación que leen del contexto asincrónico (por ejemplo, equipaje de OpenTelemetry) en tiempo de ejecución. La misma instancia de Configuración devuelve valores diferentes por solicitud.

   const config = new ToolingConfiguration({
     mcpPlatformEndpoint: () => {
       const tenantConfig = context.active().getValue(TENANT_KEY);
       return tenantConfig?.endpoint ?? 'https://default.endpoint';
     }
   });
   

2. Proveedores por inquilino: Cree instancias de proveedor independientes para cada inquilino cuando los distintos inquilinos necesiten diferentes funciones de invalidación por completo.

Encapsula un error de una operación.

Representa el resultado de una operación.

Clase de configuración base para el SDK de Agent365. Otros paquetes amplían esta opción para agregar su propia configuración.

Se llama a las funciones de invalidación en cada acceso a propiedades, lo que permite la resolución dinámica desde un contexto asincrónico (por ejemplo, equipaje de OpenTelemetry) por solicitud.

Clase de utilidad que proporciona métodos auxiliares para las operaciones en tiempo de ejecución del agente.

Interfaz genérica para proporcionar configuración. Cada paquete define su propio tipo de configuración T.

Opciones de configuración en tiempo de ejecución: todas las funciones opcionales. Se llama a funciones en cada acceso a propiedades, lo que permite la resolución dinámica. Los valores sin establecer se revierten a las variables de entorno.

Categorías de clúster para la detección de Power Platform API. La enumeración de cadena proporciona seguridad de tipos en tiempo de compilación y validación en tiempo de ejecución.

Obtiene la categoría de clúster de las variables de entorno.

Ejemplo

// Before:
import { getClusterCategory } from '@microsoft/agents-a365-runtime';
const cluster = getClusterCategory();

// After:
import { defaultRuntimeConfigurationProvider } from '@microsoft/agents-a365-runtime';
const cluster = defaultRuntimeConfigurationProvider.getConfiguration().clusterCategory;

Obtiene el ámbito de autenticación de la plataforma MCP.

Ejemplo

// Before:
import { getMcpPlatformAuthenticationScope } from '@microsoft/agents-a365-runtime';
const scope = getMcpPlatformAuthenticationScope();

// After:
import { defaultToolingConfigurationProvider } from '@microsoft/agents-a365-tooling';
const scope = defaultToolingConfigurationProvider.getConfiguration().mcpPlatformAuthenticationScope;

Devuelve el ámbito para autenticarse en el servicio de observabilidad.

Ejemplo

// Before:
import { getObservabilityAuthenticationScope } from '@microsoft/agents-a365-runtime';
const scopes = getObservabilityAuthenticationScope();

// After:
import { defaultObservabilityConfigurationProvider } from '@microsoft/agents-a365-observability';
const scopes = [...defaultObservabilityConfigurationProvider.getConfiguration().observabilityAuthenticationScopes];

Devuelve true si el entorno actual es un entorno de desarrollo.

Ejemplo

// Before:
import { isDevelopmentEnvironment } from '@microsoft/agents-a365-runtime';
if (isDevelopmentEnvironment()) { ... }

// After:
import { defaultRuntimeConfigurationProvider } from '@microsoft/agents-a365-runtime';
if (defaultRuntimeConfigurationProvider.getConfiguration().isDevelopmentEnvironment) { ... }

Ámbito de autenticación de la plataforma MCP de producción.

Categoría de clúster predeterminada para entornos de producción.

Ámbito de autenticación de observabilidad de producción.

Proveedor predeterminado compartido para RuntimeConfiguration. Usa variables de entorno sin invalidaciones: adecuadas para implementaciones de un solo inquilino o cuando se usan funciones de invalidación dinámica para multiinquilino.