utility Módulo

Fornece funções de utilitário 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

Nome Description
server_name
Obrigatório
str

O nome do servidor MCP.

Retornos

Tipo Description
str

A URL completa do servidor MCP.

get_chat_history_endpoint

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

get_chat_history_endpoint() -> str

Retornos

Tipo Description
str

A URL do ponto de extremidade do histórico de chat.

get_mcp_base_url

Obtém a URL base para servidores MCP.

get_mcp_base_url() -> str

Retornos

Tipo Description
str

A URL base para servidores MCP.

get_mcp_platform_authentication_scope

Obtém o escopo de autenticação da plataforma MCP.

get_mcp_platform_authentication_scope() -> list[str]

Retornos

Tipo Description
list[str]

Uma lista que contém o escopo de autenticação da plataforma MCP apropriado.

get_tooling_gateway_for_digital_worker

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

get_tooling_gateway_for_digital_worker(agentic_app_id: str) -> str

Parâmetros

Nome Description
agentic_app_id
Obrigatório
str

O identificador de aplicativo agente do trabalho digital.

Retornos

Tipo Description
str

A URL do gateway de ferramentas para o trabalho digital.

is_development_environment

Retorna True 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 do Python usada em exemplos atuais.
  2. ENVIRONMENT — variável herdada do SDK do Python (compatibilidade com versões anteriores).
  3. ASPNETCORE_ENVIRONMENT — Convenção de hospedagem do Azure.
  4. DOTNET_ENVIRONMENT — convenção de host genérico.
  5. O padrão é "Development" quando nenhuma das opções acima é definida.

PYTHON_ENVIRONMENT e ENVIRONMENT são verificados primeiro para que os agentes definidos explicitamente ENVIRONMENT=Production não sejam afetados se um processo de host também definir ASPNETCORE_ENVIRONMENT.

is_development_environment() -> bool

Retornos

Tipo Description
bool

True quando o ambiente resolvido é "desenvolvimento" (não diferencia maiúsculas de minúsculas).

resolve_token_scope_for_server

Resolva o escopo OAuth para solicitar um determinado servidor MCP.

Os servidores V2 carregam seu próprio público-alvo no audience campo (formulário GUID ou api:// URI nu). Quando um explícito scope é fornecido (por exemplo "Tools.ListInvoke.All"), o escopo é {audience}/{scope}. Quando o escopo está ausente, {audience}/.default é usado (depende de escopos pré-consentidos). Os servidores V1 (sem audiência, o público-alvo é igual ao ATG AppId compartilhado no formato GUID ou api:// URI nu) sempre retornam ao escopo de ATG /.default compartilhado.

resolve_token_scope_for_server(server: MCPServerConfig) -> str

Parâmetros

Nome Description
server
Obrigatório
MCPServerConfig

A configuração do servidor MCP para a qual resolver o escopo.

Retornos

Tipo Description
str

A cadeia de caracteres de escopo OAuth, por exemplo "<guid>/Tools.ListInvoke.All", "api://<guid>/.default"ou o ATG "<atg-guid>/.default"compartilhado.