Utility class

Egenskaper

HEADER_AGENT_ID

Topptekstnavn for sending av agentidentifikatoren til MCP-plattformen for logging/analyse.

HEADER_CHANNEL_ID
HEADER_SUBCHANNEL_ID
HEADER_USER_AGENT

Metoder

BuildMcpServerUrl(string, IConfigurationProvider<ToolingConfiguration>)

Bygg den fullstendige URL-adressen for tilgang til en bestemt MCP-server.

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

GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)

Konstruerer nettadressen for endepunktet for å sende chatteloggen til MCP-plattformen for trusselbeskyttelse i sanntid.

GetMcpBaseUrl(IConfigurationProvider<ToolingConfiguration>)

Få den grunnleggende URL-adressen som brukes til å spørre mcp-miljøer.

GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)

Konstruer url-adressen for verktøygatewayen for en gitt agentidentitet. Dette endepunktet brukes til å oppdage MCP-servere som er knyttet til den angitte agentidentiteten.

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

GetToolRequestHeaders(string, TurnContext, ToolOptions)

Skriv standardoverskrifter for MCP-verktøyforespørsler. Inkluderer autorisasjonsbærertoken når det er angitt, og inkluderer eventuelt kanal- og underkanalidentifikatorer for ruting.

ValidateAuthToken(undefined | string)

Validerer et JWT-godkjenningstoken. Kontrollerer at tokenet er en gyldig JWT og ikke er utløpt.

Egenskapsdetaljer

HEADER_AGENT_ID

Topptekstnavn for sending av agentidentifikatoren til MCP-plattformen for logging/analyse.

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

Egenskapsverdi

"x-ms-agentid"

HEADER_CHANNEL_ID

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

Egenskapsverdi

"x-ms-channel-id"

HEADER_SUBCHANNEL_ID

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

Egenskapsverdi

"x-ms-subchannel-id"

HEADER_USER_AGENT

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

Egenskapsverdi

"User-Agent"

Metodedetaljer

BuildMcpServerUrl(string, IConfigurationProvider<ToolingConfiguration>)

Advarsel

Denne API-en er nå avskrevet.

This method is for internal use only. Use McpToolServerConfigurationService instead.

Bygg den fullstendige URL-adressen for tilgang til en bestemt MCP-server.

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

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

Parametere

serverName

string

Ressursnavnet for MCP-serveren.

configProvider

IConfigurationProvider<ToolingConfiguration>

Valgfri konfigurasjonsleverandør. Standard er defaultToolingConfigurationProvider.

Returnerer

string

Den fullstendige URL-adressen for MCP-serveren, inkludert etterfølgende skråstrek.

GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)

Advarsel

Denne API-en er nå avskrevet.

This method is for internal use only. Use McpToolServerConfigurationService.sendChatHistory() instead.

Konstruerer nettadressen for endepunktet for å sende chatteloggen til MCP-plattformen for trusselbeskyttelse i sanntid.

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

Parametere

configProvider

IConfigurationProvider<ToolingConfiguration>

Valgfri konfigurasjonsleverandør. Standard er defaultToolingConfigurationProvider.

Returnerer

string

En absolutt NETTADRESSE som verktøykomponenter kan bruke til å sende eller hente chatmeldinger for situasjoner med trusselbeskyttelse i sanntid.

Merknader

Kall denne metoden når du konstruerer HTTP-forespørsler som trenger tilgang til chat-meldingsloggen for trusselbeskyttelse i sanntid. Den returnerte URL-adressen inneholder allerede basisadressen for MCP-plattformen og segmentet /agents/real-time-threat-protection/chat-messagefor fast bane.

GetMcpBaseUrl(IConfigurationProvider<ToolingConfiguration>)

Advarsel

Denne API-en er nå avskrevet.

This method is for internal use only. Use McpToolServerConfigurationService instead.

Få den grunnleggende URL-adressen som brukes til å spørre mcp-miljøer.

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

Parametere

configProvider

IConfigurationProvider<ToolingConfiguration>

Valgfri konfigurasjonsleverandør. Standard er defaultToolingConfigurationProvider.

Returnerer

string

Url-adressen for de grunnleggende MCP-miljøene.

GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)

Advarsel

Denne API-en er nå avskrevet.

This method is for internal use only. Use McpToolServerConfigurationService.listToolServers() instead.

Konstruer url-adressen for verktøygatewayen for en gitt agentidentitet. Dette endepunktet brukes til å oppdage MCP-servere som er knyttet til den angitte agentidentiteten.

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

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

Parametere

agenticAppId

string

Den unike identifikatoren for agentidentiteten.

configProvider

IConfigurationProvider<ToolingConfiguration>

Valgfri konfigurasjonsleverandør. Standard er defaultToolingConfigurationProvider.

Returnerer

string

En fullstendig url-adresse som peker mot verktøygatewayen for agenten.

GetToolRequestHeaders(string, TurnContext, ToolOptions)

Skriv standardoverskrifter for MCP-verktøyforespørsler. Inkluderer autorisasjonsbærertoken når det er angitt, og inkluderer eventuelt kanal- og underkanalidentifikatorer for ruting.

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

Parametere

authToken

string

Bærertoken for autorisasjonshodet.

turnContext
TurnContext

Valgfritt TurnContext-objekt som kanal- og underkanal-ID-er trekkes ut fra.

options
ToolOptions

Valgfritt ToolOptions-objekt for ytterligere forespørselskonfigurasjon.

Returnerer

Record<string, string>

En overskriftspost som passer for HTTP-forespørsler.

ValidateAuthToken(undefined | string)

Validerer et JWT-godkjenningstoken. Kontrollerer at tokenet er en gyldig JWT og ikke er utløpt.

static function ValidateAuthToken(authToken: undefined | string)

Parametere

authToken

undefined | string

JWT-tokenet som skal valideres.