utility Modul

Poskytuje nástroje pro součásti nástrojů.

Funkce

build_mcp_server_url

Vytvoří úplnou adresu URL serveru MCP pomocí základní adresy URL a názvu serveru.

build_mcp_server_url(server_name: str) -> str

Parametry

Name Description
server_name
Vyžadováno
str

Název serveru MCP.

Návraty

Typ Description
str

Úplná adresa URL serveru MCP.

get_chat_history_endpoint

Získá adresu URL koncového bodu historie chatu pro odesílání historie chatu na platformu MCP.

get_chat_history_endpoint() -> str

Návraty

Typ Description
str

Adresa URL koncového bodu historie chatu.

get_mcp_base_url

Získá základní adresu URL pro servery MCP.

get_mcp_base_url() -> str

Návraty

Typ Description
str

Základní adresa URL pro servery MCP.

get_mcp_platform_authentication_scope

Získá obor ověřování platformy MCP.

get_mcp_platform_authentication_scope() -> list[str]

Návraty

Typ Description
list[str]

Seznam obsahující příslušný obor ověřování platformy MCP.

get_tooling_gateway_for_digital_worker

Získá adresu URL brány nástrojů pro zadaný digitální pracovník.

get_tooling_gateway_for_digital_worker(agentic_app_id: str) -> str

Parametry

Name Description
agentic_app_id
Vyžadováno
str

Identifikátor aplikace agenta digitálního pracovního procesu.

Návraty

Typ Description
str

Adresa URL brány nástrojů pro digitální pracovníky.

is_development_environment

Vrátí hodnotu True, pokud je aktuální prostředí nakonfigurované jako vývoj.

Pořadí řešení (vyhrává první neprázdná hodnota):

  1. PYTHON_ENVIRONMENT – explicitní proměnná sady Python SDK použitá v aktuálních ukázkách.
  2. ENVIRONMENT – starší proměnná sady Python SDK (zpětná kompatibilita).
  3. ASPNETCORE_ENVIRONMENT – konvence hostování Azure.
  4. DOTNET_ENVIRONMENT — konvence obecného hostitele.
  5. Výchozí hodnota je "Development" , když není nastavená žádná z výše uvedených možností.

PYTHON_ENVIRONMENT a ENVIRONMENT jsou nejprve kontrolovány, aby agenti, kteří explicitně nastaveni ENVIRONMENT=Production nejsou ovlivněni, pokud hostitelský proces také nastaví ASPNETCORE_ENVIRONMENT.

is_development_environment() -> bool

Návraty

Typ Description
bool

Hodnota True, pokud je vyřešené prostředí "development" (nerozlišuje malá a velká písmena).

resolve_token_scope_for_server

Vyřešte obor OAuth tak, aby požadoval pro daný server MCP.

Servery V2 mají v audience poli vlastní cílovou skupinu (holý identifikátor GUID nebo api:// formulář identifikátoru URI). Pokud je explicitní scope (např. "Tools.ListInvoke.All"), rozsah je {audience}/{scope}. Pokud obor chybí, {audience}/.default použije se (spoléhá na předem odsouhlasené obory). Servery V1 (žádná cílová skupina, cílová skupina se rovná sdílenému ID aplikace ATG ve formuláři holého identifikátoru GUID nebo api:// identifikátoru URI) se vždy vrátí do sdíleného oboru ATG /.default .

resolve_token_scope_for_server(server: MCPServerConfig) -> str

Parametry

Name Description
server
Vyžadováno
MCPServerConfig

Konfigurace serveru MCP pro vyřešení rozsahu.

Návraty

Typ Description
str

Řetězec oboru OAuth, například "<guid>/Tools.ListInvoke.All", "api://<guid>/.default"nebo sdílené ATG "<atg-guid>/.default".