@microsoft/agents-a365-runtime package

Serviço para gerir autenticação agente de utilizadores.

Fornecedor predefinido que devolve configuração baseada no ambiente.

Considerações para múltiplos inquilinos: Este fornecedor cria uma única instância de configuração no momento da construção, partilhada entre todos os pedidos de um processo. Os fornecedores padrão ao nível do módulo (por exemplo, defaultRuntimeConfigurationProvider) são singletons.

Para cenários multi-inquilino, são suportadas duas abordagens:

1. Funções de sobreposição dinâmica (recomendadas): Passe funções de sobreposição que leem a partir de contexto assíncrono (por exemplo, bagagem OpenTelemetry) em tempo de execução. A mesma instância de Configuração devolve valores diferentes por pedido.

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

2. Fornecedores por inquilino: Crie instâncias separadas para cada inquilino quando diferentes inquilinos precisam de funções de sobreposição completamente distintas.

Encapsula um erro de uma operação.

Representa o resultado de uma operação.

Classe base de configuração para o SDK Agent365. Outros pacotes estendem isto para adicionar as suas próprias definições.

Funções de sobreposição são chamadas em cada acesso à propriedade, permitindo resolução dinâmica a partir de contexto assíncrono (por exemplo, bagagem OpenTelemetry) por pedido.

Classe utilitária que fornece métodos auxiliares para operações em tempo de execução do agente.

Interface genérica para fornecer configuração. Cada pacote define o seu próprio tipo de configuração T.

Opções de configuração em tempo de execução - todas funções opcionais. Funções são chamadas em cada acesso à propriedade, permitindo resolução dinâmica. Valores não definidos voltam a variáveis de ambiente.

Categorias de cluster para descoberta de APIs no Power Platform. O enum de string fornece tanto segurança de tipos em tempo de compilação como validação em tempo de execução.

Obtém a categoria cluster a partir das variáveis de ambiente.

Exemplo

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

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

Recebe o âmbito de autenticação da plataforma MCP.

Exemplo

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

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

Devolve o âmbito para autenticação ao serviço de observabilidade.

Exemplo

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

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

Retornos verdadeiros se o ambiente atual for um ambiente de desenvolvimento.

Exemplo

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

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

Âmbito de autenticação da plataforma MCP de produção.

Categoria padrão de cluster para ambientes de produção.

Âmbito de autenticação de observabilidade em produção.

Fornecedor partilhado por defeito para o RuntimeConfiguration. Utiliza variáveis de ambiente sem overrides - adequado para implementações single-tenant ou quando utilizam funções de override dinâmico para multi-tenancy.