@microsoft/agents-a365-runtime package

Service voor het verwerken van agentische gebruikersverificatie.

Standaardprovider die een configuratie op basis van een omgeving retourneert.

Overwegingen voor meerdere tenants: Deze provider maakt één configuratie-exemplaar tijdens de bouw, gedeeld over alle aanvragen in een proces. De standaardproviders op moduleniveau (bijvoorbeeld defaultRuntimeConfigurationProvider) zijn singletons.

Voor scenario's met meerdere tenants worden twee benaderingen ondersteund:

1. Dynamische onderdrukkingsfuncties (aanbevolen): Overschrijffuncties doorgeven die tijdens runtime worden gelezen vanuit asynchrone context (bijvoorbeeld OpenTelemetry-bagage). Hetzelfde configuratie-exemplaar retourneert verschillende waarden per aanvraag.

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

2. Providers per tenant: Maak afzonderlijke providerexemplaren voor elke tenant wanneer verschillende tenants volledig verschillende onderdrukkingsfuncties nodig hebben.

Een fout van een bewerking inkapselen.

Vertegenwoordigt het resultaat van een bewerking.

Basisconfiguratieklasse voor Agent365 SDK. Andere pakketten breiden dit uit om hun eigen instellingen toe te voegen.

Onderdrukkingsfuncties worden aangeroepen voor elke toegang tot eigenschappen, waardoor dynamische resolutie vanuit asynchrone context (bijvoorbeeld OpenTelemetry-bagage) per aanvraag wordt ingeschakeld.

Hulpprogrammaklasse die helpermethoden biedt voor agentruntimebewerkingen.

Algemene interface voor het bieden van configuratie. Elk pakket definieert een eigen configuratietype T.

Runtime-configuratieopties: alle optionele functies. Functies worden aangeroepen voor elke toegang tot eigenschappen, waardoor dynamische resolutie mogelijk is. Niet-instelwaarden vallen terug op omgevingsvariabelen.

Clustercategorieën voor Power Platform API-detectie. String enum biedt zowel de veiligheid van het type compileertijd als runtimevalidatie.

Haalt de clustercategorie op uit omgevingsvariabelen.

Voorbeeld

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

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

Hiermee haalt u het verificatiebereik van het MCP-platform op.

Voorbeeld

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

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

Retourneert het bereik voor verificatie bij de waarneembaarheidsservice.

Voorbeeld

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

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

Retourneert waar als de huidige omgeving een ontwikkelomgeving is.

Voorbeeld

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

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

Bereik voor mcp-platformverificatie voor productie.

Standaardclustercategorie voor productieomgevingen.

Verificatiebereik productieobserveerbaarheid.

Gedeelde standaardprovider voor RuntimeConfiguration. Maakt gebruik van omgevingsvariabelen zonder onderdrukkingen- geschikt voor implementaties met één tenant of bij het gebruik van dynamische onderdrukkingsfuncties voor multitenancy.