utility Moduuli

Tarjoaa työkalukomponenttien apuohjelmafunktioita.

Funktiot

build_mcp_server_url

Muodostaa MCP-palvelimen TÄYDELLISEN URL-osoitteen käyttämällä perus-URL-osoitetta ja palvelimen nimeä.

build_mcp_server_url(server_name: str) -> str

Parametrit

Nimi Description
server_name
Pakollinen
str

MCP-palvelimen nimi.

Palautukset

Tyyppi Description
str

McP-palvelimen TÄYDELLINEN URL-osoite.

get_chat_history_endpoint

Hakee keskusteluhistorian päätepisteen URL-osoitteen keskusteluhistorian lähettämiseksi MCP-ympäristöön.

get_chat_history_endpoint() -> str

Palautukset

Tyyppi Description
str

Keskusteluhistorian päätepisteen URL-osoite.

get_mcp_base_url

Hakee MCP-palvelinten perus-URL-osoitteen.

get_mcp_base_url() -> str

Palautukset

Tyyppi Description
str

MCP-palvelinten perus-URL-osoite.

get_mcp_platform_authentication_scope

Hakee MCP-ympäristön todennusalueen.

get_mcp_platform_authentication_scope() -> list[str]

Palautukset

Tyyppi Description
list[str]

Luettelo, joka sisältää asianmukaisen MCP-ympäristön todennusalueen.

get_tooling_gateway_for_digital_worker

Hakee määritetyn digitaalisen työntekijän työkaluyhdyskäytävän URL-osoitteen.

get_tooling_gateway_for_digital_worker(agentic_app_id: str) -> str

Parametrit

Nimi Description
agentic_app_id
Pakollinen
str

Digitaalisen työntekijän palvelusovellustunniste.

Palautukset

Tyyppi Description
str

Työkaluyhdyskäytävän URL-osoite digitaaliselle työntekijälle.

is_development_environment

Palauttaa arvon TRUE, jos nykyinen ympäristö on määritetty kehitysympäristöksi.

Ratkaisujärjestys (ensimmäinen muu kuin tyhjä arvo voittaa):

  1. PYTHON_ENVIRONMENT — eksplisiittinen Python SDK -muuttuja, jota käytetään nykyisissä esimerkissä.
  2. ENVIRONMENT — vanha Python SDK -muuttuja (yhteensopivuus aikaisempien versioiden kanssa).
  3. ASPNETCORE_ENVIRONMENT — Azuren isännöintikäytäntö.
  4. DOTNET_ENVIRONMENT — geneerinen isäntäkäytäntö.
  5. Oletusarvo on , "Development" kun mitään edellä mainituista ei ole määritetty.

PYTHON_ENVIRONMENTja ENVIRONMENT tarkistetaan ensin, jotta erikseen määritettyihin ENVIRONMENT=Production agentteihin ei vaikuta myös isäntäprosessi.ASPNETCORE_ENVIRONMENT

is_development_environment() -> bool

Palautukset

Tyyppi Description
bool

True, kun ratkaistu ympäristö on kehitys (kirjainkoko ei ole merkitsevä).

resolve_token_scope_for_server

Ratkaise OAuth-vaikutusalue, jos haluat pyytää tiettyä MCP-palvelinta.

V2-palvelimet kuljettavat kentällä omaa yleisöään (paljas audience GUID- tai api:// URI-lomake). Kun eksplisiittinen scope on annettu (esim. "Tools.ListInvoke.All"), vaikutusalue on {audience}/{scope}. Kun vaikutusaluetta ei ole, {audience}/.default käytetään kohdetta (joka perustuu ennakkohyväksyttyihin soveltamisalueisiin). V1-palvelimet (ei yleisöä, kohderyhmä on yhtä suuri kuin jaettu ATG AppId paljaassa GUID- tai api:// URI-muodossa) palaavat aina jaettuun ATG-laajuuteen /.default .

resolve_token_scope_for_server(server: MCPServerConfig) -> str

Parametrit

Nimi Description
server
Pakollinen
MCPServerConfig

MCP-palvelimen määritys kohteen laajuuden selvittämiseksi.

Palautukset

Tyyppi Description
str

OAuth-vaikutusalueen merkkijono, kuten "<guid>/Tools.ListInvoke.All", "api://<guid>/.default"tai jaettu ATG "<atg-guid>/.default".