utility モジュール

ベース URL とサーバー名を使用して、完全な MCP サーバー URL を構築します。

build_mcp_server_url(server_name: str) -> str

パラメーター

返品

MCP プラットフォームにチャット履歴を送信するためのチャット履歴エンドポイント URL を取得します。

get_chat_history_endpoint() -> str

返品

MCP サーバーのベース URL を取得します。

get_mcp_base_url() -> str

返品

MCP プラットフォーム認証スコープを取得します。

get_mcp_platform_authentication_scope() -> list[str]

返品

指定したデジタル ワーカーのツール ゲートウェイ URL を取得します。

get_tooling_gateway_for_digital_worker(agentic_app_id: str) -> str

パラメーター

返品

現在の環境が開発として構成されている場合は True を返します。

解決順序 (最初の空でない値が優先):

1. PYTHON_ENVIRONMENT — 現在のサンプルで使用されている明示的な Python SDK 変数。
2. ENVIRONMENT — 従来の Python SDK 変数 (下位互換性)。
3. ASPNETCORE_ENVIRONMENT — Azure ホスティング規則。
4. DOTNET_ENVIRONMENT — 汎用ホスト規則。
5. 上記のいずれも設定されていない場合は、既定で "Development" されます。

PYTHON_ENVIRONMENTとENVIRONMENTが最初にチェックされるため、ホスト プロセスでASPNETCORE_ENVIRONMENTも設定されている場合、ENVIRONMENT=Productionを明示的に設定したエージェントは影響を受けないようにします。

is_development_environment() -> bool

返品

OAuth スコープを解決して、特定の MCP サーバーを要求します。

V2 サーバーは、 audience フィールド (ベア GUID または api:// URI フォーム) に独自の対象ユーザーを運びます。 明示的な scope が指定されている場合 (例: "Tools.ListInvoke.All")、スコープは {audience}/{scope}。 スコープがない場合は、 {audience}/.default が使用されます (事前に同意されたスコープに依存します)。 V1 サーバー (対象ユーザーなし、対象ユーザーはベア GUID または api:// URI フォームの共有 ATG AppId と等しい) は、常に共有 ATG /.default スコープにフォールバックします。

resolve_token_scope_for_server(server: MCPServerConfig) -> str

パラメーター

返品