utility Modül

Araç bileşenleri için yardımcı program işlevleri sağlar.

İşlevler

build_mcp_server_url

Temel URL'yi ve sunucu adını kullanarak tam MCP sunucu URL'sini oluşturur.

build_mcp_server_url(server_name: str) -> str

Parametreler

Name Description
server_name
Gerekli
str

MCP sunucu adı.

Döndürülenler

Tür Description
str

Tam MCP sunucusu URL'si.

get_chat_history_endpoint

MCP platformuna sohbet geçmişi göndermek için sohbet geçmişi uç noktası URL'sini alır.

get_chat_history_endpoint() -> str

Döndürülenler

Tür Description
str

Sohbet geçmişi uç noktası URL'si.

get_mcp_base_url

MCP sunucuları için temel URL'yi alır.

get_mcp_base_url() -> str

Döndürülenler

Tür Description
str

MCP sunucularının temel URL'si.

get_mcp_platform_authentication_scope

MCP platformu kimlik doğrulama kapsamını alır.

get_mcp_platform_authentication_scope() -> list[str]

Döndürülenler

Tür Description
list[str]

Uygun MCP platformu kimlik doğrulama kapsamını içeren bir liste.

get_tooling_gateway_for_digital_worker

Belirtilen dijital çalışanın araç ağ geçidi URL'sini alır.

get_tooling_gateway_for_digital_worker(agentic_app_id: str) -> str

Parametreler

Name Description
agentic_app_id
Gerekli
str

Dijital çalışanın aracı uygulama tanımlayıcısı.

Döndürülenler

Tür Description
str

Dijital çalışanın araç ağ geçidi URL'si.

is_development_environment

Geçerli ortam geliştirme olarak yapılandırılmışsa True döndürür.

Çözümleme sırası (ilk boş olmayan değer kazanır):

  1. PYTHON_ENVIRONMENT — geçerli örneklerde kullanılan açık Python SDK değişkeni.
  2. ENVIRONMENT — eski Python SDK değişkeni (geriye dönük uyumluluk).
  3. ASPNETCORE_ENVIRONMENT — Azure barındırma kuralı.
  4. DOTNET_ENVIRONMENT — genel konak kuralı.
  5. Yukarıdakilerden "Development" hiçbiri ayarlı olmadığında varsayılan olarak ayarlanır.

PYTHON_ENVIRONMENT ve ENVIRONMENT bir konak işlemi de ayarlarsa açıkça ayarlanan ENVIRONMENT=Production aracıların etkilenmemesi için önce denetlenmektedir ASPNETCORE_ENVIRONMENT.

is_development_environment() -> bool

Döndürülenler

Tür Description
bool

Çözümlenen ortam "geliştirme" (büyük/küçük harfe duyarlı değil) olduğunda true olur.

resolve_token_scope_for_server

Belirli bir MCP sunucusu için istekte bulunmak için OAuth kapsamını çözümleyin.

V2 sunucuları alanda audience kendi hedef kitlelerini taşır (çıplak GUID veya api:// URI formu). Bir açık scope sağlandığında (örneğin "Tools.ListInvoke.All"), kapsam şeklindedir {audience}/{scope}. Kapsam olmadığında {audience}/.default kullanılır (önceden onaylanan kapsamlara dayanır). V1 sunucuları (hedef kitle yok, hedef kitle çıplak GUID veya api:// URI biçiminde paylaşılan ATG AppId değerine eşit) her zaman paylaşılan ATG /.default kapsamına geri döner.

resolve_token_scope_for_server(server: MCPServerConfig) -> str

Parametreler

Name Description
server
Gerekli
MCPServerConfig

Kapsamını çözümlemek için MCP sunucu yapılandırması.

Döndürülenler

Tür Description
str

OAuth kapsam dizesi, örneğin "<guid>/Tools.ListInvoke.All", "api://<guid>/.default"veya paylaşılan ATG "<atg-guid>/.default".