@microsoft/agents-a365-runtime package

Klasser

AgenticAuthenticationService

Tjeneste for behandling av agentisk brukergodkjenning.

DefaultConfigurationProvider

Standardleverandør som returnerer miljøbasert konfigurasjon.

Vurderinger for flere leiere: Denne leverandøren oppretter én enkelt konfigurasjonsforekomst på byggetidspunktet, delt på tvers av alle forespørsler i en prosess. Standardleverandører på modulnivå (for eksempel defaultRuntimeConfigurationProvider) er singletoner.

To fremgangsmåter støttes for scenarioer med flere leiere:

  1. Dynamiske overstyringsfunksjoner (anbefales): Send overstyringsfunksjoner som leses fra asynkron kontekst (f.eks. OpenTelemetry-bagasje) ved kjøretid. Den samme konfigurasjonsforekomsten returnerer forskjellige verdier per forespørsel.

    const config = new ToolingConfiguration({
      mcpPlatformEndpoint: () => {
        const tenantConfig = context.active().getValue(TENANT_KEY);
        return tenantConfig?.endpoint ?? 'https://default.endpoint';
      }
    });
    
  2. Leverandører per leier: Opprett separate leverandørforekomster for hver leier når forskjellige leiere trenger forskjellige overstyringsfunksjoner helt.

OperationError

Kapsler inn en feil fra en operasjon.

OperationResult

Representerer resultatet av en operasjon.

PowerPlatformApiDiscovery
RuntimeConfiguration

Basiskonfigurasjonsklasse for Agent365 SDK. Andre pakker utvider dette for å legge til sine egne innstillinger.

Overstyringsfunksjoner kalles for hver egenskapstilgang, slik at dynamisk oppløsning aktiveres fra asynkron kontekst (f.eks. OpenTelemetry-bagasje) per forespørsel.

Utility

Utility-klassen tilbyr hjelpemetoder for operasjoner for agentkjøring.

Grensesnitt

IConfigurationProvider

Generisk grensesnitt for konfigurasjon. Hver pakke definerer sin egen konfigurasjonstype T.

Typealiaser

RuntimeConfigurationOptions

Konfigurasjonsalternativer for kjøretid – alle valgfrie funksjoner. Funksjoner kalles på hver egenskapstilgang, slik at dynamisk oppløsning aktiveres. Usette verdier faller tilbake til miljøvariabler.

Nummereringer

ClusterCategory

Klyngekategorier for Power Platform API-søk. Strengopplisting gir både sikkerhet for kompileringstidstype og kjøretidsvalidering.

Funksjoner

getClusterCategory(IConfigurationProvider<RuntimeConfiguration>)

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;
getMcpPlatformAuthenticationScope()

Henter godkjenningsomfanget for MCP-plattformen.

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;
getObservabilityAuthenticationScope()

Returnerer omfanget for godkjenning til tjenesten for observerbarhet.

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];
isDevelopmentEnvironment(IConfigurationProvider<RuntimeConfiguration>)

Returnerer sann hvis gjeldende miljø er et utviklingsmiljø.

Eksempel

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

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

Variabler

DEVELOPMENT_ENVIRONMENT_NAME
PRODUCTION_ENVIRONMENT_NAME
PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE

Godkjenningsomfang for produksjons-MCP-plattform.

PROD_OBSERVABILITY_CLUSTER_CATEGORY

Standard klyngekategori for produksjonsmiljøer.

PROD_OBSERVABILITY_SCOPE

Godkjenningsområde for godkjenning av produksjonsobservasjon.

defaultRuntimeConfigurationProvider

Delt standardleverandør for RuntimeConfiguration. Bruker miljøvariabler uten overstyringer – egnet for enkeltleierdistribusjoner eller ved bruk av dynamiske overstyringsfunksjoner for multileieforhold.

Funksjonsdetaljer

getClusterCategory(IConfigurationProvider<RuntimeConfiguration>)

Advarsel

Denne API-en er nå avskrevet.

