@microsoft/agents-a365-runtime package

Service de gestion de l’authentification utilisateur agentique.

Fournisseur par défaut qui retourne la configuration basée sur l’environnement.

Considérations multilocataires : Ce fournisseur crée une instance de configuration unique au moment de la construction, partagée entre toutes les requêtes d’un processus. Les fournisseurs au niveau du module par défaut (par exemple, defaultRuntimeConfigurationProvider) sont des singletons.

Pour les scénarios multilocataires, deux approches sont prises en charge :

1. Fonctions de remplacement dynamique (recommandées) : Passez les fonctions de remplacement qui lisent à partir du contexte asynchrone (par exemple, les bagages OpenTelemetry) au moment de l’exécution. La même instance de configuration retourne des valeurs différentes par requête.

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

2. Fournisseurs par locataire : Créez des instances de fournisseur distinctes pour chaque locataire lorsque différents locataires ont besoin de différentes fonctions de remplacement entièrement.

Encapsule une erreur à partir d’une opération.

Représente le résultat d’une opération.

Classe de configuration de base pour le Kit de développement logiciel (SDK) Agent365. D’autres packages étendent cette option pour ajouter leurs propres paramètres.

Les fonctions de remplacement sont appelées sur chaque accès aux propriétés, ce qui active la résolution dynamique à partir du contexte asynchrone (par exemple, les bagages OpenTelemetry) par requête.

Classe utilitaire fournissant des méthodes d’assistance pour les opérations d’exécution de l’agent.

Interface générique pour fournir la configuration. Chaque package définit son propre type de configuration T.

Options de configuration du runtime : toutes les fonctions facultatives. Les fonctions sont appelées sur chaque accès aux propriétés, ce qui active la résolution dynamique. Les valeurs non définies sont renvoyées aux variables d’environnement.

Catégories de cluster pour la découverte d’API Power Platform. L’énumération de chaînes fournit à la fois la sécurité du type au moment de la compilation et la validation du runtime.

Obtient la catégorie de cluster à partir des variables d’environnement.

Exemple

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

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

Obtient l’étendue d’authentification de la plateforme MCP.

Exemple

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

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

Retourne l’étendue de l’authentification auprès du service d’observabilité.

Exemple

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

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

Retourne true si l’environnement actuel est un environnement de développement.

Exemple

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

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

Étendue d’authentification de la plateforme MCP de production.

Catégorie de cluster par défaut pour les environnements de production.

Étendue d’authentification de l’observabilité de la production.

Fournisseur par défaut partagé pour RuntimeConfiguration. Utilise des variables d’environnement sans remplacements , adaptées aux déploiements à locataire unique ou lors de l’utilisation de fonctions de remplacement dynamique pour l’architecture mutualisée.