Utility class
Propriedades
| HEADER_AGENT_ID | Nome do cabeçalho para enviar o identificador do agente para a plataforma MCP para log/análise. |
| HEADER_CHANNEL_ID | |
| HEADER_SUBCHANNEL_ID | |
| HEADER_USER_AGENT |
Métodos
| Build |
Crie a URL completa para acessar um servidor MCP específico. Exemplo: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/" |
| Get |
Constrói a URL do ponto de extremidade 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 |
Construa a URL do gateway de ferramentas para uma determinada identidade de agente. Esse ponto de extremidade é usado para descobrir servidores MCP associados à identidade do agente especificada. Exemplo: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/{agenticAppId}/mcpServers" |
| Get |
Redigir cabeçalhos padrão para solicitações de ferramentas MCP. Inclui o token de portador de autorização quando fornecido e, opcionalmente, inclui identificadores de canal e subcanal para roteamento. |
| Validate |
Valida um token de autenticação JWT. Verifica se o token é um JWT válido e não expirou. |
Detalhes da propriedade
HEADER_AGENT_ID
Nome do cabeçalho para enviar o identificador do agente para a plataforma MCP para log/análise.
static HEADER_AGENT_ID: "x-ms-agentid" = "x-ms-agentid"Valor da propriedade
"x-ms-agentid"
HEADER_CHANNEL_ID
static HEADER_CHANNEL_ID: "x-ms-channel-id" = "x-ms-channel-id"Valor da propriedade
"x-ms-channel-id"
HEADER_SUBCHANNEL_ID
static HEADER_SUBCHANNEL_ID: "x-ms-subchannel-id" = "x-ms-subchannel-id"Valor da propriedade
"x-ms-subchannel-id"
HEADER_USER_AGENT
static HEADER_USER_AGENT: "User-Agent" = "User-Agent"Valor da propriedade
"User-Agent"
Detalhes do método
BuildMcpServerUrl(string, IConfigurationProvider<ToolingConfiguration>)
Aviso
Essa API foi preterida.
This method is for internal use only. Use McpToolServerConfigurationService instead.
Crie a URL completa para acessar 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
Provedor de configuração opcional. O padrão é DefaultToolingConfigurationProvider.
Retornos
string
A URL do servidor MCP totalmente qualificada, incluindo barra à direita.
GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)
Aviso
Essa API foi preterida.
This method is for internal use only. Use McpToolServerConfigurationService.sendChatHistory() instead.
Constrói a URL do ponto de extremidade 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
Provedor de configuração opcional. O padrão é DefaultToolingConfigurationProvider.
Retornos
string
Uma URL absoluta que os componentes de ferramentas podem usar para enviar ou recuperar mensagens de chat para cenários de proteção contra ameaças em tempo real.
Comentários
Chame esse método ao construir solicitações HTTP que precisam acessar o histórico de mensagens de chat para proteção contra ameaças em tempo real. A URL retornada 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
Essa 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
Provedor de configuração opcional. O padrão é DefaultToolingConfigurationProvider.
Retornos
string
A URL de ambientes MCP base.
GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)
Aviso
Essa API foi preterida.
This method is for internal use only. Use McpToolServerConfigurationService.listToolServers() instead.
Construa a URL do gateway de ferramentas para uma determinada identidade de agente. Esse ponto de extremidade é usado para descobrir servidores MCP associados à identidade do agente especificada.
Exemplo: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/{agenticAppId}/mcpServers"
static function GetToolingGatewayForDigitalWorker(agenticAppId: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParâmetros
- agenticAppId
-
string
O identificador exclusivo da identidade do agente.
- configProvider
Provedor de configuração opcional. O padrão é DefaultToolingConfigurationProvider.
Retornos
string
Uma URL totalmente qualificada apontando para o gateway de ferramentas para o agente.
GetToolRequestHeaders(string, TurnContext, ToolOptions)
Redigir cabeçalhos padrão para solicitações de ferramentas MCP. Inclui o token de portador de autorização quando fornecido e, opcionalmente, inclui identificadores de canal e subcanal para roteamento.
static function GetToolRequestHeaders(authToken?: string, turnContext?: TurnContext, options?: ToolOptions): Record<string, string>Parâmetros
- authToken
-
string
Token de portador para cabeçalho de autorização.
- turnContext
- TurnContext
Objeto TurnContext opcional do qual as IDs de canal e subcanal são extraídas.
- options
- ToolOptions
Objeto ToolOptions opcional para configuração de solicitação adicional.
Retornos
Record<string, string>
Um registro de cabeçalhos adequado para solicitações HTTP.
ValidateAuthToken(undefined | string)
Valida um token de autenticação JWT. Verifica se o token é um JWT válido e não expirou.
static function ValidateAuthToken(authToken: undefined | string)Parâmetros
- authToken
-
undefined | string
O token JWT a ser validado.