utility Modul

Stellt Hilfsfunktionen für die Toolkomponenten bereit.

Functions

build_mcp_server_url

Erstellt die vollständige MCP-Server-URL mithilfe der Basis-URL und des Servernamens.

build_mcp_server_url(server_name: str) -> str

Parameter

Name Beschreibung
server_name
Erforderlich
str

Der MCP-Servername.

Gibt zurück

Typ Beschreibung
str

Die vollständige MCP-Server-URL.

get_chat_history_endpoint

Ruft die ENDPUNKT-URL des Chatverlaufs zum Senden des Chatverlaufs an die MCP-Plattform ab.

get_chat_history_endpoint() -> str

Gibt zurück

Typ Beschreibung
str

Die Endpunkt-URL des Chatverlaufs.

get_mcp_base_url

Ruft die Basis-URL für MCP-Server ab.

get_mcp_base_url() -> str

Gibt zurück

Typ Beschreibung
str

Die Basis-URL für MCP-Server.

get_mcp_platform_authentication_scope

Ruft den Authentifizierungsbereich der MCP-Plattform ab.

get_mcp_platform_authentication_scope() -> list[str]

Gibt zurück

Typ Beschreibung
list[str]

Eine Liste mit dem entsprechenden MCP-Plattformauthentifizierungsbereich.

get_tooling_gateway_for_digital_worker

Ruft die Toolgateway-URL für den angegebenen digitalen Worker ab.

get_tooling_gateway_for_digital_worker(agentic_app_id: str) -> str

Parameter

Name Beschreibung
agentic_app_id
Erforderlich
str

Der agentische App-Bezeichner des digitalen Workers.

Gibt zurück

Typ Beschreibung
str

Die Toolgateway-URL für den digitalen Worker.

is_development_environment

Gibt True zurück, wenn die aktuelle Umgebung als Entwicklung konfiguriert ist.

Auflösungsreihenfolge (erster nicht leerer Wert gewinnt):

  1. PYTHON_ENVIRONMENT — explizite Python SDK-Variable, die in aktuellen Beispielen verwendet wird.
  2. ENVIRONMENT — Legacy-Python SDK-Variable (Abwärtskompatibilität).
  3. ASPNETCORE_ENVIRONMENT – Azure-Hostingkonvention.
  4. DOTNET_ENVIRONMENT — allgemeine Hostkonvention.
  5. Standardmäßig wird "Development" festgelegt, wenn keine der oben genannten Optionen festgelegt ist.

PYTHON_ENVIRONMENT und ENVIRONMENT werden zuerst überprüft, sodass Agents, die explizit festgelegt ENVIRONMENT=Production wurden, nicht betroffen sind, wenn ein Hostprozess ebenfalls festgelegt wird ASPNETCORE_ENVIRONMENT.

is_development_environment() -> bool

Gibt zurück

Typ Beschreibung
bool

True, wenn die aufgelöste Umgebung "Entwicklung" ist (Groß-/Kleinschreibung wird nicht beachtet).

resolve_token_scope_for_server

Lösen Sie den OAuth-Bereich auf, um eine Anforderung für einen bestimmten MCP-Server anzufordern.

V2-Server tragen ihre eigene Zielgruppe im audience Feld (bare GUID- oder api:// URI-Formular). Wenn ein expliziter scope Ausdruck (z. B. "Tools.ListInvoke.All") angegeben wird, lautet {audience}/{scope}der Bereich . Wenn der Bereich nicht vorhanden ist, {audience}/.default wird verwendet (basiert auf vorab zugestimmten Bereichen). V1-Server (keine Zielgruppe, Zielgruppe entspricht der freigegebenen ATG AppId in bare GUID- oder api:// URI-Form) greifen immer auf den freigegebenen ATG-Bereich /.default zurück.

resolve_token_scope_for_server(server: MCPServerConfig) -> str

Parameter

Name Beschreibung
server
Erforderlich
MCPServerConfig

Die MCP-Serverkonfiguration, für die der Umfang aufgelöst werden soll.

Gibt zurück

Typ Beschreibung
str

Die OAuth-Bereichszeichenfolge, z. B. "<guid>/Tools.ListInvoke.All", "api://<guid>/.default", oder die freigegebene ATG "<atg-guid>/.default".