Utility class

Nome dell'intestazione per l'invio dell'identificatore dell'agente alla piattaforma MCP per la registrazione/analisi.

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

Valore della proprietà

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

Valore della proprietà

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

Valore della proprietà

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

Valore della proprietà

Compilare l'URL completo per l'accesso a un server MCP specifico.

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

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

Parametri

Valori restituiti

URL completo del server MCP, inclusa la barra finale.

Costruisce l'URL dell'endpoint per l'invio della cronologia delle chat alla piattaforma MCP per la protezione dalle minacce in tempo reale.

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

Parametri

Valori restituiti

URL assoluto che i componenti degli strumenti possono usare per inviare o recuperare messaggi di chat per scenari di protezione dalle minacce in tempo reale.

Commenti

Chiamare questo metodo quando si creano richieste HTTP che devono accedere alla cronologia dei messaggi di chat per la protezione dalle minacce in tempo reale. L'URL restituito include già l'indirizzo di base della piattaforma MCP e il segmento di /agents/real-time-threat-protection/chat-messagepercorso fisso .

Ottenere l'URL di base usato per eseguire query negli ambienti MCP.

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

Parametri

Valori restituiti

URL degli ambienti MCP di base.

Costruire l'URL del gateway di strumenti per un'identità dell'agente specificata. Questo endpoint viene usato per individuare i server MCP associati all'identità dell'agente specificata.

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

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

Parametri

Valori restituiti

URL completo che punta al gateway di strumenti per l'agente.

Comporre intestazioni standard per le richieste di strumenti MCP. Include il token di connessione dell'autorizzazione quando specificato e, facoltativamente, include identificatori di canale e sottocanale per il routing.

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

Parametri

Valori restituiti

Record di intestazioni adatto per le richieste HTTP.

Convalida un token di autenticazione JWT. Verifica che il token sia un token JWT valido e non sia scaduto.

static function ValidateAuthToken(authToken: undefined | string)

Parametri