@microsoft/agents-a365-runtime package

Dienst für die Verarbeitung der agentischen Benutzerauthentifizierung.

Standardanbieter, der umgebungsbasierte Konfiguration zurückgibt.

Überlegungen zu mehreren Mandanten: Dieser Anbieter erstellt zur Erstellungszeit eine einzelne Konfigurationsinstanz, die für alle Anforderungen in einem Prozess freigegeben wird. Die Standardanbieter auf Modulebene (z. B. defaultRuntimeConfigurationProvider) sind Singletons.

Für Szenarien mit mehreren Mandanten werden zwei Ansätze unterstützt:

1. Dynamische Außerkraftsetzungsfunktionen (empfohlen): Übergeben Sie Überschreibungsfunktionen, die aus asynchronem Kontext (z. B. OpenTelemetry-Gepäck) zur Laufzeit gelesen werden. Die gleiche Konfigurationsinstanz gibt unterschiedliche Werte pro Anforderung zurück.

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

2. Mandantenspezifische Anbieter: Erstellen Sie separate Anbieterinstanzen für jeden Mandanten, wenn unterschiedliche Mandanten unterschiedliche Außerkraftsetzungsfunktionen vollständig benötigen.

Kapselt einen Fehler aus einem Vorgang.

Stellt das Ergebnis eines Vorgangs dar.

Basiskonfigurationsklasse für Agent365 SDK. Andere Pakete erweitern dies, um eigene Einstellungen hinzuzufügen.

Außerkraftsetzungsfunktionen werden für jeden Eigenschaftszugriff aufgerufen und ermöglichen die dynamische Auflösung aus asynchronem Kontext (z. B. OpenTelemetry-Gepäck) pro Anforderung.

Hilfsklasse, die Hilfsmethoden für Agent-Laufzeitvorgänge bereitstellt.

Generische Schnittstelle für die Konfiguration. Jedes Paket definiert seinen eigenen Konfigurationstyp T.

Laufzeitkonfigurationsoptionen – alle optionalen Funktionen. Funktionen werden für jeden Eigenschaftszugriff aufgerufen und ermöglichen die dynamische Auflösung. Nicht festgelegte Werte fallen auf Umgebungsvariablen zurück.

Clusterkategorien für die Power Platform-API-Ermittlung. Die Zeichenfolgenumierung stellt sowohl die Sicherheit des Kompilierungszeittyps als auch die Laufzeitüberprüfung bereit.

Ruft die Clusterkategorie aus Umgebungsvariablen ab.

Beispiel

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

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

Ruft den Authentifizierungsbereich der MCP-Plattform ab.

Beispiel

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

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

Gibt den Authentifizierungsbereich für den Observability-Dienst zurück.

Beispiel

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

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

Gibt true zurück, wenn es sich bei der aktuellen Umgebung um eine Entwicklungsumgebung handelt.

Beispiel

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

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

Produktions-MCP-Plattformauthentifizierungsbereich.

Standardclusterkategorie für Produktionsumgebungen.

Produktions-Observability-Authentifizierungsbereich.

Freigegebener Standardanbieter für RuntimeConfiguration. Verwendet Umgebungsvariablen ohne Außerkraftsetzungen – geeignet für Einzelmandantenbereitstellungen oder bei Verwendung dynamischer Außerkraftsetzungsfunktionen für mehrinstanzenfähig.