Utility class
Özellikler
| HEADER_AGENT_ID | Aracı tanımlayıcısını günlüğe kaydetme/analiz için MCP platformuna göndermeye yönelik üst bilgi adı. |
| HEADER_CHANNEL_ID | |
| HEADER_SUBCHANNEL_ID | |
| HEADER_USER_AGENT |
Yöntemler
| Build |
Belirli bir MCP sunucusuna erişmek için tam URL'yi oluşturun. Örnek: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/" |
| Get |
Gerçek zamanlı tehdit koruması için SOHBET geçmişini MCP platformuna göndermek için uç nokta URL'sini oluşturur. |
| Get |
MCP ortamlarını sorgulamak için kullanılan temel URL'yi alın. |
| Get |
Belirli bir aracı kimliği için araç ağ geçidi URL'sini oluşturma. Bu uç nokta, belirtilen aracı kimliğiyle ilişkili MCP sunucularını bulmak için kullanılır. Örnek: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers" |
| Get |
MCP araç istekleri için standart üst bilgiler oluşturun. Sağlandığında Yetkilendirme taşıyıcı belirtecini ve isteğe bağlı olarak yönlendirme için kanal ve alt kanal tanımlayıcılarını içerir. |
| Validate |
JWT kimlik doğrulama belirtecini doğrular. Belirtecin geçerli bir JWT olduğunu ve süresinin dolmadığını denetler. |
Özellik Ayrıntıları
HEADER_AGENT_ID
Aracı tanımlayıcısını günlüğe kaydetme/analiz için MCP platformuna göndermeye yönelik üst bilgi adı.
static HEADER_AGENT_ID: "x-ms-agentid" = "x-ms-agentid"Özellik Değeri
"x-ms-agentid"
HEADER_CHANNEL_ID
static HEADER_CHANNEL_ID: "x-ms-channel-id" = "x-ms-channel-id"Özellik Değeri
"x-ms-channel-id"
HEADER_SUBCHANNEL_ID
static HEADER_SUBCHANNEL_ID: "x-ms-subchannel-id" = "x-ms-subchannel-id"Özellik Değeri
"x-ms-subchannel-id"
HEADER_USER_AGENT
static HEADER_USER_AGENT: "User-Agent" = "User-Agent"Özellik Değeri
"User-Agent"
Yöntem Ayrıntıları
BuildMcpServerUrl(string, IConfigurationProvider<ToolingConfiguration>)
Uyarı
Bu API artık kullanım dışıdır.
This method is for internal use only. Use McpToolServerConfigurationService instead.
Belirli bir MCP sunucusuna erişmek için tam URL'yi oluşturun.
Örnek: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/"
static function BuildMcpServerUrl(serverName: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParametreler
- serverName
-
string
MCP sunucusu kaynak adı.
- configProvider
İsteğe bağlı yapılandırma sağlayıcısı. Defaults to defaultToolingConfigurationProvider.
Döndürülenler
string
Sondaki eğik çizgi de dahil olmak üzere tam MCP sunucusu URL'si.
GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)
Uyarı
Bu API artık kullanım dışıdır.
This method is for internal use only. Use McpToolServerConfigurationService.sendChatHistory() instead.
Gerçek zamanlı tehdit koruması için SOHBET geçmişini MCP platformuna göndermek için uç nokta URL'sini oluşturur.
static function GetChatHistoryEndpoint(configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParametreler
- configProvider
İsteğe bağlı yapılandırma sağlayıcısı. Defaults to defaultToolingConfigurationProvider.
Döndürülenler
string
Araç bileşenlerinin gerçek zamanlı tehdit koruması senaryoları için sohbet iletileri göndermek veya almak için kullanabileceği mutlak bir URL.
Açıklamalar
Gerçek zamanlı tehdit koruması için sohbet iletisi geçmişine erişmesi gereken HTTP istekleri oluştururken bu yöntemi çağırın. Döndürülen URL zaten MCP platformu temel adresini ve sabit yol kesimini /agents/real-time-threat-protection/chat-messageiçerir.
GetMcpBaseUrl(IConfigurationProvider<ToolingConfiguration>)
Uyarı
Bu API artık kullanım dışıdır.
This method is for internal use only. Use McpToolServerConfigurationService instead.
MCP ortamlarını sorgulamak için kullanılan temel URL'yi alın.
static function GetMcpBaseUrl(configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParametreler
- configProvider
İsteğe bağlı yapılandırma sağlayıcısı. Defaults to defaultToolingConfigurationProvider.
Döndürülenler
string
Temel MCP ortamları URL'si.
GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)
Uyarı
Bu API artık kullanım dışıdır.
This method is for internal use only. Use McpToolServerConfigurationService.listToolServers() instead.
Belirli bir aracı kimliği için araç ağ geçidi URL'sini oluşturma. Bu uç nokta, belirtilen aracı kimliğiyle ilişkili MCP sunucularını bulmak için kullanılır.
Örnek: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers"
static function GetToolingGatewayForDigitalWorker(agenticAppId: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): stringParametreler
- agenticAppId
-
string
Aracı kimliği için benzersiz tanımlayıcı.
- configProvider
İsteğe bağlı yapılandırma sağlayıcısı. Defaults to defaultToolingConfigurationProvider.
Döndürülenler
string
Aracı için araç ağ geçidini gösteren tam url.
GetToolRequestHeaders(string, TurnContext, ToolOptions)
MCP araç istekleri için standart üst bilgiler oluşturun. Sağlandığında Yetkilendirme taşıyıcı belirtecini ve isteğe bağlı olarak yönlendirme için kanal ve alt kanal tanımlayıcılarını içerir.
static function GetToolRequestHeaders(authToken?: string, turnContext?: TurnContext, options?: ToolOptions): Record<string, string>Parametreler
- authToken
-
string
Yetkilendirme üst bilgisi için taşıyıcı belirteci.
- turnContext
- TurnContext
Kanal ve alt kanal kimliklerinin ayıklandığı isteğe bağlı TurnContext nesnesi.
- options
- ToolOptions
Ek istek yapılandırması için isteğe bağlı ToolOptions nesnesi.
Döndürülenler
Record<string, string>
HTTP istekleri için uygun bir üst bilgi kaydı.
ValidateAuthToken(undefined | string)
JWT kimlik doğrulama belirtecini doğrular. Belirtecin geçerli bir JWT olduğunu ve süresinin dolmadığını denetler.
static function ValidateAuthToken(authToken: undefined | string)Parametreler
- authToken
-
undefined | string
Doğrulanması gereken JWT belirteci.