Utility class
الخصائص
| HEADER_AGENT_ID | اسم العنوان لإرسال معرف العامل إلى النظام الأساسي ل MCP للتسجيل/التحليلات. |
| HEADER_CHANNEL_ID | |
| HEADER_SUBCHANNEL_ID | |
| HEADER_USER_AGENT |
الأساليب
| Build |
إنشاء عنوان URL الكامل للوصول إلى خادم MCP معين. مثال: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/" |
| Get |
إنشاء عنوان URL لنقطة النهاية لإرسال محفوظات الدردشة إلى النظام الأساسي ل MCP للحماية من التهديدات في الوقت الفعلي. |
| Get |
احصل على عنوان URL الأساسي المستخدم للاستعلام عن بيئات MCP. |
| Get |
إنشاء عنوان URL لبوابة الأدوات لهوية عامل معين. يتم استخدام نقطة النهاية هذه لاكتشاف خوادم MCP المقترنة بهوية العامل المحددة. مثال: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers" |
| Get |
إنشاء عناوين قياسية لطلبات أدوات MCP. يتضمن رمز حامل التخويل عند توفيره، ويتضمن اختياريا معرفات القناة والقنوات الفرعية للتوجيه. |
| Validate |
التحقق من صحة رمز مصادقة JWT المميز. التحقق من أن الرمز المميز هو JWT صالح ولم تنته صلاحيته. |
تفاصيل الخاصية
HEADER_AGENT_ID
اسم العنوان لإرسال معرف العامل إلى النظام الأساسي ل MCP للتسجيل/التحليلات.
static HEADER_AGENT_ID: "x-ms-agentid" = "x-ms-agentid"قيمة الخاصية
"x-ms-agentid"
HEADER_CHANNEL_ID
static HEADER_CHANNEL_ID: "x-ms-channel-id" = "x-ms-channel-id"قيمة الخاصية
"x-ms-channel-id"
HEADER_SUBCHANNEL_ID
static HEADER_SUBCHANNEL_ID: "x-ms-subchannel-id" = "x-ms-subchannel-id"قيمة الخاصية
"x-ms-subchannel-id"
HEADER_USER_AGENT
static HEADER_USER_AGENT: "User-Agent" = "User-Agent"قيمة الخاصية
"User-Agent"
تفاصيل الأسلوب
BuildMcpServerUrl(string, IConfigurationProvider<ToolingConfiguration>)
تحذير
واجهة برمجة التطبيقات هذه مهملة الآن.
This method is for internal use only. Use McpToolServerConfigurationService instead.
إنشاء عنوان URL الكامل للوصول إلى خادم MCP معين.
مثال: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/"
static function BuildMcpServerUrl(serverName: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): stringالمعلمات
- serverName
-
string
اسم مورد خادم MCP.
- configProvider
موفر التكوين الاختياري. الإعدادات الافتراضية ل defaultToolingConfigurationProvider.
المرتجعات
string
عنوان URL لخادم MCP المؤهل بالكامل بما في ذلك الشرطة المائلة اللاحقة.
GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)
تحذير
واجهة برمجة التطبيقات هذه مهملة الآن.
This method is for internal use only. Use McpToolServerConfigurationService.sendChatHistory() instead.
إنشاء عنوان URL لنقطة النهاية لإرسال محفوظات الدردشة إلى النظام الأساسي ل MCP للحماية من التهديدات في الوقت الفعلي.
static function GetChatHistoryEndpoint(configProvider?: IConfigurationProvider<ToolingConfiguration>): stringالمعلمات
- configProvider
موفر التكوين الاختياري. الإعدادات الافتراضية ل defaultToolingConfigurationProvider.
المرتجعات
string
عنوان URL مطلق يمكن لمكونات الأدوات استخدامه لإرسال رسائل الدردشة أو استردادها لسيناريوهات الحماية من التهديدات في الوقت الفعلي.
الملاحظات
استدعاء هذا الأسلوب عند إنشاء طلبات HTTP التي تحتاج إلى الوصول إلى محفوظات رسائل الدردشة للحماية من التهديدات في الوقت الحقيقي. يتضمن عنوان URL الذي تم إرجاعه بالفعل العنوان الأساسي للنظام الأساسي MCP ومقطع /agents/real-time-threat-protection/chat-messageالمسار الثابت .
GetMcpBaseUrl(IConfigurationProvider<ToolingConfiguration>)
تحذير
واجهة برمجة التطبيقات هذه مهملة الآن.
This method is for internal use only. Use McpToolServerConfigurationService instead.
احصل على عنوان URL الأساسي المستخدم للاستعلام عن بيئات MCP.
static function GetMcpBaseUrl(configProvider?: IConfigurationProvider<ToolingConfiguration>): stringالمعلمات
- configProvider
موفر التكوين الاختياري. الإعدادات الافتراضية ل defaultToolingConfigurationProvider.
المرتجعات
string
عنوان URL لبيئات MCP الأساسية.
GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)
تحذير
واجهة برمجة التطبيقات هذه مهملة الآن.
This method is for internal use only. Use McpToolServerConfigurationService.listToolServers() instead.
إنشاء عنوان URL لبوابة الأدوات لهوية عامل معين. يتم استخدام نقطة النهاية هذه لاكتشاف خوادم MCP المقترنة بهوية العامل المحددة.
مثال: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers"
static function GetToolingGatewayForDigitalWorker(agenticAppId: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): stringالمعلمات
- agenticAppId
-
string
المعرف الفريد لهوية العامل.
- configProvider
موفر التكوين الاختياري. الإعدادات الافتراضية ل defaultToolingConfigurationProvider.
المرتجعات
string
عنوان URL مؤهل بالكامل يشير إلى بوابة الأدوات للعامل.
GetToolRequestHeaders(string, TurnContext, ToolOptions)
إنشاء عناوين قياسية لطلبات أدوات MCP. يتضمن رمز حامل التخويل عند توفيره، ويتضمن اختياريا معرفات القناة والقنوات الفرعية للتوجيه.
static function GetToolRequestHeaders(authToken?: string, turnContext?: TurnContext, options?: ToolOptions): Record<string, string>المعلمات
- authToken
-
string
الرمز المميز للحامل لعنوان التخويل.
- turnContext
- TurnContext
عنصر TurnContext الاختياري الذي يتم استخراج معرفات القناة والقنوات الفرعية منه.
- options
- ToolOptions
كائن ToolOptions الاختياري لتكوين طلب إضافي.
المرتجعات
Record<string, string>
سجل عناوين مناسب لطلبات HTTP.
ValidateAuthToken(undefined | string)
التحقق من صحة رمز مصادقة JWT المميز. التحقق من أن الرمز المميز هو JWT صالح ولم تنته صلاحيته.
static function ValidateAuthToken(authToken: undefined | string)المعلمات
- authToken
-
undefined | string
رمز JWT المميز للتحقق من صحته.