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 — явная переменная пакета SDK для Python, используемая в текущих примерах.
  2. ENVIRONMENT — устаревшая переменная пакета SDK для Python (обратная совместимость).
  3. ASPNETCORE_ENVIRONMENT — соглашение о размещении Azure.
  4. DOTNET_ENVIRONMENT — соглашение универсального узла.
  5. Значение по умолчанию, "Development" если ни одно из указанных выше значений не задано.

PYTHON_ENVIRONMENT и ENVIRONMENT сначала проверяется, чтобы агенты, явно заданные ENVIRONMENT=Production не затрагивались, если узел также задает ASPNETCORE_ENVIRONMENT.

is_development_environment() -> bool

Возвращаемое значение

Тип Описание
bool

True, если разрешенная среда имеет значение development (без учета регистра).

resolve_token_scope_for_server

Устраните область OAuth, чтобы запросить заданный сервер MCP.

Серверы версии 2 содержат собственную аудиторию в audience поле (форма GUID или api:// URI). Если указан явный scope объект (например"Tools.ListInvoke.All", область).{audience}/{scope} Если область отсутствует, {audience}/.default используется (используется предварительно предоставленная область). Серверы версии 1 (без аудитории, аудитория равно общему идентификатору APPG в форме 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".