@microsoft/agents-a365-runtime package

Tjänst för hantering av agentisk användarautentisering.

Standardprovider som returnerar miljöbaserad konfiguration.

Överväganden för flera klientorganisationer: Den här providern skapar en enda konfigurationsinstans vid byggtiden, som delas mellan alla begäranden i en process. Standardprovidrar på modulnivå (t.ex. defaultRuntimeConfigurationProvider) är singletons.

För scenarier med flera klientorganisationer stöds två metoder:

1. Funktioner för dynamisk åsidosättning (rekommenderas): Skicka åsidosättningsfunktioner som läser från asynkron kontext (t.ex. OpenTelemetry-bagage) vid körning. Samma konfigurationsinstans returnerar olika värden per begäran.

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

2. Leverantörer per klientorganisation: Skapa separata providerinstanser för varje klientorganisation när olika klienter behöver olika åsidosättningsfunktioner helt och hållet.

Kapslar in ett fel från en åtgärd.

Representerar resultatet av en åtgärd.

Baskonfigurationsklass för Agent365 SDK. Andra paket utökar detta för att lägga till egna inställningar.

Åsidosättningsfunktioner anropas för varje egenskapsåtkomst, vilket möjliggör dynamisk upplösning från asynkron kontext (t.ex. OpenTelemetry-bagage) per begäran.

Verktygsklass som tillhandahåller hjälpmetoder för agentkörningsåtgärder.

Allmänt gränssnitt för att tillhandahålla konfiguration. Varje paket definierar sin egen konfigurationstyp T.

Körningskonfigurationsalternativ – alla valfria funktioner. Funktioner anropas för varje egenskapsåtkomst, vilket möjliggör dynamisk upplösning. Ta bort värden återgår till miljövariabler.

Klusterkategorier för identifiering av Power Platform API. Stränguppräkning ger både säkerhet av kompileringstyp och körningsverifiering.

Hämtar klusterkategorin från miljövariabler.

Example

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

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

Hämtar autentiseringsomfånget för MCP-plattformen.

Example

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

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

Returnerar omfånget för autentisering till observerbarhetstjänsten.

Example

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

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

Returnerar sant om den aktuella miljön är en utvecklingsmiljö.

Example

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

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

Omfång för MCP-plattformsautentisering för produktion.

Standardklusterkategori för produktionsmiljöer.

Omfång för produktionsobservabilitetsautentisering.

Delad standardprovider för RuntimeConfiguration. Använder miljövariabler utan åsidosättningar – lämpliga för distributioner med en klientorganisation eller när du använder dynamiska åsidosättningsfunktioner för flera klientorganisationer.