Use RuntimeConfiguration.clusterCategory instead.

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;
function getClusterCategory(configProvider?: IConfigurationProvider<RuntimeConfiguration>): string

Parametere

configProvider

IConfigurationProvider<RuntimeConfiguration>

Valgfri konfigurasjonsleverandør. Standardinnstillingene for defaultRuntimeConfigurationProvider hvis det ikke er angitt.

Returnerer

string

Klyngekategorien fra CLUSTER_CATEGORY env varierer som standard til prod.

getMcpPlatformAuthenticationScope()

Advarsel

Denne API-en er nå avskrevet.

Use ToolingConfiguration.mcpPlatformAuthenticationScope instead.

Henter godkjenningsomfanget for MCP-plattformen.

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;
function getMcpPlatformAuthenticationScope(): string

Returnerer

string

Godkjenningsomfanget for MCP-plattformen.

getObservabilityAuthenticationScope()

Advarsel

Denne API-en er nå avskrevet.

Use ObservabilityConfiguration.observabilityAuthenticationScopes instead.

Returnerer omfanget for godkjenning til tjenesten for observerbarhet.

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];
function getObservabilityAuthenticationScope(): string[]

Returnerer

string[]

Godkjenningsomfangene for gjeldende miljø.

isDevelopmentEnvironment(IConfigurationProvider<RuntimeConfiguration>)

Advarsel

Denne API-en er nå avskrevet.

Use RuntimeConfiguration.isDevelopmentEnvironment instead.

Returnerer sann hvis gjeldende miljø er et utviklingsmiljø.

Eksempel

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

// After:
import { defaultRuntimeConfigurationProvider } from '@microsoft/agents-a365-runtime';
if (defaultRuntimeConfigurationProvider.getConfiguration().isDevelopmentEnvironment) { ... }
function isDevelopmentEnvironment(configProvider?: IConfigurationProvider<RuntimeConfiguration>): boolean

Parametere

configProvider

IConfigurationProvider<RuntimeConfiguration>

Valgfri konfigurasjonsleverandør. Standardinnstillingene for defaultRuntimeConfigurationProvider hvis det ikke er angitt.

Returnerer

boolean

Sann hvis det gjeldende miljøet er utvikling, ellers usann.

Variable detaljer

DEVELOPMENT_ENVIRONMENT_NAME

DEVELOPMENT_ENVIRONMENT_NAME: "Development"

Type

"Development"

PRODUCTION_ENVIRONMENT_NAME

PRODUCTION_ENVIRONMENT_NAME: "production"

Type

"production"

PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE

Advarsel

Denne API-en er nå avskrevet.

This constant is exported for backward compatibility only. For new code, use ToolingConfiguration.mcpPlatformAuthenticationScope instead.

Godkjenningsomfang for produksjons-MCP-plattform.

PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE: "ea9ffc3e-8a23-4a7d-836d-234d7c7565c1/.default"

Type

string

PROD_OBSERVABILITY_CLUSTER_CATEGORY

Advarsel

Denne API-en er nå avskrevet.

This constant is exported for backward compatibility only. For new code, use RuntimeConfiguration.clusterCategory instead.

Standard klyngekategori for produksjonsmiljøer.

PROD_OBSERVABILITY_CLUSTER_CATEGORY: "prod"

Type

"prod"

PROD_OBSERVABILITY_SCOPE

Advarsel

Denne API-en er nå avskrevet.

This constant is exported for backward compatibility only. For new code, use ObservabilityConfiguration.observabilityAuthenticationScopes instead.

Godkjenningsområde for godkjenning av produksjonsobservasjon.

PROD_OBSERVABILITY_SCOPE: "api://9b975845-388f-4429-889e-eab1ef63949c/.default"

Type

string

defaultRuntimeConfigurationProvider

Delt standardleverandør for RuntimeConfiguration. Bruker miljøvariabler uten overstyringer – egnet for enkeltleierdistribusjoner eller ved bruk av dynamiske overstyringsfunksjoner for multileieforhold.

defaultRuntimeConfigurationProvider: DefaultConfigurationProvider<RuntimeConfiguration>

Type