Utility class
Propiedades
| HEADER_AGENT_ID | Nombre de encabezado para enviar el identificador del agente a la plataforma MCP para el registro y análisis. |
| HEADER_CHANNEL_ID | |
| HEADER_SUBCHANNEL_ID | |
| HEADER_USER_AGENT |
Métodos
| Build |
Compile la dirección URL completa para acceder a un servidor MCP específico. Ejemplo: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/" |
| Get |
Construye la dirección URL del punto de conexión para enviar el historial de chat a la plataforma MCP para la protección contra amenazas en tiempo real. |
| Get |
Obtenga la dirección URL base que se usa para consultar entornos de MCP. |
| Get |
Construya la dirección URL de la puerta de enlace de herramientas para una identidad de agente determinada. Este punto de conexión se usa para detectar servidores MCP asociados a la identidad del agente especificada. Ejemplo: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/{agenticAppId}/mcpServers" |
| Get |
Redactar encabezados estándar para solicitudes de herramientas de MCP. Incluye el token de portador de autorización cuando se proporciona y, opcionalmente, incluye identificadores de canal y subcanal para el enrutamiento. |
| Validate |
Valida un token de autenticación JWT. Comprueba que el token es un JWT válido y no ha expirado. |
Detalles de las propiedades
HEADER_AGENT_ID
Nombre de encabezado para enviar el identificador del agente a la plataforma MCP para el registro y análisis.
static HEADER_AGENT_ID: "x-ms-agentid" = "x-ms-agentid"Valor de propiedad
"x-ms-agentid"
HEADER_CHANNEL_ID
static HEADER_CHANNEL_ID: "x-ms-channel-id" = "x-ms-channel-id"Valor de propiedad
"x-ms-channel-id"
HEADER_SUBCHANNEL_ID
static HEADER_SUBCHANNEL_ID: "x-ms-subchannel-id" = "x-ms-subchannel-id"Valor de propiedad
"x-ms-subchannel-id"
HEADER_USER_AGENT
static HEADER_USER_AGENT: "User-Agent" = "User-Agent"Valor de propiedad
"User-Agent"
Detalles del método
BuildMcpServerUrl(string, IConfigurationProvider<ToolingConfiguration>)
Advertencia
Esta API ya está en desuso.
This method is for internal use only. Use McpToolServerConfigurationService instead.
Compile la dirección URL completa para acceder a un servidor MCP específico.
Ejemplo: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/"
static function BuildMcpServerUrl(serverName: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParámetros
- serverName
-
string
Nombre del recurso del servidor MCP.
- configProvider
Proveedor de configuración opcional. El valor predeterminado es defaultToolingConfigurationProvider.
Devoluciones
string
La dirección URL del servidor MCP completa, incluida la barra diagonal final.
GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)
Advertencia
Esta API ya está en desuso.
This method is for internal use only. Use McpToolServerConfigurationService.sendChatHistory() instead.
Construye la dirección URL del punto de conexión para enviar el historial de chat a la plataforma MCP para la protección contra amenazas en tiempo real.
static function GetChatHistoryEndpoint(configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParámetros
- configProvider
Proveedor de configuración opcional. El valor predeterminado es defaultToolingConfigurationProvider.
Devoluciones
string
Una dirección URL absoluta que los componentes de herramientas pueden usar para enviar o recuperar mensajes de chat para escenarios de protección contra amenazas en tiempo real.
Comentarios
Llame a este método al construir solicitudes HTTP que necesiten acceder al historial de mensajes de chat para la protección contra amenazas en tiempo real. La dirección URL devuelta ya incluye la dirección base de la plataforma MCP y el segmento /agents/real-time-threat-protection/chat-messagede ruta de acceso fijo .
GetMcpBaseUrl(IConfigurationProvider<ToolingConfiguration>)
Advertencia
Esta API ya está en desuso.
This method is for internal use only. Use McpToolServerConfigurationService instead.
Obtenga la dirección URL base que se usa para consultar entornos de MCP.
static function GetMcpBaseUrl(configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParámetros
- configProvider
Proveedor de configuración opcional. El valor predeterminado es defaultToolingConfigurationProvider.
Devoluciones
string
Dirección URL de entornos de MCP base.
GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)
Advertencia
Esta API ya está en desuso.
This method is for internal use only. Use McpToolServerConfigurationService.listToolServers() instead.
Construya la dirección URL de la puerta de enlace de herramientas para una identidad de agente determinada. Este punto de conexión se usa para detectar servidores MCP asociados a la identidad del agente especificada.
Ejemplo: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/{agenticAppId}/mcpServers"
static function GetToolingGatewayForDigitalWorker(agenticAppId: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParámetros
- agenticAppId
-
string
Identificador único de la identidad del agente.
- configProvider
Proveedor de configuración opcional. El valor predeterminado es defaultToolingConfigurationProvider.
Devoluciones
string
Dirección URL completa que apunta a la puerta de enlace de herramientas para el agente.
GetToolRequestHeaders(string, TurnContext, ToolOptions)
Redactar encabezados estándar para solicitudes de herramientas de MCP. Incluye el token de portador de autorización cuando se proporciona y, opcionalmente, incluye identificadores de canal y subcanal para el enrutamiento.
static function GetToolRequestHeaders(authToken?: string, turnContext?: TurnContext, options?: ToolOptions): Record<string, string>Parámetros
- authToken
-
string
Token de portador para el encabezado de autorización.
- turnContext
- TurnContext
Objeto TurnContext opcional desde el que se extraen los identificadores de canal y subcanal.
- options
- ToolOptions
Objeto ToolOptions opcional para la configuración de solicitud adicional.
Devoluciones
Record<string, string>
Un registro de encabezados adecuado para las solicitudes HTTP.
ValidateAuthToken(undefined | string)
Valida un token de autenticación JWT. Comprueba que el token es un JWT válido y no ha expirado.
static function ValidateAuthToken(authToken: undefined | string)Parámetros
- authToken
-
undefined | string
Token JWT que se va a validar.