@microsoft/agents-a365-runtime package

Tjeneste til håndtering af agentisk brugergodkendelse.

Standardprovider, der returnerer miljøbaseret konfiguration.

Overvejelser i forbindelse med flere lejere: Denne provider opretter en enkelt konfigurationsforekomst på byggetidspunktet, der deles på tværs af alle anmodninger i en proces. Standardudbydere på modulniveau (f.eks. defaultRuntimeConfigurationProvider) er singletoner.

I scenarier med flere lejere understøttes to fremgangsmåder:

1. Dynamiske tilsidesættelsesfunktioner (anbefales): Overfør tilsidesættelsesfunktioner, der læses fra asynkron kontekst (f.eks. OpenTelemetry-bagage) på kørselstidspunktet. Den samme konfigurationsforekomst returnerer forskellige værdier pr. anmodning.

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

2. Udbydere pr. lejer: Opret separate providerforekomster for hver lejer, når forskellige lejere har brug for helt forskellige tilsidesættelsesfunktioner.

Encapsulates en fejl fra en handling.

Repræsenterer resultatet af en handling.

Grundlæggende konfigurationsklasse for Agent365 SDK. Andre pakker udvider dette for at tilføje deres egne indstillinger.

Tilsidesættelsesfunktioner kaldes for hver egenskabsadgang, hvilket aktiverer dynamisk opløsning fra asynkron kontekst (f.eks. OpenTelemetry-bagage) pr. anmodning.

Utility class, der leverer hjælpemetoder til agent runtime-handlinger.

Generisk grænseflade til angivelse af konfiguration. Hver pakke definerer sin egen konfigurationstype T.

Konfigurationsindstillinger for kørsel – alle valgfri funktioner. Funktioner kaldes for hver egenskabsadgang og aktiverer dynamisk opløsning. Unset-værdier falder tilbage til miljøvariabler.

Klyngekategorier til Registrering af Power Platform-API. Strengoptællingen giver både sikkerhed af kompileringstidstype og validering af kørsel.

Henter klyngekategorien fra miljøvariabler.

Eksempel

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

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

Henter omfanget af MCP-platformens godkendelse.

Eksempel

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

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

Returnerer området for godkendelse til tjenesten observability.

Eksempel

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

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

Returnerer sand, hvis det aktuelle miljø er et udviklingsmiljø.

Eksempel

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

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

Produktions-MCP-platformgodkendelsesområde.

Standardklyngekategori for produktionsmiljøer.

Godkendelsesområde for godkendelse af produktions observabilitet.

Delt standardprovider for RuntimeConfiguration. Bruger miljøvariabler uden tilsidesættelser – egnet til udrulninger med en enkelt lejer, eller når der bruges dynamiske tilsidesættelsesfunktioner til flere lejere.