utility Module

Fournit des fonctions utilitaires pour les composants Tooling.

Functions

build_mcp_server_url

Construit l’URL complète du serveur MCP à l’aide de l’URL de base et du nom du serveur.

build_mcp_server_url(server_name: str) -> str

Paramètres

Nom Description
server_name
Obligatoire
str

Nom du serveur MCP.

Retours

Type Description
str

URL complète du serveur MCP.

get_chat_history_endpoint

Obtient l’URL du point de terminaison de l’historique des conversations pour l’envoi de l’historique des conversations à la plateforme MCP.

get_chat_history_endpoint() -> str

Retours

Type Description
str

URL du point de terminaison de l’historique des conversations.

get_mcp_base_url

Obtient l’URL de base pour les serveurs MCP.

get_mcp_base_url() -> str

Retours

Type Description
str

URL de base pour les serveurs MCP.

get_mcp_platform_authentication_scope

Obtient l’étendue d’authentification de la plateforme MCP.

get_mcp_platform_authentication_scope() -> list[str]

Retours

Type Description
list[str]

Liste contenant l’étendue d’authentification de la plateforme MCP appropriée.

get_tooling_gateway_for_digital_worker

Obtient l’URL de la passerelle d’outils pour le worker numérique spécifié.

get_tooling_gateway_for_digital_worker(agentic_app_id: str) -> str

Paramètres

Nom Description
agentic_app_id
Obligatoire
str

Identificateur de l’application agentique du worker numérique.

Retours

Type Description
str

URL de passerelle d’outils pour le worker numérique.

is_development_environment

Retourne La valeur True si l’environnement actuel est configuré en tant que développement.

Ordre de résolution (première valeur non vide gagne) :

  1. PYTHON_ENVIRONMENT — variable de KIT de développement logiciel (SDK) Python explicite utilisée dans les exemples actuels.
  2. ENVIRONMENT — variable du SDK Python héritée (compatibilité descendante).
  3. ASPNETCORE_ENVIRONMENT — Convention d’hébergement Azure.
  4. DOTNET_ENVIRONMENT — convention d’hôte générique.
  5. "Development" Par défaut, quand aucun des paramètres ci-dessus n’est défini.

PYTHON_ENVIRONMENT et ENVIRONMENT sont vérifiés en premier afin que les agents qui sont explicitement définis ENVIRONMENT=Production ne soient pas affectés si un processus hôte définit ASPNETCORE_ENVIRONMENTégalement .

is_development_environment() -> bool

Retours

Type Description
bool

True lorsque l’environnement résolu est « développement » (sans respect de la casse).

resolve_token_scope_for_server

Résolvez l’étendue OAuth pour demander un serveur MCP donné.

Les serveurs V2 comportent leur propre audience dans le audience champ (guid nu ou api:// formulaire URI). Lorsqu’un explicite scope est fourni (par exemple "Tools.ListInvoke.All"), l’étendue est {audience}/{scope}. Lorsque l’étendue est absente, {audience}/.default elle est utilisée (s’appuie sur des étendues pré-consentées). Les serveurs V1 (pas d’audience, l’audience est égale à l’APPId ATG partagé sous forme de GUID nu ou api:// d’URI) reviennent toujours à l’étendue ATG /.default partagée.

resolve_token_scope_for_server(server: MCPServerConfig) -> str

Paramètres

Nom Description
server
Obligatoire
MCPServerConfig

Configuration du serveur MCP pour laquelle résoudre l’étendue.

Retours

Type Description
str

Chaîne d’étendue OAuth, par exemple "<guid>/Tools.ListInvoke.All", ou "api://<guid>/.default"ATG "<atg-guid>/.default"partagé.