Utility class
プロパティ
| HEADER_AGENT_ID | ログ/分析のために MCP プラットフォームにエージェント識別子を送信するためのヘッダー名。 |
| HEADER_CHANNEL_ID | |
| HEADER_SUBCHANNEL_ID | |
| HEADER_USER_AGENT |
メソッド
| Build |
特定の MCP サーバーにアクセスするための完全な URL を構築します。 例: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/" |
| Get |
リアルタイムの脅威保護のために、MCP プラットフォームにチャット履歴を送信するためのエンドポイント URL を構築します。 |
| Get |
MCP 環境のクエリに使用するベース URL を取得します。 |
| Get |
特定のエージェント ID のツール ゲートウェイ URL を構築します。 このエンドポイントは、指定されたエージェント ID に関連付けられている MCP サーバーを検出するために使用されます。 例: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/{agenticAppId}/mcpServers" |
| Get |
MCP ツール要求の標準ヘッダーを作成します。 指定された場合は承認ベアラー トークンが含まれます。必要に応じて、ルーティング用のチャネル識別子とサブチャネル識別子が含まれます。 |
| Validate |
JWT 認証トークンを検証します。 トークンが有効な JWT であり、有効期限が切れていないことを確認します。 |
プロパティの詳細
HEADER_AGENT_ID
ログ/分析のために MCP プラットフォームにエージェント識別子を送信するためのヘッダー名。
static HEADER_AGENT_ID: "x-ms-agentid" = "x-ms-agentid"プロパティ値
"x-ms-agentid"
HEADER_CHANNEL_ID
static HEADER_CHANNEL_ID: "x-ms-channel-id" = "x-ms-channel-id"プロパティ値
"x-ms-channel-id"
HEADER_SUBCHANNEL_ID
static HEADER_SUBCHANNEL_ID: "x-ms-subchannel-id" = "x-ms-subchannel-id"プロパティ値
"x-ms-subchannel-id"
HEADER_USER_AGENT
static HEADER_USER_AGENT: "User-Agent" = "User-Agent"プロパティ値
"User-Agent"
メソッドの詳細
BuildMcpServerUrl(string, IConfigurationProvider<ToolingConfiguration>)
警告
この API は非推奨になりました。
This method is for internal use only. Use McpToolServerConfigurationService instead.
特定の MCP サーバーにアクセスするための完全な URL を構築します。
例: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/"
static function BuildMcpServerUrl(serverName: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): stringパラメーター
- serverName
-
string
MCP サーバー リソース名。
- configProvider
オプションの構成プロバイダー。 既定値は defaultToolingConfigurationProvider です。
返品
string
末尾のスラッシュを含む完全修飾 MCP サーバー URL。
GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)
警告
この API は非推奨になりました。
This method is for internal use only. Use McpToolServerConfigurationService.sendChatHistory() instead.
リアルタイムの脅威保護のために、MCP プラットフォームにチャット履歴を送信するためのエンドポイント URL を構築します。
static function GetChatHistoryEndpoint(configProvider?: IConfigurationProvider<ToolingConfiguration>): stringパラメーター
- configProvider
オプションの構成プロバイダー。 既定値は defaultToolingConfigurationProvider です。
返品
string
ツール コンポーネントがリアルタイムの脅威保護シナリオでチャット メッセージを送信または取得するために使用できる絶対 URL。
注釈
リアルタイムの脅威保護のためにチャット メッセージ履歴にアクセスする必要がある HTTP 要求を作成するときに、このメソッドを呼び出します。 返される URL には、MCP プラットフォームのベース アドレスと固定パス セグメント /agents/real-time-threat-protection/chat-messageが既に含まれています。
GetMcpBaseUrl(IConfigurationProvider<ToolingConfiguration>)
警告
この API は非推奨になりました。
This method is for internal use only. Use McpToolServerConfigurationService instead.
MCP 環境のクエリに使用するベース URL を取得します。
static function GetMcpBaseUrl(configProvider?: IConfigurationProvider<ToolingConfiguration>): stringパラメーター
- configProvider
オプションの構成プロバイダー。 既定値は defaultToolingConfigurationProvider です。
返品
string
ベース MCP 環境の URL。
GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)
警告
この API は非推奨になりました。
This method is for internal use only. Use McpToolServerConfigurationService.listToolServers() instead.
特定のエージェント ID のツール ゲートウェイ URL を構築します。 このエンドポイントは、指定されたエージェント ID に関連付けられている MCP サーバーを検出するために使用されます。
例: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/{agenticAppId}/mcpServers"
static function GetToolingGatewayForDigitalWorker(agenticAppId: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): stringパラメーター
- agenticAppId
-
string
エージェント ID の一意識別子。
- configProvider
オプションの構成プロバイダー。 既定値は defaultToolingConfigurationProvider です。
返品
string
エージェントのツール ゲートウェイを指す完全修飾 URL。
GetToolRequestHeaders(string, TurnContext, ToolOptions)
MCP ツール要求の標準ヘッダーを作成します。 指定された場合は承認ベアラー トークンが含まれます。必要に応じて、ルーティング用のチャネル識別子とサブチャネル識別子が含まれます。
static function GetToolRequestHeaders(authToken?: string, turnContext?: TurnContext, options?: ToolOptions): Record<string, string>パラメーター
- authToken
-
string
Authorization ヘッダーのベアラー トークン。
- turnContext
- TurnContext
チャネル ID とサブチャネル ID の抽出元のオプションの TurnContext オブジェクト。
- options
- ToolOptions
追加の要求構成用の省略可能な ToolOptions オブジェクト。
返品
Record<string, string>
HTTP 要求に適したヘッダー レコード。
ValidateAuthToken(undefined | string)
JWT 認証トークンを検証します。 トークンが有効な JWT であり、有効期限が切れていないことを確認します。
static function ValidateAuthToken(authToken: undefined | string)パラメーター
- authToken
-
undefined | string
検証する JWT トークン。