utility Modul

Indeholder funktioner til værktøjskomponenterne.

Funktioner

build_mcp_server_url

Konstruerer den fulde URL-adresse til MCP-serveren ved hjælp af basis-URL-adressen og servernavnet.

build_mcp_server_url(server_name: str) -> str

Parametre

Name Beskrivelse
server_name
Påkrævet
str

NAVNET PÅ MCP-serveren.

Returnerer

Type Beskrivelse
str

Den fulde URL-adresse til MCP-serveren.

get_chat_history_endpoint

Henter URL-adressen til slutpunktet for chathistorikken til afsendelse af chathistorik til MCP-platformen.

get_chat_history_endpoint() -> str

Returnerer

Type Beskrivelse
str

URL-adressen til slutpunktet for chathistorikken.

get_mcp_base_url

Henter den grundlæggende URL-adresse til MCP-servere.

get_mcp_base_url() -> str

Returnerer

Type Beskrivelse
str

Den grundlæggende URL-adresse til MCP-servere.

get_mcp_platform_authentication_scope

Henter omfanget af MCP-platformens godkendelse.

get_mcp_platform_authentication_scope() -> list[str]

Returnerer

Type Beskrivelse
list[str]

En liste, der indeholder det relevante godkendelsesområde for MCP-platformen.

get_tooling_gateway_for_digital_worker

Henter URL-adressen til værktøjsgatewayen for den angivne digitale arbejder.

get_tooling_gateway_for_digital_worker(agentic_app_id: str) -> str

Parametre

Name Beskrivelse
agentic_app_id
Påkrævet
str

Den digitale arbejders agentiske app-id.

Returnerer

Type Beskrivelse
str

URL-adressen til værktøjsgatewayen for den digitale arbejder.

is_development_environment

Returnerer Sand, hvis det aktuelle miljø er konfigureret som udvikling.

Løsningsrækkefølge (første værdi, der ikke er tom, vinder):

  1. PYTHON_ENVIRONMENT – eksplicit Python SDK-variabel, der bruges i aktuelle eksempler.
  2. ENVIRONMENT – ældre Python SDK-variabel (bagudkompatibilitet).
  3. ASPNETCORE_ENVIRONMENT – Azure-hostingkonvention.
  4. DOTNET_ENVIRONMENT — standardværtskonvention.
  5. "Development" Som standard, når ingen af ovenstående er angivet.

PYTHON_ENVIRONMENT og ENVIRONMENT kontrolleres først, så de agenter, der eksplicit angiver ENVIRONMENT=Production , ikke påvirkes, hvis en værtsproces også angiver ASPNETCORE_ENVIRONMENT.

is_development_environment() -> bool

Returnerer

Type Beskrivelse
bool

Sand, når det løste miljø er "udvikling" (der skelnes ikke mellem store og små bogstaver).

resolve_token_scope_for_server

Løs OAuth-området for at anmode om en given MCP-server.

V2-servere har deres egen målgruppe i feltet audience (bar GUID- eller api:// URI-formular). Når der angives en eksplicit scope (f.eks. "Tools.ListInvoke.All"), er {audience}/{scope}området . Når omfanget mangler, {audience}/.default bruges (afhænger af områder, der er godkendt på forhånd). V1-servere (ingen målgruppe, målgruppe er lig med det delte ATG AppId i bare GUID- eller api:// URI-format) falder altid tilbage til det delte ATG-område /.default .

resolve_token_scope_for_server(server: MCPServerConfig) -> str

Parametre

Name Beskrivelse
server
Påkrævet
MCPServerConfig

Den MCP-serverkonfiguration, der skal løses området for.

Returnerer

Type Beskrivelse
str

OAuth-områdestrengen, f.eks. "<guid>/Tools.ListInvoke.All", "api://<guid>/.default"eller den delte ATG "<atg-guid>/.default".