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 |
构造给定代理标识的工具网关 URL。 此终结点用于发现与指定代理标识关联的 MCP 服务器。 示例：Utility.GetToolingGatewayForDigitalWorker（agenticAppId） // => “https://agent365.svc.cloud.microsoft/agents/v2/{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.
构造给定代理标识的工具网关 URL。 此终结点用于发现与指定代理标识关联的 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
指向代理的工具网关的完全限定 URL。
GetToolRequestHeaders(string, TurnContext, ToolOptions)
为 MCP 工具请求撰写标准标头。 提供时包括授权持有者令牌，还可以选择包含路由的通道和子通道标识符。
static function GetToolRequestHeaders(authToken?: string, turnContext?: TurnContext, options?: ToolOptions): Record<string, string>参数
- authToken
-
string
授权标头的持有者令牌。
- turnContext
- TurnContext
从中提取通道和子通道 ID 的可选 TurnContext 对象。
- options
- ToolOptions
用于其他请求配置的可选 ToolOptions 对象。
返回
Record<string, string>
适用于 HTTP 请求的标头记录。
ValidateAuthToken(undefined | string)
验证 JWT 身份验证令牌。 检查令牌是否为有效的 JWT 且未过期。
static function ValidateAuthToken(authToken: undefined | string)参数
- authToken
-
undefined | string
要验证的 JWT 令牌。