Utility class
Vlastnosti
| HEADER_AGENT_ID | Název hlavičky pro odeslání identifikátoru agenta do platformy MCP pro protokolování a analýzu |
| HEADER_CHANNEL_ID | |
| HEADER_SUBCHANNEL_ID | |
| HEADER_USER_AGENT |
Metody
| Build |
Vytvořte úplnou adresu URL pro přístup ke konkrétnímu serveru MCP. Příklad: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/" |
| Get |
Vytvoří adresu URL koncového bodu pro odesílání historie chatu na platformu MCP pro ochranu před hrozbami v reálném čase. |
| Get |
Získejte základní adresu URL použitou k dotazování prostředí MCP. |
| Get |
Vytvořte adresu URL brány nástrojů pro danou identitu agenta. Tento koncový bod slouží ke zjišťování serverů MCP přidružených k zadané identitě agenta. Příklad: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers" |
| Get |
Vytváření standardních hlaviček pro žádosti o nástroje MCP Zahrnuje autorizační nosný token, pokud je k dispozici, a volitelně obsahuje identifikátory kanálu a podkanály pro směrování. |
| Validate |
Ověří ověřovací token JWT. Zkontroluje, jestli je token platným JWT a jeho platnost nevypršela. |
Podrobnosti vlastnosti
HEADER_AGENT_ID
Název hlavičky pro odeslání identifikátoru agenta do platformy MCP pro protokolování a analýzu
static HEADER_AGENT_ID: "x-ms-agentid" = "x-ms-agentid"Hodnota vlastnosti
"x-ms-agentid"
HEADER_CHANNEL_ID
static HEADER_CHANNEL_ID: "x-ms-channel-id" = "x-ms-channel-id"Hodnota vlastnosti
"x-ms-channel-id"
HEADER_SUBCHANNEL_ID
static HEADER_SUBCHANNEL_ID: "x-ms-subchannel-id" = "x-ms-subchannel-id"Hodnota vlastnosti
"x-ms-subchannel-id"
HEADER_USER_AGENT
static HEADER_USER_AGENT: "User-Agent" = "User-Agent"Hodnota vlastnosti
"User-Agent"
Podrobnosti metody
BuildMcpServerUrl(string, IConfigurationProvider<ToolingConfiguration>)
Upozornění
Toto rozhraní API je teď zastaralé.
This method is for internal use only. Use McpToolServerConfigurationService instead.
Vytvořte úplnou adresu URL pro přístup ke konkrétnímu serveru MCP.
Příklad: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/"
static function BuildMcpServerUrl(serverName: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParametry
- serverName
-
string
Název prostředku serveru MCP.
- configProvider
Volitelný zprostředkovatel konfigurace Výchozí hodnota je defaultToolingConfigurationProvider.
Návraty
string
Plně kvalifikovaná adresa URL serveru MCP, včetně koncového lomítka.
GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)
Upozornění
Toto rozhraní API je teď zastaralé.
This method is for internal use only. Use McpToolServerConfigurationService.sendChatHistory() instead.
Vytvoří adresu URL koncového bodu pro odesílání historie chatu na platformu MCP pro ochranu před hrozbami v reálném čase.
static function GetChatHistoryEndpoint(configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParametry
- configProvider
Volitelný zprostředkovatel konfigurace Výchozí hodnota je defaultToolingConfigurationProvider.
Návraty
string
Absolutní adresa URL, kterou můžou komponenty nástrojů použít k odesílání nebo načítání chatových zpráv pro scénáře ochrany před hrozbami v reálném čase.
Poznámky
Tuto metodu zavolejte při vytváření požadavků HTTP, které potřebují přístup k historii chatových zpráv pro ochranu před hrozbami v reálném čase. Vrácená adresa URL již obsahuje základní adresu platformy MCP a segment /agents/real-time-threat-protection/chat-messagepevné cesty .
GetMcpBaseUrl(IConfigurationProvider<ToolingConfiguration>)
Upozornění
Toto rozhraní API je teď zastaralé.
This method is for internal use only. Use McpToolServerConfigurationService instead.
Získejte základní adresu URL použitou k dotazování prostředí MCP.
static function GetMcpBaseUrl(configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParametry
- configProvider
Volitelný zprostředkovatel konfigurace Výchozí hodnota je defaultToolingConfigurationProvider.
Návraty
string
Základní adresa URL prostředí MCP.
GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)
Upozornění
Toto rozhraní API je teď zastaralé.
This method is for internal use only. Use McpToolServerConfigurationService.listToolServers() instead.
Vytvořte adresu URL brány nástrojů pro danou identitu agenta. Tento koncový bod slouží ke zjišťování serverů MCP přidružených k zadané identitě agenta.
Příklad: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers"
static function GetToolingGatewayForDigitalWorker(agenticAppId: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParametry
- agenticAppId
-
string
Jedinečný identifikátor identity agenta.
- configProvider
Volitelný zprostředkovatel konfigurace Výchozí hodnota je defaultToolingConfigurationProvider.
Návraty
string
Plně kvalifikovaná adresa URL odkazující na bránu nástrojů pro agenta.
GetToolRequestHeaders(string, TurnContext, ToolOptions)
Vytváření standardních hlaviček pro žádosti o nástroje MCP Zahrnuje autorizační nosný token, pokud je k dispozici, a volitelně obsahuje identifikátory kanálu a podkanály pro směrování.
static function GetToolRequestHeaders(authToken?: string, turnContext?: TurnContext, options?: ToolOptions): Record<string, string>Parametry
- authToken
-
string
Nosný token pro autorizační hlavičku
- turnContext
- TurnContext
Volitelný objekt TurnContext, ze kterého se extrahují ID kanálu a subchannel.
- options
- ToolOptions
Volitelný objekt ToolOptions pro další konfiguraci požadavku.
Návraty
Record<string, string>
Záznam hlaviček vhodný pro požadavky HTTP.
ValidateAuthToken(undefined | string)
Ověří ověřovací token JWT. Zkontroluje, jestli je token platným JWT a jeho platnost nevypršela.
static function ValidateAuthToken(authToken: undefined | string)Parametry
- authToken
-
undefined | string
Token JWT, který se má ověřit.