utility מודול

פונקציות כלי שירות עבור רכיבי Tooling.

פונקציות

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".