@microsoft/agents-a365-runtime package

處理代理使用者身份驗證的服務。

預設供應商會回傳基於環境的設定。

多租戶的考量： 此提供者在建構時建立單一配置實例，並在程序中所有請求間共享。 預設的模組層級提供者（例如 defaultRuntimeConfigurationProvider）是單例。

對於多租戶情境，支援兩種方法：

1. 動態覆寫功能（建議）： 在執行時，傳遞從非同步上下文讀取（例如 OpenTelemetry baggage）的覆寫函式。 同一個配置實例每次請求都會回傳不同的值。

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

2. 按租戶提供的供應商： 當不同租戶需要完全不同的覆寫功能時，為每個租戶建立獨立的提供者實例。

封裝操作中的錯誤。

代表操作的結果。

Agent365 SDK 的基礎設定類別。 其他套件則擴充此功能，加入自己的設定。

每次屬性存取都會呼叫覆蓋函式，使每個請求都能從非同步上下文（例如 OpenTelemetry baggage）動態解析。

Utility 類別提供代理執行時操作的輔助方法。

提供通用介面以提供設定。 每個套件定義其專屬的配置類型 T。

執行時設定選項——所有可選功能。 每次屬性存取都會呼叫函式，實現動態解析。 未設定的值會回退到環境變數。

Power Platform API 發現的群組分類。 字串列舉同時提供編譯時型別安全與執行時驗證。

從環境變數取得叢集類別。

範例

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

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

取得 MCP 平台的認證範圍。

範例

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

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

將驗證範圍回傳給可觀察性服務。

範例

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

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

若當前環境是開發環境，則回傳為真。

範例

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

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

生產 MCP 平台認證範圍。

生產環境的預設叢集類別。

生產可觀察性認證範圍。

RuntimeConfiguration 的共用預設提供者。 使用環境變數且無覆寫——適合單租戶部署或多租戶動態覆寫函式。