utility Módulo

Proporciona funciones de utilidad para los componentes de herramientas.

Funciones

build_mcp_server_url

Construye la dirección URL completa del servidor MCP mediante la dirección URL base y el nombre del servidor.

build_mcp_server_url(server_name: str) -> str

Parámetros

Nombre Description
server_name
Requerido
str

Nombre del servidor MCP.

Devoluciones

Tipo Description
str

Dirección URL completa del servidor MCP.

get_chat_history_endpoint

Obtiene la dirección URL del punto de conexión del historial de chat para enviar el historial de chat a la plataforma MCP.

get_chat_history_endpoint() -> str

Devoluciones

Tipo Description
str

Dirección URL del punto de conexión del historial de chat.

get_mcp_base_url

Obtiene la dirección URL base de los servidores MCP.

get_mcp_base_url() -> str

Devoluciones

Tipo Description
str

Dirección URL base de los servidores MCP.

get_mcp_platform_authentication_scope

Obtiene el ámbito de autenticación de la plataforma MCP.

get_mcp_platform_authentication_scope() -> list[str]

Devoluciones

Tipo Description
list[str]

Lista que contiene el ámbito de autenticación de la plataforma MCP adecuado.

get_tooling_gateway_for_digital_worker

Obtiene la dirección URL de la puerta de enlace de herramientas para el trabajo digital especificado.

get_tooling_gateway_for_digital_worker(agentic_app_id: str) -> str

Parámetros

Nombre Description
agentic_app_id
Requerido
str

Identificador de la aplicación agente del trabajo digital.

Devoluciones

Tipo Description
str

Dirección URL de la puerta de enlace de herramientas para el trabajo digital.

is_development_environment

Devuelve True si el entorno actual está configurado como desarrollo.

Orden de resolución (el primer valor no vacío gana):

  1. PYTHON_ENVIRONMENT : variable explícita del SDK de Python que se usa en los ejemplos actuales.
  2. ENVIRONMENT : variable heredada del SDK de Python (compatibilidad con versiones anteriores).
  3. ASPNETCORE_ENVIRONMENT — Convención de hospedaje de Azure.
  4. DOTNET_ENVIRONMENT : convención de host genérico.
  5. El valor predeterminado es "Development" cuando no se establece ninguna de las opciones anteriores.

PYTHON_ENVIRONMENT y ENVIRONMENT se comprueban primero para que los agentes que se establezcan ENVIRONMENT=Production explícitamente no se vean afectados si un proceso de host también establece ASPNETCORE_ENVIRONMENT.

is_development_environment() -> bool

Devoluciones

Tipo Description
bool

True cuando el entorno resuelto es "desarrollo" (no distingue mayúsculas de minúsculas).

resolve_token_scope_for_server

Resuelva el ámbito de OAuth para solicitar un servidor MCP determinado.

Los servidores V2 llevan su propia audiencia en el audience campo (formulario de GUID o api:// URI sin sistema operativo). Cuando se proporciona un explícito scope (por ejemplo "Tools.ListInvoke.All", ), el ámbito es {audience}/{scope}. Cuando el ámbito está ausente, {audience}/.default se usa (se basa en ámbitos con consentimiento previo). Los servidores V1 (sin audiencia, el público es igual al appId de ATG compartido en forma de GUID o api:// URI sin sistema operativo) siempre se revierten al ámbito de ATG /.default compartido.

resolve_token_scope_for_server(server: MCPServerConfig) -> str

Parámetros

Nombre Description
server
Requerido
MCPServerConfig

Configuración del servidor MCP para la que se va a resolver el ámbito.

Devoluciones

Tipo Description
str

La cadena de ámbito de OAuth, por ejemplo "<guid>/Tools.ListInvoke.All", , "api://<guid>/.default"o el ATG "<atg-guid>/.default"compartido.