utility Modul

Inneholder verktøyfunksjoner for verktøykomponentene.

Funksjoner

build_mcp_server_url

Konstruerer den fullstendige URL-adressen for MCP-serveren ved hjelp av basis-URL-adressen og servernavnet.

build_mcp_server_url(server_name: str) -> str

Parametere

Navn Beskrivelse
server_name
Obligatorisk
str

MCP-servernavnet.

Returnerer

Type Beskrivelse
str

Den fullstendige URL-adressen for MCP-serveren.

get_chat_history_endpoint

Henter nettadressen for chatteloggendepunktet for å sende chatteloggen til MCP-plattformen.

get_chat_history_endpoint() -> str

Returnerer

Type Beskrivelse
str

URL-adressen til endepunktet for chatloggen.

get_mcp_base_url

Henter den grunnleggende URL-adressen for MCP-servere.

get_mcp_base_url() -> str

Returnerer

Type Beskrivelse
str

Den grunnleggende URL-adressen for MCP-servere.

get_mcp_platform_authentication_scope

Henter godkjenningsomfanget for MCP-plattformen.

get_mcp_platform_authentication_scope() -> list[str]

Returnerer

Type Beskrivelse
list[str]

En liste som inneholder riktig godkjenningsområde for MCP-plattform.

get_tooling_gateway_for_digital_worker

Henter nettadressen for verktøygatewayen for den angitte digitale arbeideren.

get_tooling_gateway_for_digital_worker(agentic_app_id: str) -> str

Parametere

Navn Beskrivelse
agentic_app_id
Obligatorisk
str

Den agentiske appidentifikatoren til den digitale arbeideren.

Returnerer

Type Beskrivelse
str

Nettadressen for verktøygatewayen for den digitale arbeideren.

is_development_environment

Returnerer Sann hvis gjeldende miljø er konfigurert som utvikling.

Løsningsrekkefølge (første ikke-tomme verdi vinner):

  1. PYTHON_ENVIRONMENT — eksplisitt Python SDK-variabel som brukes i gjeldende eksempler.
  2. ENVIRONMENT — eldre Python SDK-variabel (bakoverkompatibilitet).
  3. ASPNETCORE_ENVIRONMENT — Azure-vertskonvensjon.
  4. DOTNET_ENVIRONMENT - generell vertskonvensjon.
  5. Standarder når "Development" ingen av de ovennevnte er angitt.

PYTHON_ENVIRONMENT og ENVIRONMENT kontrolleres først slik at agenter som eksplisitt angir ENVIRONMENT=Production , ikke påvirkes hvis en vertsprosess også angir ASPNETCORE_ENVIRONMENT.

is_development_environment() -> bool

Returnerer

Type Beskrivelse
bool

Sann når det løste miljøet er «utvikling» (skille mellom store og små bokstaver).

resolve_token_scope_for_server

Løs OAuth-omfanget for å be om en gitt MCP-server.

V2-servere har sitt eget publikum i audience feltet (bare GUID- eller api:// URI-skjema). Når en eksplisitt scope er angitt (f.eks. "Tools.ListInvoke.All"), er {audience}/{scope}omfanget . Når omfanget er fraværende, {audience}/.default brukes (avhenger av forhåndssamtykkede omfang). V1-servere (ingen målgruppe, målgruppe er lik den delte ATG AppId i bare GUID- eller api:// URI-skjema) faller alltid tilbake til det delte ATG-omfanget /.default .

resolve_token_scope_for_server(server: MCPServerConfig) -> str

Parametere

Navn Beskrivelse
server
Obligatorisk
MCPServerConfig

MCP-serverkonfigurasjonen for å løse omfanget for.

Returnerer

Type Beskrivelse
str

OAuth-omfangsstrengen, for eksempel "<guid>/Tools.ListInvoke.All", "api://<guid>/.default"eller den delte ATG "<atg-guid>/.default".