utility Modul

Tillhandahåller verktygsfunktioner för verktygskomponenterna.

Funktioner

build_mcp_server_url

Konstruerar den fullständiga MCP-server-URL:en med hjälp av bas-URL:en och servernamnet.

build_mcp_server_url(server_name: str) -> str

Parametrar

Name Description
server_name
Obligatorisk
str

MCP-servernamnet.

Returer

Typ Description
str

Den fullständiga MCP-server-URL:en.

get_chat_history_endpoint

Hämtar slutpunkts-URL:en för chatthistorik för att skicka chatthistorik till MCP-plattformen.

get_chat_history_endpoint() -> str

Returer

Typ Description
str

Slutpunkts-URL:en för chatthistorik.

get_mcp_base_url

Hämtar bas-URL:en för MCP-servrar.

get_mcp_base_url() -> str

Returer

Typ Description
str

Bas-URL:en för MCP-servrar.

get_mcp_platform_authentication_scope

Hämtar autentiseringsomfånget för MCP-plattformen.

get_mcp_platform_authentication_scope() -> list[str]

Returer

Typ Description
list[str]

En lista som innehåller lämpligt omfång för MCP-plattformsautentisering.

get_tooling_gateway_for_digital_worker

Hämtar url:en för verktygsgatewayen för den angivna digitala arbetaren.

get_tooling_gateway_for_digital_worker(agentic_app_id: str) -> str

Parametrar

Name Description
agentic_app_id
Obligatorisk
str

Den digitala arbetarens agentiska appidentifierare.

Returer

Typ Description
str

Url:en för verktygsgatewayen för den digitala arbetaren.

is_development_environment

Returnerar Sant om den aktuella miljön har konfigurerats som utveckling.

Lösningsordning (första värdet som inte är tomt vinner):

  1. PYTHON_ENVIRONMENT – explicit Python SDK-variabel som används i aktuella exempel.
  2. ENVIRONMENT — äldre Python SDK-variabel (bakåtkompatibilitet).
  3. ASPNETCORE_ENVIRONMENT – Värdkonvention för Azure.
  4. DOTNET_ENVIRONMENT — allmänna värdkonventioner.
  5. Standardvärdet "Development" är när inget av ovanstående anges.

PYTHON_ENVIRONMENT och ENVIRONMENT kontrolleras först så att agenter som uttryckligen anger ENVIRONMENT=Production inte påverkas om en värdprocess också anger ASPNETCORE_ENVIRONMENT.

is_development_environment() -> bool

Returer

Typ Description
bool

Sant när den lösta miljön är "utveckling" (skiftlägesokänslig).

resolve_token_scope_for_server

Lös OAuth-omfånget för att begära en viss MCP-server.

V2-servrar har en egen målgrupp i audience fältet (utan GUID- eller api:// URI-formulär). När en explicit scope anges (t.ex. "Tools.ListInvoke.All") är {audience}/{scope}omfånget . När omfånget saknas {audience}/.default används (förlitar sig på förmedgivande omfång). V1-servrar (ingen målgrupp, målgrupp är lika med det delade ATG AppId i bare GUID- eller api:// URI-format) återgår alltid till det delade ATG-omfånget /.default .

resolve_token_scope_for_server(server: MCPServerConfig) -> str

Parametrar

Name Description
server
Obligatorisk
MCPServerConfig

MCP-serverkonfigurationen för att matcha omfånget för.

Returer

Typ Description
str

OAuth-omfångssträngen, t.ex. "<guid>/Tools.ListInvoke.All", "api://<guid>/.default"eller den delade ATG: n "<atg-guid>/.default".