utility الوحدة النمطية

يوفر وظائف الأداة لمكونات الأدوات.

الوظائف

build_mcp_server_url

إنشاء عنوان URL الكامل لخادم MCP باستخدام عنوان URL الأساسي واسم الخادم.

build_mcp_server_url(server_name: str) -> str

المعلمات

الاسم	الوصف
server_name مطلوب	str اسم خادم MCP.

المرتجعات

النوع	الوصف
str	عنوان URL الكامل لخادم MCP.

get_chat_history_endpoint

يحصل على عنوان URL لنقطة نهاية محفوظات الدردشة لإرسال محفوظات الدردشة إلى النظام الأساسي ل MCP.

get_chat_history_endpoint() -> str

المرتجعات

النوع	الوصف
str	عنوان URL لنقطة نهاية محفوظات الدردشة.

get_mcp_base_url

يحصل على عنوان URL الأساسي لخوادم MCP.

get_mcp_base_url() -> str

المرتجعات

النوع	الوصف
str	عنوان URL الأساسي لخوادم MCP.

get_mcp_platform_authentication_scope

الحصول على نطاق مصادقة النظام الأساسي MCP.

get_mcp_platform_authentication_scope() -> list[str]

المرتجعات

النوع	الوصف
list[str]	قائمة تحتوي على نطاق مصادقة النظام الأساسي MCP المناسب.

get_tooling_gateway_for_digital_worker

يحصل على عنوان URL لبوابة الأدوات للعامل الرقمي المحدد.

get_tooling_gateway_for_digital_worker(agentic_app_id: str) -> str

المعلمات

الاسم	الوصف
agentic_app_id مطلوب	str معرف التطبيق العامل للعامل الرقمي.

المرتجعات

النوع	الوصف
str	عنوان URL لبوابة الأدوات للعامل الرقمي.

is_development_environment

إرجاع True إذا تم تكوين البيئة الحالية كتطوير.

ترتيب الدقة (أول قيمة غير فارغة تفوز):

1. PYTHON_ENVIRONMENT — متغير Python SDK الصريح المستخدم في العينات الحالية.
2. ENVIRONMENT — متغير Python SDK القديم (التوافق مع الإصدارات السابقة).
3. ASPNETCORE_ENVIRONMENT — اصطلاح استضافة Azure.
4. DOTNET_ENVIRONMENT — اصطلاح المضيف العام.
5. يتم تعيين الإعدادات الافتراضية إلى "Development" عندما لا يتم تعيين أي مما سبق.

PYTHON_ENVIRONMENT ENVIRONMENT ويتم التحقق أولا بحيث لا تتأثر العوامل التي تم تعيينها ENVIRONMENT=Production بشكل صريح إذا كانت عملية المضيف تعين ASPNETCORE_ENVIRONMENTأيضا .

is_development_environment() -> bool

المرتجعات

النوع	الوصف
bool	صحيح عندما تكون البيئة التي تم حلها "تطوير" (غير حساسة لحالة الأحرف).

resolve_token_scope_for_server

حل نطاق OAuth لطلب خادم MCP معين.

تحمل خوادم V2 جمهورها الخاص في audience الحقل (نموذج GUID أو api:// URI المجرد). عند توفير صريح scope (على سبيل المثال "Tools.ListInvoke.All")، يكون النطاق هو {audience}/{scope}. عندما يكون النطاق غير موجود، {audience}/.default يتم استخدامه (يعتمد على النطاقات التي تمت الموافقة عليها مسبقا). خوادم V1 (بدون جمهور، الجمهور يساوي ATG AppId المشترك في نموذج GUID أو api:// URI) دائما ما تعود إلى نطاق ATG /.default المشترك.

resolve_token_scope_for_server(server: MCPServerConfig) -> str

المعلمات

الاسم	الوصف
server مطلوب	MCPServerConfig تكوين خادم MCP لحل النطاق ل.

المرتجعات

النوع	الوصف
str	سلسلة نطاق OAuth، على سبيل المثال "<guid>/Tools.ListInvoke.All"، أو "api://<guid>/.default"، أو ATG "<atg-guid>/.default"المشتركة .