utility Moduł

Udostępnia funkcje narzędzi dla składników narzędzi.

Funkcje

build_mcp_server_url

Tworzy pełny adres URL serwera MCP przy użyciu podstawowego adresu URL i nazwy serwera.

build_mcp_server_url(server_name: str) -> str

Parametry

Nazwa Opis
server_name
Wymagane
str

Nazwa serwera MCP.

Zwraca

Typ Opis
str

Pełny adres URL serwera MCP.

get_chat_history_endpoint

Pobiera adres URL punktu końcowego historii czatu na potrzeby wysyłania historii czatów do platformy MCP.

get_chat_history_endpoint() -> str

Zwraca

Typ Opis
str

Adres URL punktu końcowego historii czatu.

get_mcp_base_url

Pobiera podstawowy adres URL dla serwerów MCP.

get_mcp_base_url() -> str

Zwraca

Typ Opis
str

Podstawowy adres URL dla serwerów MCP.

get_mcp_platform_authentication_scope

Pobiera zakres uwierzytelniania platformy MCP.

get_mcp_platform_authentication_scope() -> list[str]

Zwraca

Typ Opis
list[str]

Lista zawierająca odpowiedni zakres uwierzytelniania platformy MCP.

get_tooling_gateway_for_digital_worker

Pobiera adres URL bramy narzędzi dla określonego procesu roboczego cyfrowego.

get_tooling_gateway_for_digital_worker(agentic_app_id: str) -> str

Parametry

Nazwa Opis
agentic_app_id
Wymagane
str

Identyfikator aplikacji agenta cyfrowego procesu roboczego.

Zwraca

Typ Opis
str

Adres URL bramy narzędzi dla procesu roboczego cyfrowego.

is_development_environment

Zwraca wartość True, jeśli bieżące środowisko jest skonfigurowane jako programowanie.

Kolejność rozpoznawania (pierwsza niepusta wartość wygrywa):

  1. PYTHON_ENVIRONMENT — jawna zmienna zestawu SDK języka Python używana w bieżących przykładach.
  2. ENVIRONMENT — starsza zmienna zestawu SDK języka Python (zgodność z poprzednimi wersjami).
  3. ASPNETCORE_ENVIRONMENT — Konwencja hostingu platformy Azure.
  4. DOTNET_ENVIRONMENT — konwencja ogólnego hosta.
  5. Wartości domyślne, "Development" gdy żadna z powyższych wartości nie jest ustawiona.

PYTHON_ENVIRONMENT i ENVIRONMENT są sprawdzane jako pierwsze, aby agenci, którzy jawnie ustawili ENVIRONMENT=Production , nie mają wpływu, jeśli proces hosta również ustawia wartość ASPNETCORE_ENVIRONMENT.

is_development_environment() -> bool

Zwraca

Typ Opis
bool

Prawda, gdy rozwiązane środowisko jest "programowanie" (bez uwzględniania wielkości liter).

resolve_token_scope_for_server

Rozwiąż zakres protokołu OAuth, aby zażądać dla danego serwera MCP.

Serwery w wersji 2 przenoszą własne grupy odbiorców w audience polu (bez identyfikatora GUID lub api:// formularza identyfikatora URI). Po podaniu jawnego scope (np. "Tools.ListInvoke.All") zakres to {audience}/{scope}. Jeśli zakres jest nieobecny, {audience}/.default jest używany (opiera się na wstępnie wyrażonych zakresach). Serwery w wersji 1 (brak odbiorców, odbiorcy są równi udostępnionego identyfikatora AppId usługi ATG w postaci bez identyfikatora GUID lub api:// identyfikatora URI) zawsze wracają do udostępnionego zakresu usługi ATG /.default .

resolve_token_scope_for_server(server: MCPServerConfig) -> str

Parametry

Nazwa Opis
server
Wymagane
MCPServerConfig

Konfiguracja serwera MCP w celu rozwiązania zakresu.

Zwraca

Typ Opis
str

Ciąg zakresu OAuth, np. "<guid>/Tools.ListInvoke.All", "api://<guid>/.default"lub udostępnionej usługi ATG "<atg-guid>/.default".