@microsoft/agents-a365-runtime package

エージェント ユーザー認証を処理するためのサービス。

環境ベースの構成を返す既定のプロバイダー。

マルチテナントに関する考慮事項: このプロバイダーは、構築時に 1 つの構成インスタンスを作成し、プロセス内のすべての要求で共有します。 既定のモジュール レベルのプロバイダー (例: defaultRuntimeConfigurationProvider) はシングルトンです。

マルチテナント シナリオでは、次の 2 つの方法がサポートされています。

1. 動的オーバーライド関数 (推奨): 実行時に非同期コンテキスト (OpenTelemetry 手荷物など) から読み取るオーバーライド関数を渡します。 同じ構成インスタンスは、要求ごとに異なる値を返します。

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

2. テナントごとのプロバイダー: 異なるテナントで異なるオーバーライド関数が完全に必要な場合は、テナントごとに個別のプロバイダー インスタンスを作成します。

操作からのエラーをカプセル化します。

操作の結果を表します。

Agent365 SDK の基本構成クラス。 他のパッケージでは、独自の設定を追加するためにこれを拡張します。

オーバーライド関数は、各プロパティ アクセスで呼び出され、要求ごとの非同期コンテキスト (OpenTelemetry 手荷物など) からの動的解決が可能になります。

エージェントのランタイム操作用のヘルパー メソッドを提供するユーティリティ クラス。

構成を提供するための汎用インターフェイス。 各パッケージは、独自の構成の種類 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];

現在の環境が開発環境の場合は true を返します。

例

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

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

運用 MCP プラットフォームの認証スコープ。

運用環境の既定のクラスター カテゴリ。

運用環境の監視の認証スコープ。

RuntimeConfiguration の共有の既定のプロバイダー。 オーバーライドのない環境変数を使用します。シングルテナントデプロイに適しているか、マルチテナントの動的オーバーライド関数を使用する場合に適しています。