Utility class
Egenskaper
| HEADER_AGENT_ID | Rubriknamn för att skicka agentidentifieraren till MCP-plattformen för loggning/analys. |
| HEADER_CHANNEL_ID | |
| HEADER_SUBCHANNEL_ID | |
| HEADER_USER_AGENT |
Metoder
| Build |
Skapa den fullständiga URL:en för åtkomst till en specifik MCP-server. Exempel: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/" |
| Get |
Skapar slutpunkts-URL:en för att skicka chatthistorik till MCP-plattformen för skydd mot hot i realtid. |
| Get |
Hämta bas-URL:en som används för att fråga MCP-miljöer. |
| Get |
Konstruera url:en för verktygsgatewayen för en viss agentidentitet. Den här slutpunkten används för att identifiera MCP-servrar som är associerade med den angivna agentidentiteten. Exempel: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers" |
| Get |
Skapa standardhuvuden för MCP-verktygsbegäranden. Innehåller auktoriseringsbäraretoken när den tillhandahålls, och du kan även inkludera kanal- och underkanalsidentifierare för routning. |
| Validate |
Verifierar en JWT-autentiseringstoken. Kontrollerar att token är en giltig JWT och inte har upphört att gälla. |
Egenskapsinformation
HEADER_AGENT_ID
Rubriknamn för att skicka agentidentifieraren till MCP-plattformen för loggning/analys.
static HEADER_AGENT_ID: "x-ms-agentid" = "x-ms-agentid"Egenskapsvärde
"x-ms-agentid"
HEADER_CHANNEL_ID
static HEADER_CHANNEL_ID: "x-ms-channel-id" = "x-ms-channel-id"Egenskapsvärde
"x-ms-channel-id"
HEADER_SUBCHANNEL_ID
static HEADER_SUBCHANNEL_ID: "x-ms-subchannel-id" = "x-ms-subchannel-id"Egenskapsvärde
"x-ms-subchannel-id"
HEADER_USER_AGENT
static HEADER_USER_AGENT: "User-Agent" = "User-Agent"Egenskapsvärde
"User-Agent"
Metodinformation
BuildMcpServerUrl(string, IConfigurationProvider<ToolingConfiguration>)
Varning
Det här API:et är nu inaktuellt.
This method is for internal use only. Use McpToolServerConfigurationService instead.
Skapa den fullständiga URL:en för åtkomst till en specifik MCP-server.
Exempel: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/"
static function BuildMcpServerUrl(serverName: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParametrar
- serverName
-
string
MCP-serverns resursnamn.
- configProvider
Valfri konfigurationsprovider. Standardvärdet är defaultToolingConfigurationProvider.
Returer
string
Den fullständigt kvalificerade MCP-server-URL:en, inklusive avslutande snedstreck.
GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)
Varning
Det här API:et är nu inaktuellt.
This method is for internal use only. Use McpToolServerConfigurationService.sendChatHistory() instead.
Skapar slutpunkts-URL:en för att skicka chatthistorik till MCP-plattformen för skydd mot hot i realtid.
static function GetChatHistoryEndpoint(configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParametrar
- configProvider
Valfri konfigurationsprovider. Standardvärdet är defaultToolingConfigurationProvider.
Returer
string
En absolut URL som verktygskomponenter kan använda för att skicka eller hämta chattmeddelanden för scenarier med skydd mot hot i realtid.
Kommentarer
Anropa den här metoden när du skapar HTTP-begäranden som behöver komma åt chattmeddelandehistoriken för skydd mot hot i realtid. Den returnerade URL:en innehåller redan MCP-plattformens basadress och segmentet /agents/real-time-threat-protection/chat-messageför fast sökväg .
GetMcpBaseUrl(IConfigurationProvider<ToolingConfiguration>)
Varning
Det här API:et är nu inaktuellt.
This method is for internal use only. Use McpToolServerConfigurationService instead.
Hämta bas-URL:en som används för att fråga MCP-miljöer.
static function GetMcpBaseUrl(configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParametrar
- configProvider
Valfri konfigurationsprovider. Standardvärdet är defaultToolingConfigurationProvider.
Returer
string
Den grundläggande URL:en för MCP-miljöer.
GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)
Varning
Det här API:et är nu inaktuellt.
This method is for internal use only. Use McpToolServerConfigurationService.listToolServers() instead.
Konstruera url:en för verktygsgatewayen för en viss agentidentitet. Den här slutpunkten används för att identifiera MCP-servrar som är associerade med den angivna agentidentiteten.
Exempel: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers"
static function GetToolingGatewayForDigitalWorker(agenticAppId: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParametrar
- agenticAppId
-
string
Den unika identifieraren för agentidentiteten.
- configProvider
Valfri konfigurationsprovider. Standardvärdet är defaultToolingConfigurationProvider.
Returer
string
En fullständigt kvalificerad URL som pekar på verktygsgatewayen för agenten.
GetToolRequestHeaders(string, TurnContext, ToolOptions)
Skapa standardhuvuden för MCP-verktygsbegäranden. Innehåller auktoriseringsbäraretoken när den tillhandahålls, och du kan även inkludera kanal- och underkanalsidentifierare för routning.
static function GetToolRequestHeaders(authToken?: string, turnContext?: TurnContext, options?: ToolOptions): Record<string, string>Parametrar
- authToken
-
string
Ägartoken för auktoriseringshuvud.
- turnContext
- TurnContext
Valfritt TurnContext-objekt från vilket kanal- och underkanals-ID extraheras.
- options
- ToolOptions
Valfritt ToolOptions-objekt för ytterligare konfiguration av begäranden.
Returer
Record<string, string>
En rubrikpost som är lämplig för HTTP-begäranden.
ValidateAuthToken(undefined | string)
Verifierar en JWT-autentiseringstoken. Kontrollerar att token är en giltig JWT och inte har upphört att gälla.
static function ValidateAuthToken(authToken: undefined | string)Parametrar
- authToken
-
undefined | string
JWT-token som ska verifieras.