Utility class

Nom d’en-tête pour l’envoi de l’identificateur de l’agent à la plateforme MCP pour la journalisation/analytique.

static HEADER_AGENT_ID: "x-ms-agentid" = "x-ms-agentid"

Valeur de propriété

static HEADER_CHANNEL_ID: "x-ms-channel-id" = "x-ms-channel-id"

Valeur de propriété

static HEADER_SUBCHANNEL_ID: "x-ms-subchannel-id" = "x-ms-subchannel-id"

Valeur de propriété

static HEADER_USER_AGENT: "User-Agent" = "User-Agent"

Valeur de propriété

Générez l’URL complète pour accéder à un serveur MCP spécifique.

Exemple : Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/" ;

static function BuildMcpServerUrl(serverName: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): string

Paramètres

Retours

URL complète du serveur MCP, y compris la barre oblique de fin.

Construit l’URL du point de terminaison pour l’envoi de l’historique des conversations à la plateforme MCP pour la protection contre les menaces en temps réel.

static function GetChatHistoryEndpoint(configProvider?: IConfigurationProvider<ToolingConfiguration>): string

Paramètres

Retours

URL absolue que les composants d’outils peuvent utiliser pour envoyer ou récupérer des messages de conversation pour des scénarios de protection contre les menaces en temps réel.

Remarques

Appelez cette méthode lors de la construction de requêtes HTTP qui doivent accéder à l’historique des messages de conversation pour la protection contre les menaces en temps réel. L’URL retournée inclut déjà l’adresse de base de la plateforme MCP et le segment /agents/real-time-threat-protection/chat-messagede chemin fixe.

Obtenez l’URL de base utilisée pour interroger des environnements MCP.

static function GetMcpBaseUrl(configProvider?: IConfigurationProvider<ToolingConfiguration>): string

Paramètres

Retours

URL des environnements MCP de base.

Construisez l’URL de passerelle d’outils pour une identité d’agent donnée. Ce point de terminaison est utilisé pour découvrir les serveurs MCP associés à l’identité de l’agent spécifiée.

Exemple : Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers" ;

static function GetToolingGatewayForDigitalWorker(agenticAppId: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): string

Paramètres

Retours

URL complète pointant vers la passerelle d’outils de l’agent.

Composez des en-têtes standard pour les demandes d’outils MCP. Inclut le jeton du porteur d’autorisation lorsqu’il est fourni, et inclut éventuellement des identificateurs de canal et de sous-canal pour le routage.

static function GetToolRequestHeaders(authToken?: string, turnContext?: TurnContext, options?: ToolOptions): Record<string, string>

Paramètres

Retours

Enregistrement d’en-têtes adapté aux requêtes HTTP.

Valide un jeton d’authentification JWT. Vérifie que le jeton est un JWT valide et n’a pas expiré.

static function ValidateAuthToken(authToken: undefined | string)

Paramètres