Utility class

Eigenschappen

HEADER_AGENT_ID

Headernaam voor het verzenden van de agent-id naar HET MCP-platform voor logboekregistratie/analyse.

HEADER_CHANNEL_ID
HEADER_SUBCHANNEL_ID
HEADER_USER_AGENT

Methoden

BuildMcpServerUrl(string, IConfigurationProvider<ToolingConfiguration>)

Bouw de volledige URL voor toegang tot een specifieke MCP-server.

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

GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)

Hiermee wordt de eindpunt-URL samengesteld voor het verzenden van chatgeschiedenis naar het MCP-platform voor realtime bedreigingsbeveiliging.

GetMcpBaseUrl(IConfigurationProvider<ToolingConfiguration>)

Haal de basis-URL op die wordt gebruikt om query's uit te voeren op MCP-omgevingen.

GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)

Maak de URL van de tooling-gateway voor een bepaalde agentidentiteit. Dit eindpunt wordt gebruikt om MCP-servers te detecteren die zijn gekoppeld aan de opgegeven agentidentiteit.

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

GetToolRequestHeaders(string, TurnContext, ToolOptions)

Standaardheaders opstellen voor MCP-hulpprogrammaaanvragen. Bevat het Bearer-token voor autorisatie wanneer deze is opgegeven en bevat eventueel kanaal- en subkanaal-id's voor routering.

ValidateAuthToken(undefined | string)

Hiermee valideert u een JWT-verificatietoken. Controleert of het token een geldige JWT is en niet is verlopen.

Eigenschapdetails

HEADER_AGENT_ID

Headernaam voor het verzenden van de agent-id naar HET MCP-platform voor logboekregistratie/analyse.

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

Waarde van eigenschap

"x-ms-agentid"

HEADER_CHANNEL_ID

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

Waarde van eigenschap

"x-ms-channel-id"

HEADER_SUBCHANNEL_ID

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

Waarde van eigenschap

"x-ms-subchannel-id"

HEADER_USER_AGENT

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

Waarde van eigenschap

"User-Agent"

Methodedetails

BuildMcpServerUrl(string, IConfigurationProvider<ToolingConfiguration>)

Waarschuwing

Deze API is nu afgeschaft.

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

Bouw de volledige URL voor toegang tot een specifieke MCP-server.

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

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

Parameters

serverName

string

De naam van de MCP-serverresource.

configProvider

IConfigurationProvider<ToolingConfiguration>

Optionele configuratieprovider. Standaard ingesteld op defaultToolingConfigurationProvider.

Retouren

string

De volledig gekwalificeerde MCP-server-URL, inclusief afsluitende slash.

GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)

Waarschuwing

Deze API is nu afgeschaft.

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

Hiermee wordt de eindpunt-URL samengesteld voor het verzenden van chatgeschiedenis naar het MCP-platform voor realtime bedreigingsbeveiliging.

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

Parameters

configProvider

IConfigurationProvider<ToolingConfiguration>

Optionele configuratieprovider. Standaard ingesteld op defaultToolingConfigurationProvider.

Retouren

string

Een absolute URL die hulpprogramma-onderdelen kunnen gebruiken om chatberichten te verzenden of op te halen voor realtime-scenario's voor bedreigingsbeveiliging.

Opmerkingen

Roep deze methode aan bij het samenstellen van HTTP-aanvragen die toegang moeten hebben tot de chat-berichtgeschiedenis voor realtime-bedreigingsbeveiliging. De geretourneerde URL bevat al het basisadres van het MCP-platform en het vaste padsegment /agents/real-time-threat-protection/chat-message.

GetMcpBaseUrl(IConfigurationProvider<ToolingConfiguration>)

Waarschuwing

Deze API is nu afgeschaft.

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

Haal de basis-URL op die wordt gebruikt om query's uit te voeren op MCP-omgevingen.

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

Parameters

configProvider

IConfigurationProvider<ToolingConfiguration>

Optionele configuratieprovider. Standaard ingesteld op defaultToolingConfigurationProvider.

Retouren

string

De URL van de MCP-basisomgeving.

GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)

Waarschuwing

Deze API is nu afgeschaft.

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

Maak de URL van de tooling-gateway voor een bepaalde agentidentiteit. Dit eindpunt wordt gebruikt om MCP-servers te detecteren die zijn gekoppeld aan de opgegeven agentidentiteit.

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

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

Parameters

agenticAppId

string

De unieke id voor de agent-id.

configProvider

IConfigurationProvider<ToolingConfiguration>

Optionele configuratieprovider. Standaard ingesteld op defaultToolingConfigurationProvider.

Retouren

string

Een volledig gekwalificeerde URL die verwijst naar de tooling-gateway voor de agent.

GetToolRequestHeaders(string, TurnContext, ToolOptions)

Standaardheaders opstellen voor MCP-hulpprogrammaaanvragen. Bevat het Bearer-token voor autorisatie wanneer deze is opgegeven en bevat eventueel kanaal- en subkanaal-id's voor routering.

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

Parameters

authToken

string

Bearer-token voor autorisatieheader.

turnContext
TurnContext

Optioneel TurnContext-object waaruit kanaal- en subkanaal-id's worden geëxtraheerd.

options
ToolOptions

Optioneel ToolOptions-object voor aanvullende aanvraagconfiguratie.

Retouren

Record<string, string>

Een headersrecord die geschikt is voor HTTP-aanvragen.

ValidateAuthToken(undefined | string)

Hiermee valideert u een JWT-verificatietoken. Controleert of het token een geldige JWT is en niet is verlopen.

static function ValidateAuthToken(authToken: undefined | string)

Parameters

authToken

undefined | string

Het JWT-token dat moet worden gevalideerd.