Utility class
Egenskaber
| HEADER_AGENT_ID | Headernavn til afsendelse af agent-id'et til MCP-platformen til logføring/analyse. |
| HEADER_CHANNEL_ID | |
| HEADER_SUBCHANNEL_ID | |
| HEADER_USER_AGENT |
Metoder
| Build |
Opret den fulde URL-adresse for at få adgang til en bestemt MCP-server. Eksempel: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/" |
| Get |
Konstruerer URL-adressen for slutpunktet til afsendelse af chathistorik til MCP-platformen for at beskytte trusler i realtid. |
| Get |
Hent den grundlæggende URL-adresse, der bruges til at forespørge MCP-miljøer. |
| Get |
Opret URL-adressen til værktøjsgatewayen for en given agentidentitet. Dette slutpunkt bruges til at finde MCP-servere, der er knyttet til den angivne agentidentitet. Eksempel: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers" |
| Get |
Opret standardheadere til MCP-værktøjsanmodninger. Inkluderer token til godkendelsesbærer, når det er angivet, og inkluderer eventuelt kanal- og underkanal-id'er for routing. |
| Validate |
Validerer et JWT-godkendelsestoken. Kontrollerer, at tokenet er et gyldigt JWT og ikke er udløbet. |
Oplysninger om egenskab
HEADER_AGENT_ID
Headernavn til afsendelse af agent-id'et til MCP-platformen til logføring/analyse.
static HEADER_AGENT_ID: "x-ms-agentid" = "x-ms-agentid"Egenskabsværdi
"x-ms-agentid"
HEADER_CHANNEL_ID
static HEADER_CHANNEL_ID: "x-ms-channel-id" = "x-ms-channel-id"Egenskabsværdi
"x-ms-channel-id"
HEADER_SUBCHANNEL_ID
static HEADER_SUBCHANNEL_ID: "x-ms-subchannel-id" = "x-ms-subchannel-id"Egenskabsværdi
"x-ms-subchannel-id"
HEADER_USER_AGENT
static HEADER_USER_AGENT: "User-Agent" = "User-Agent"Egenskabsværdi
"User-Agent"
Oplysninger om metode
BuildMcpServerUrl(string, IConfigurationProvider<ToolingConfiguration>)
Advarsel!
Denne API udfases nu.
This method is for internal use only. Use McpToolServerConfigurationService instead.
Opret den fulde URL-adresse for at få adgang 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>): stringParametre
- serverName
-
string
Navnet på MCP-serverressourcen.
- configProvider
Valgfri konfigurationsprovider. StandardindstillingenToolingConfigurationProvider er som standard.
Returnerer
string
Den fuldt kvalificerede URL-adresse til MCP-serveren, herunder efterstillet skråstreg.
GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)
Advarsel!
Denne API udfases nu.
This method is for internal use only. Use McpToolServerConfigurationService.sendChatHistory() instead.
Konstruerer URL-adressen for slutpunktet til afsendelse af chathistorik til MCP-platformen for at beskytte trusler i realtid.
static function GetChatHistoryEndpoint(configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParametre
- configProvider
Valgfri konfigurationsprovider. StandardindstillingenToolingConfigurationProvider er som standard.
Returnerer
string
En absolut URL-adresse, som værktøjskomponenter kan bruge til at sende eller hente chatmeddelelser til trusselsbeskyttelsesscenarier i realtid.
Bemærkninger
Kald denne metode, når du opretter HTTP-anmodninger, der har brug for at få adgang til chatmeddelelseshistorikken for at få beskyttelse mod trusler i realtid. Den returnerede URL-adresse indeholder allerede MCP-platformens basisadresse og segmentet /agents/real-time-threat-protection/chat-messagefor fast sti .
GetMcpBaseUrl(IConfigurationProvider<ToolingConfiguration>)
Advarsel!
Denne API udfases nu.
This method is for internal use only. Use McpToolServerConfigurationService instead.
Hent den grundlæggende URL-adresse, der bruges til at forespørge MCP-miljøer.
static function GetMcpBaseUrl(configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParametre
- configProvider
Valgfri konfigurationsprovider. StandardindstillingenToolingConfigurationProvider er som standard.
Returnerer
string
URL-adressen til basis-MCP-miljøer.
GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)
Advarsel!
Denne API udfases nu.
This method is for internal use only. Use McpToolServerConfigurationService.listToolServers() instead.
Opret URL-adressen til værktøjsgatewayen for en given agentidentitet. Dette slutpunkt bruges til at finde MCP-servere, der er knyttet til den angivne agentidentitet.
Eksempel: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers"
static function GetToolingGatewayForDigitalWorker(agenticAppId: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParametre
- agenticAppId
-
string
Det entydige id for agent-id'et.
- configProvider
Valgfri konfigurationsprovider. StandardindstillingenToolingConfigurationProvider er som standard.
Returnerer
string
En fuldt kvalificeret URL-adresse, der peger på værktøjsgatewayen for agenten.
GetToolRequestHeaders(string, TurnContext, ToolOptions)
Opret standardheadere til MCP-værktøjsanmodninger. Inkluderer token til godkendelsesbærer, når det er angivet, og inkluderer eventuelt kanal- og underkanal-id'er for routing.
static function GetToolRequestHeaders(authToken?: string, turnContext?: TurnContext, options?: ToolOptions): Record<string, string>Parametre
- authToken
-
string
Ihændehavertoken til godkendelsesheader.
- turnContext
- TurnContext
Valgfrit TurnContext-objekt, hvorfra kanal- og underkanal-id'er udtrækkes.
- options
- ToolOptions
Valgfrit ToolOptions-objekt til yderligere konfiguration af anmodning.
Returnerer
Record<string, string>
En headerpost, der er egnet til HTTP-anmodninger.
ValidateAuthToken(undefined | string)
Validerer et JWT-godkendelsestoken. Kontrollerer, at tokenet er et gyldigt JWT og ikke er udløbet.
static function ValidateAuthToken(authToken: undefined | string)Parametre
- authToken
-
undefined | string
Det JWT-token, der skal valideres.