Utility class
屬性
| HEADER_AGENT_ID | 標頭名稱用於將代理識別碼傳送到 MCP 平台進行日誌/分析。 |
| HEADER_CHANNEL_ID | |
| HEADER_SUBCHANNEL_ID | |
| HEADER_USER_AGENT |
方法
| Build |
建立完整網址以存取特定 MCP 伺服器。 範例：Utility.BuildMcpServerUrl（'MyServer'） // => “https://agent365.svc.cloud.microsoft/agents/servers/MyServer/" |
| Get |
建立端點 URL，將聊天歷史傳送至 MCP 平台，以實現即時威脅防護。 |
| Get |
取得用來查詢 MCP 環境的基礎網址。 |
| Get |
為特定代理身份建立工具閘道網址。 此端點用來發現與指定代理身份相關的 MCP 伺服器。 範例：Utility.GetToolingGatewayForDigitalWorker（agenticAppId） // => “https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers" |
| Get |
為 MCP 工具請求撰寫標準標頭。 提供授權持有人令牌（Authorization bearer Token）時可選配通道及子通道識別碼以供路由。 |
| Validate |
驗證 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 伺服器。
範例：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 伺服器網址，包含尾部斜線。
GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)
警告
此 API 現已淘汰。
This method is for internal use only. Use McpToolServerConfigurationService.sendChatHistory() instead.
建立端點 URL，將聊天歷史傳送至 MCP 平台，以實現即時威脅防護。
static function GetChatHistoryEndpoint(configProvider?: IConfigurationProvider<ToolingConfiguration>): string參數
- configProvider
可選的設定提供者。 預設為 defaultToolingConfigurationProvider。
傳回
string
一個絕對的網址，工具元件可用來傳送或檢索即時威脅防護情境下的聊天訊息。
備註
在構建需要存取聊天訊息歷史以實現即時威脅防護的 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 環境的基礎網址。
static function GetMcpBaseUrl(configProvider?: IConfigurationProvider<ToolingConfiguration>): string參數
- configProvider
可選的設定提供者。 預設為 defaultToolingConfigurationProvider。
傳回
string
基礎 MCP 環境的網址。
GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)
警告
此 API 現已淘汰。
This method is for internal use only. Use McpToolServerConfigurationService.listToolServers() instead.
為特定代理身份建立工具閘道網址。 此端點用來發現與指定代理身份相關的 MCP 伺服器。
範例：Utility.GetToolingGatewayForDigitalWorker（agenticAppId） // => “https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers"
static function GetToolingGatewayForDigitalWorker(agenticAppId: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): string參數
- agenticAppId
-
string
代理人身份的唯一識別碼。
- configProvider
可選的設定提供者。 預設為 defaultToolingConfigurationProvider。
傳回
string
一個完全合格的網址，指向代理人的工具閘道。
GetToolRequestHeaders(string, TurnContext, ToolOptions)
為 MCP 工具請求撰寫標準標頭。 提供授權持有人令牌（Authorization bearer Token）時可選配通道及子通道識別碼以供路由。
static function GetToolRequestHeaders(authToken?: string, turnContext?: TurnContext, options?: ToolOptions): Record<string, string>參數
- authToken
-
string
授權標頭的承載標記。
- turnContext
- TurnContext
可選的 TurnContext 物件，可從中擷取通道及子通道 ID。
- options
- ToolOptions
可選的 ToolOptions 物件用於額外請求設定。
傳回
Record<string, string>
一個適合 HTTP 請求的標頭記錄。
ValidateAuthToken(undefined | string)
驗證 JWT 認證憑證。 檢查該令牌是否有效且未過期。
static function ValidateAuthToken(authToken: undefined | string)參數
- authToken
-
undefined | string
用 JWT 代幣來驗證。