utility Modulo

Fornisce funzioni di utilità per i componenti degli strumenti.

Funzioni

build_mcp_server_url

Costruisce l'URL completo del server MCP usando l'URL di base e il nome del server.

build_mcp_server_url(server_name: str) -> str

Parametri

Nome Descrizione
server_name
Necessario
str

Nome del server MCP.

Valori restituiti

Tipo Descrizione
str

URL completo del server MCP.

get_chat_history_endpoint

Ottiene l'URL dell'endpoint della cronologia chat per l'invio della cronologia delle chat alla piattaforma MCP.

get_chat_history_endpoint() -> str

Valori restituiti

Tipo Descrizione
str

URL dell'endpoint della cronologia delle chat.

get_mcp_base_url

Ottiene l'URL di base per i server MCP.

get_mcp_base_url() -> str

Valori restituiti

Tipo Descrizione
str

URL di base per i server MCP.

get_mcp_platform_authentication_scope

Ottiene l'ambito di autenticazione della piattaforma MCP.

get_mcp_platform_authentication_scope() -> list[str]

Valori restituiti

Tipo Descrizione
list[str]

Elenco contenente l'ambito di autenticazione della piattaforma MCP appropriato.

get_tooling_gateway_for_digital_worker

Ottiene l'URL del gateway di strumenti per il ruolo di lavoro digitale specificato.

get_tooling_gateway_for_digital_worker(agentic_app_id: str) -> str

Parametri

Nome Descrizione
agentic_app_id
Necessario
str

Identificatore dell'app agentic del ruolo di lavoro digitale.

Valori restituiti

Tipo Descrizione
str

URL del gateway di strumenti per il ruolo di lavoro digitale.

is_development_environment

Restituisce True se l'ambiente corrente è configurato come sviluppo.

Ordine di risoluzione (vince il primo valore non vuoto):

  1. PYTHON_ENVIRONMENT : variabile esplicita di Python SDK usata negli esempi correnti.
  2. ENVIRONMENT — variabile legacy di Python SDK (compatibilità con le versioni precedenti).
  3. ASPNETCORE_ENVIRONMENT — Convenzione di hosting di Azure.
  4. DOTNET_ENVIRONMENT — convenzione dell'host generico.
  5. L'impostazione predefinita è "Development" quando non è impostata nessuna delle impostazioni precedenti.

PYTHON_ENVIRONMENT e ENVIRONMENT vengono prima controllati in modo che gli agenti impostati ENVIRONMENT=Production in modo esplicito non siano interessati se un processo host imposta ASPNETCORE_ENVIRONMENTanche .

is_development_environment() -> bool

Valori restituiti

Tipo Descrizione
bool

True quando l'ambiente risolto è "sviluppo" (senza distinzione tra maiuscole e minuscole).

resolve_token_scope_for_server

Risolvere l'ambito OAuth per richiedere un determinato server MCP.

I server V2 contengono il proprio pubblico nel audience campo (guid bare o api:// modulo URI). Quando viene specificato un oggetto esplicito scope ,ad esempio "Tools.ListInvoke.All", l'ambito è {audience}/{scope}. Quando l'ambito è assente, {audience}/.default viene usato (si basa su ambiti con consenso preliminare). I server V1 (nessun gruppo di destinatari, il gruppo di destinatari è uguale al valore AppId ATG condiviso nel formato BARE GUID o api:// URI) e quindi eseguire sempre il fallback all'ambito ATG /.default condiviso.

resolve_token_scope_for_server(server: MCPServerConfig) -> str

Parametri

Nome Descrizione
server
Necessario
MCPServerConfig

Configurazione del server MCP per cui risolvere l'ambito.

Valori restituiti

Tipo Descrizione
str

Stringa di ambito OAuth, ad esempio "<guid>/Tools.ListInvoke.All", "api://<guid>/.default"o ATG "<atg-guid>/.default"condiviso.