utility Módulo

Fornece funções utilitárias para os componentes de ferramentas.

Funções

build_mcp_server_url

Constrói a URL completa do servidor MCP usando a URL base e o nome do servidor.

build_mcp_server_url(server_name: str) -> str

Parâmetros

Name	Description
server_name Necessário	str O nome do servidor MCP.

Devoluções

Tipo	Description
str	O URL completo do servidor MCP.

get_chat_history_endpoint

Obtém o URL do endpoint do histórico de chat para enviar o histórico de chat para a plataforma MCP.

get_chat_history_endpoint() -> str

Devoluções

Tipo	Description
str	O URL do endpoint do histórico de chat.

get_mcp_base_url

Obtém o URL base dos servidores MCP.

get_mcp_base_url() -> str

Devoluções

Tipo	Description
str	A URL base para servidores MCP.

get_mcp_platform_authentication_scope

Recebe o âmbito de autenticação da plataforma MCP.

get_mcp_platform_authentication_scope() -> list[str]

Devoluções

Tipo	Description
list[str]	Uma lista contendo o âmbito de autenticação da plataforma MCP apropriado.

get_tooling_gateway_for_digital_worker

Obtém o URL do gateway de ferramentas para o trabalhador digital especificado.

get_tooling_gateway_for_digital_worker(agentic_app_id: str) -> str

Parâmetros

Name	Description
agentic_app_id Necessário	str O identificador agente da aplicação do trabalhador digital.

Devoluções

Tipo	Description
str	A URL do gateway de ferramentas para o trabalhador digital.

is_development_environment

Retorna Verdadeiro se o ambiente atual estiver configurado como desenvolvimento.

Ordem de resolução (o primeiro valor não vazio vence):

1. PYTHON_ENVIRONMENT — variável explícita do SDK em Python usada em amostras atuais.
2. ENVIRONMENT — variável legada do SDK Python (compatibilidade retroativa).
3. ASPNETCORE_ENVIRONMENT — Azure hosting convention.
4. DOTNET_ENVIRONMENT — convenção de apresentadores genéricos.
5. Por defeito, quando "Development" nenhuma das opções acima está definida.

PYTHON_ENVIRONMENT e ENVIRONMENT são verificados primeiro para que agentes que explicitamente definam ENVIRONMENT=Production não sejam afetados se um processo anfitrião também define ASPNETCORE_ENVIRONMENT.

is_development_environment() -> bool

Devoluções

Tipo	Description
bool	É verdade quando o ambiente resolvido é "desenvolvimento" (indistinto a maiúsculas).

resolve_token_scope_for_server

Resolve o âmbito OAuth para pedir um dado servidor MCP.

Os servidores V2 transportam o seu próprio público no audience terreno (GUID ou api:// URI nu). Quando é fornecido um explícito scope (por exemplo, "Tools.ListInvoke.All"), o âmbito é {audience}/{scope}. Quando o âmbito está ausente, {audience}/.default é usado (depende dos âmbios previamente consentidos). Servidores V1 (sem audiência, audiência igual ao AppId ATG partilhado em forma GUID ou api:// URI nua) recorrem sempre ao âmbito ATG /.default partilhado.

resolve_token_scope_for_server(server: MCPServerConfig) -> str

Parâmetros

Name	Description
server Necessário	MCPServerConfig A configuração do servidor MCP para resolver o âmbito para.

Devoluções

Tipo	Description
str	A cadeia de escopos OAuth, por exemplo "<guid>/Tools.ListInvoke.All", "api://<guid>/.default", ou a ATG "<atg-guid>/.default"partilhada .