@microsoft/agents-a365-runtime package

Služba pro zpracování ověřování agentů uživatelů.

Výchozí zprostředkovatel, který vrací konfiguraci založenou na prostředí.

Důležité informace o více tenantech: Tento zprostředkovatel vytvoří v době výstavby jednu instanci konfigurace, která se sdílí napříč všemi požadavky v procesu. Výchozí zprostředkovatelé na úrovni modulu (např defaultRuntimeConfigurationProvider. ) jsou singletony.

V případě scénářů s více tenanty se podporují dva přístupy:

1. Funkce dynamického přepsání (doporučeno): Předejte funkce přepsání, které se čtou z asynchronního kontextu (např. OpenTelemetry zavazadlo) za běhu. Stejná instance konfigurace vrátí různé hodnoty na požadavek.

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

2. Poskytovatelé pro jednotlivé tenanty: Vytvořte pro každého tenanta samostatné instance zprostředkovatele, pokud různé tenanty potřebují zcela jiné funkce přepsání.

Zapouzdřuje chybu z operace.

Představuje výsledek operace.

Základní třída konfigurace pro sadu Agent365 SDK. Ostatní balíčky to rozšiřují a přidávají vlastní nastavení.

Funkce přepsání se volají pro každý přístup k vlastnostem a umožňují dynamické rozlišení z asynchronního kontextu (např. zavazadlo OpenTelemetry) podle požadavku.

Utility třída poskytující pomocné metody pro operace modulu runtime agenta.

Obecné rozhraní pro poskytování konfigurace Každý balíček definuje vlastní typ konfigurace T.

Možnosti konfigurace modulu runtime – všechny volitelné funkce Funkce se volají pro každý přístup k vlastnostem a umožňují dynamické rozlišení. Nenasadené hodnoty se vrátí do proměnných prostředí.

Kategorie clusterů pro zjišťování rozhraní API Power Platform Výčet řetězců poskytuje zabezpečení typu kompilace i ověřování za běhu.

Získá kategorii clusteru z proměnných prostředí.

Příklad

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

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

Získá obor ověřování platformy MCP.

Příklad

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

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

Vrátí obor pro ověřování ve službě pozorovatelnosti.

Příklad

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

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

Vrátí hodnotu true, pokud je aktuálním prostředím vývojové prostředí.

Příklad

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

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

Obor ověřování produkční platformy MCP

Výchozí kategorie clusteru pro produkční prostředí

Rozsah ověřování pozorovatelnosti v produkčním prostředí

Sdílený výchozí zprostředkovatel pro RuntimeConfiguration. Používá proměnné prostředí bez přepsání – vhodné pro nasazení s jedním tenantem nebo při použití dynamických přepsání funkcí pro více tenantů.