Utility class
Eigenschaften
| HEADER_AGENT_ID | Headername zum Senden der Agent-ID an die MCP-Plattform für Protokollierung/Analyse. |
| HEADER_CHANNEL_ID | |
| HEADER_SUBCHANNEL_ID | |
| HEADER_USER_AGENT |
Methoden
| Build |
Erstellen Sie die vollständige URL für den Zugriff auf einen bestimmten MCP-Server. Beispiel: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/" |
| Get |
Erstellt die Endpunkt-URL zum Senden des Chatverlaufs an die MCP-Plattform für den Echtzeit-Bedrohungsschutz. |
| Get |
Rufen Sie die Basis-URL ab, die zum Abfragen von MCP-Umgebungen verwendet wird. |
| Get |
Erstellen Sie die Toolgateway-URL für eine bestimmte Agent-Identität. Dieser Endpunkt wird verwendet, um MCP-Server zu ermitteln, die der angegebenen Agentidentität zugeordnet sind. Beispiel: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/{agenticAppId}/mcpServers" |
| Get |
Verfassen Sie Standardheader für MCP-Toolanforderungen. Enthält das Autorisierungs bearertoken, wenn angegeben, und optional kanal- und subchannel identifiers for routing. |
| Validate |
Überprüft ein JWT-Authentifizierungstoken. Überprüft, ob das Token ein gültiges JWT ist und nicht abgelaufen ist. |
Details zur Eigenschaft
HEADER_AGENT_ID
Headername zum Senden der Agent-ID an die MCP-Plattform für Protokollierung/Analyse.
static HEADER_AGENT_ID: "x-ms-agentid" = "x-ms-agentid"Eigenschaftswert
"x-ms-agentid"
HEADER_CHANNEL_ID
static HEADER_CHANNEL_ID: "x-ms-channel-id" = "x-ms-channel-id"Eigenschaftswert
"x-ms-channel-id"
HEADER_SUBCHANNEL_ID
static HEADER_SUBCHANNEL_ID: "x-ms-subchannel-id" = "x-ms-subchannel-id"Eigenschaftswert
"x-ms-subchannel-id"
HEADER_USER_AGENT
static HEADER_USER_AGENT: "User-Agent" = "User-Agent"Eigenschaftswert
"User-Agent"
Details zur Methode
BuildMcpServerUrl(string, IConfigurationProvider<ToolingConfiguration>)
Warnung
Diese API ist nun veraltet.
This method is for internal use only. Use McpToolServerConfigurationService instead.
Erstellen Sie die vollständige URL für den Zugriff auf einen bestimmten MCP-Server.
Beispiel: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/"
static function BuildMcpServerUrl(serverName: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParameter
- serverName
-
string
Der NAME der MCP-Serverressource.
- configProvider
Optionaler Konfigurationsanbieter. Standardwert ist "defaultToolingConfigurationProvider".
Gibt zurück
string
Die vollqualifizierte MCP-Server-URL einschließlich nachgestellter Schrägstriche.
GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)
Warnung
Diese API ist nun veraltet.
This method is for internal use only. Use McpToolServerConfigurationService.sendChatHistory() instead.
Erstellt die Endpunkt-URL zum Senden des Chatverlaufs an die MCP-Plattform für den Echtzeit-Bedrohungsschutz.
static function GetChatHistoryEndpoint(configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParameter
- configProvider
Optionaler Konfigurationsanbieter. Standardwert ist "defaultToolingConfigurationProvider".
Gibt zurück
string
Eine absolute URL, mit der Komponenten zum Senden oder Abrufen von Chatnachrichten für Szenarien zum Schutz vor Bedrohungen in Echtzeit verwendet werden können.
Hinweise
Rufen Sie diese Methode beim Erstellen von HTTP-Anforderungen auf, die für den Zugriff auf den Chatnachrichtenverlauf für den Echtzeit-Bedrohungsschutz erforderlich sind. Die zurückgegebene URL enthält bereits die MCP-Plattformbasisadresse und das Segment "Fester Pfad" /agents/real-time-threat-protection/chat-message.
GetMcpBaseUrl(IConfigurationProvider<ToolingConfiguration>)
Warnung
Diese API ist nun veraltet.
This method is for internal use only. Use McpToolServerConfigurationService instead.
Rufen Sie die Basis-URL ab, die zum Abfragen von MCP-Umgebungen verwendet wird.
static function GetMcpBaseUrl(configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParameter
- configProvider
Optionaler Konfigurationsanbieter. Standardwert ist "defaultToolingConfigurationProvider".
Gibt zurück
string
Die URL der MCP-Basisumgebungen.
GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)
Warnung
Diese API ist nun veraltet.
This method is for internal use only. Use McpToolServerConfigurationService.listToolServers() instead.
Erstellen Sie die Toolgateway-URL für eine bestimmte Agent-Identität. Dieser Endpunkt wird verwendet, um MCP-Server zu ermitteln, die der angegebenen Agentidentität zugeordnet sind.
Beispiel: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/{agenticAppId}/mcpServers"
static function GetToolingGatewayForDigitalWorker(agenticAppId: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParameter
- agenticAppId
-
string
Der eindeutige Bezeichner für die Agent-Identität.
- configProvider
Optionaler Konfigurationsanbieter. Standardwert ist "defaultToolingConfigurationProvider".
Gibt zurück
string
Eine vollqualifizierte URL, die auf das Toolgateway für den Agent verweist.
GetToolRequestHeaders(string, TurnContext, ToolOptions)
Verfassen Sie Standardheader für MCP-Toolanforderungen. Enthält das Autorisierungs bearertoken, wenn angegeben, und optional kanal- und subchannel identifiers for routing.
static function GetToolRequestHeaders(authToken?: string, turnContext?: TurnContext, options?: ToolOptions): Record<string, string>Parameter
- authToken
-
string
Bearertoken für Autorisierungsheader.
- turnContext
- TurnContext
Optionales TurnContext-Objekt, aus dem Kanal- und Unterkanal-IDs extrahiert werden.
- options
- ToolOptions
Optionales ToolOptions-Objekt für zusätzliche Anforderungskonfiguration.
Gibt zurück
Record<string, string>
Ein Headerdatensatz, der für HTTP-Anforderungen geeignet ist.
ValidateAuthToken(undefined | string)
Überprüft ein JWT-Authentifizierungstoken. Überprüft, ob das Token ein gültiges JWT ist und nicht abgelaufen ist.
static function ValidateAuthToken(authToken: undefined | string)Parameter
- authToken
-
undefined | string
Das zu überprüfende JWT-Token.