Utility class
Propriedades
| HEADER_AGENT_ID | Nome do cabeçalho para enviar o identificador do agente para a plataforma MCP para registo/análise. |
| HEADER_CHANNEL_ID | |
| HEADER_SUBCHANNEL_ID | |
| HEADER_USER_AGENT |
Métodos
| Build |
Constrói a URL completa para aceder a um servidor MCP específico. Exemplo: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/" |
| Get |
Constrói a URL do endpoint para enviar o histórico de chat para a plataforma MCP para proteção contra ameaças em tempo real. |
| Get |
Obtenha a URL base usada para consultar ambientes MCP. |
| Get |
Constrói a URL do gateway da ferramenta para uma dada identidade de agente. Este endpoint é usado para descobrir servidores MCP associados à identidade do agente especificada. Exemplo: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers" |
| Get |
Compor cabeçalhos padrão para pedidos de ferramentas MCP. Inclui token portador de autorização quando fornecido, e opcionalmente inclui identificadores de canal e subcanal para encaminhamento. |
| Validate |
Valida um token de autenticação JWT. Verifica se o token é um JWT válido e não está expirado. |
Detalhes de Propriedade
HEADER_AGENT_ID
Nome do cabeçalho para enviar o identificador do agente para a plataforma MCP para registo/análise.
static HEADER_AGENT_ID: "x-ms-agentid" = "x-ms-agentid"Valor de Propriedade
"x-ms-agentid"
HEADER_CHANNEL_ID
static HEADER_CHANNEL_ID: "x-ms-channel-id" = "x-ms-channel-id"Valor de Propriedade
"x-ms-channel-id"
HEADER_SUBCHANNEL_ID
static HEADER_SUBCHANNEL_ID: "x-ms-subchannel-id" = "x-ms-subchannel-id"Valor de Propriedade
"x-ms-subchannel-id"
HEADER_USER_AGENT
static HEADER_USER_AGENT: "User-Agent" = "User-Agent"Valor de Propriedade
"User-Agent"
Detalhes de Método
BuildMcpServerUrl(string, IConfigurationProvider<ToolingConfiguration>)
Aviso
Esta API foi preterida.
This method is for internal use only. Use McpToolServerConfigurationService instead.
Constrói a URL completa para aceder a um servidor MCP específico.
Exemplo: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/"
static function BuildMcpServerUrl(serverName: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParâmetros
- serverName
-
string
O nome do recurso do servidor MCP.
- configProvider
Fornecedor de configuração opcional. Define por defeito o defaultToolingConfigurationProvider.
Devoluções
string
O URL do servidor MCP totalmente qualificado, incluindo barra lateral lateral.
GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)
Aviso
Esta API foi preterida.
This method is for internal use only. Use McpToolServerConfigurationService.sendChatHistory() instead.
Constrói a URL do endpoint para enviar o histórico de chat para a plataforma MCP para proteção contra ameaças em tempo real.
static function GetChatHistoryEndpoint(configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParâmetros
- configProvider
Fornecedor de configuração opcional. Define por defeito o defaultToolingConfigurationProvider.
Devoluções
string
Um URL absoluto que os componentes das ferramentas podem usar para enviar ou recuperar mensagens de chat em cenários de proteção contra ameaças em tempo real.
Observações
Chame este método ao construir pedidos HTTP que precisam de aceder ao histórico de mensagens de chat para proteção contra ameaças em tempo real. O URL devolvido já inclui o endereço base da plataforma MCP e o segmento /agents/real-time-threat-protection/chat-messagede caminho fixo .
GetMcpBaseUrl(IConfigurationProvider<ToolingConfiguration>)
Aviso
Esta API foi preterida.
This method is for internal use only. Use McpToolServerConfigurationService instead.
Obtenha a URL base usada para consultar ambientes MCP.
static function GetMcpBaseUrl(configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParâmetros
- configProvider
Fornecedor de configuração opcional. Define por defeito o defaultToolingConfigurationProvider.
Devoluções
string
A URL base dos ambientes MCP.
GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)
Aviso
Esta API foi preterida.
This method is for internal use only. Use McpToolServerConfigurationService.listToolServers() instead.
Constrói a URL do gateway da ferramenta para uma dada identidade de agente. Este endpoint é usado para descobrir servidores MCP associados à identidade do agente especificada.
Exemplo: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers"
static function GetToolingGatewayForDigitalWorker(agenticAppId: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParâmetros
- agenticAppId
-
string
O identificador único para a identidade do agente.
- configProvider
Fornecedor de configuração opcional. Define por defeito o defaultToolingConfigurationProvider.
Devoluções
string
Um URL totalmente qualificado a apontar para o gateway de ferramentas do agente.
GetToolRequestHeaders(string, TurnContext, ToolOptions)
Compor cabeçalhos padrão para pedidos de ferramentas MCP. Inclui token portador de autorização quando fornecido, e opcionalmente inclui identificadores de canal e subcanal para encaminhamento.
static function GetToolRequestHeaders(authToken?: string, turnContext?: TurnContext, options?: ToolOptions): Record<string, string>Parâmetros
- authToken
-
string
Token portador para o cabeçalho de Autorização.
- turnContext
- TurnContext
Objeto opcional TurnContext do qual são extraídos os IDs de canal e subcanal.
- options
- ToolOptions
Objeto opcional ToolOptions para configuração adicional de pedidos.
Devoluções
Record<string, string>
Um registo de cabeçalhos adequado para pedidos HTTP.
ValidateAuthToken(undefined | string)
Valida um token de autenticação JWT. Verifica se o token é um JWT válido e não está expirado.
static function ValidateAuthToken(authToken: undefined | string)Parâmetros
- authToken
-
undefined | string
O token JWT para validar.