MCP Reference: ces.googleapis.com

Un serveur MCP (Model Context Protocol) sert de proxy entre un service externe qui fournit du contexte, des données ou des capacités à un grand modèle de langage (LLM) ou à une application d'IA. Les serveurs MCP connectent les applications d'IA à des systèmes externes tels que des bases de données et des services Web, et traduisent leurs réponses dans un format que l'application d'IA peut comprendre.

Configuration du serveur

Avant de les utiliser, vous devez activer les serveurs MCP et configurer l'authentification. Pour en savoir plus sur l'utilisation des serveurs MCP distants Google et Google Cloud, consultez Présentation des serveurs MCP Google Cloud.

Serveur MCP pour l'API Gemini Enterprise for Customer Experience

Points de terminaison du serveur

Un point de terminaison de service MCP est l'adresse réseau et l'interface de communication (généralement une URL) du serveur MCP qu'une application d'IA (l'hôte du client MCP) utilise pour établir une connexion sécurisée et standardisée. Il s'agit du point de contact permettant au LLM de demander du contexte, d'appeler un outil ou d'accéder à une ressource. Les points de terminaison Google MCP peuvent être globaux ou régionaux.

Le serveur MCP ces.googleapis.com comporte le point de terminaison MCP suivant :

  • https://ces.[REGION].rep.googleapis.com/mcp

Outils MCP

Un outil MCP est une fonction ou une capacité exécutable qu'un serveur MCP expose à un LLM ou à une application d'IA pour effectuer une action dans le monde réel.

Le serveur MCP ces.googleapis.com inclut les outils suivants :

Outils MCP
list_apps Liste les applications du projet et de l'emplacement spécifiés.
get_app Obtient les détails de l'application spécifiée.
create_app Crée une application dans le projet et l'emplacement indiqués.
update_app Met à jour l'application spécifiée. Veillez à toujours transmettre un masque de mise à jour dans l'entrée.
delete_app Supprime l'application spécifiée.
list_agents Liste les agents dans l'application spécifiée.
get_agent Obtient les détails de l'agent spécifié.
create_agent Crée un agent dans l'application spécifiée.
update_agent Met à jour l'agent spécifié. Veillez à toujours transmettre un masque de mise à jour dans l'entrée.
delete_agent Supprime l'agent spécifié.
list_tools Liste les outils de l'application spécifiée.
get_tool Accède aux détails de l'outil spécifié.
create_tool Crée un outil dans l'application donnée.
update_tool Met à jour l'outil spécifié. Veillez à toujours transmettre un masque de mise à jour dans l'entrée.
delete_tool Supprime l'outil spécifié.
list_guardrails Liste les garde-fous dans l'application spécifiée.
get_guardrail Accède aux détails de la barrière de sécurité spécifiée.
create_guardrail Crée un garde-fou dans l'application donnée.
update_guardrail Met à jour le garde-fou spécifié. Veillez à toujours transmettre un masque de mise à jour dans l'entrée.
delete_guardrail Supprime le garde-fou spécifié.
list_deployments Liste les déploiements dans l'application spécifiée.
get_deployment Obtient les détails du déploiement spécifié.
create_deployment Crée un déploiement dans l'application donnée.
update_deployment Met à jour le déploiement spécifié. Veillez à toujours transmettre un masque de mise à jour dans l'entrée.
delete_deployment Supprime le déploiement spécifié.
list_toolsets Liste les ensembles d'outils dans l'application donnée.
get_toolset Accède aux détails de l'ensemble d'outils spécifié.
create_toolset Crée un ensemble d'outils dans l'application spécifiée.
update_toolset Met à jour l'ensemble d'outils spécifié. Veillez à toujours transmettre un masque de mise à jour dans l'entrée.
delete_toolset Supprime l'ensemble d'outils spécifié.
list_app_versions Liste toutes les versions d'application dans l'application donnée.
get_app_version Accède aux détails de la version d'application spécifiée.
create_app_version Crée une version de l'application dans l'application donnée.
delete_app_version Supprime la version de l'application spécifiée.
restore_app_version Restaure la version spécifiée de l'application.
list_changelogs Liste les journaux des modifications dans l'application spécifiée.
get_changelog Accède aux détails du journal des modifications spécifié.
start_export_app Commence à exporter une application CES
start_import_app Démarre l'importation d'une application CES.
run_evaluation Exécute une évaluation pour une application CES
create_evaluation Crée une évaluation.
create_evaluation_dataset Crée un ensemble de données d'évaluation.
delete_evaluation Supprime l'évaluation spécifiée.
delete_evaluation_dataset Supprime l'ensemble de données d'évaluation spécifié.
generate_evaluation_from_conversation Génère une évaluation à partir d'une conversation.
get_evaluation Obtient les détails de l'évaluation spécifiée.
get_evaluation_dataset Accède aux détails de l'ensemble de données d'évaluation spécifié.
get_evaluation_result Accède aux détails du résultat de l'évaluation spécifié.
get_evaluation_run Accède aux détails de l'exécution de l'évaluation spécifiée.
list_evaluation_datasets Liste les ensembles de données d'évaluation.
list_evaluation_results Liste les résultats de l'évaluation.
list_evaluation_runs Liste les exécutions d'évaluation.
list_evaluations Répertorie les évaluations.
update_evaluation Met à jour l'évaluation spécifiée. Veillez à toujours transmettre un masque de mise à jour dans l'entrée.
update_evaluation_dataset Met à jour l'ensemble de données d'évaluation spécifié. Veillez à toujours transmettre un masque de mise à jour dans l'entrée.
delete_evaluation_result Supprime le résultat d'évaluation spécifié.
delete_evaluation_run Supprime l'exécution d'évaluation spécifiée.
get_conversation Récupère les détails de la conversation spécifiée.
list_conversations Liste les conversations.
get_operation

Obtient l'état d'une opération de longue durée.

Utilisation : certains outils (par exemple, run_evaluation) renvoient une opération de longue durée. Vous pouvez utiliser cet outil pour obtenir l'état de l'opération. Elle peut être appelée de manière répétée pour interroger l'état d'une opération de longue durée.

Paramètres * name : nom de l'opération à obtenir. * name doit correspondre au nom renvoyé par l'outil qui a lancé l'opération. * name doit être au format projects/{project}/locations/{location}/operations/{operation}.

Obtenir les spécifications de l'outil MCP

Pour obtenir les spécifications des outils MCP pour tous les outils d'un serveur MCP, utilisez la méthode tools/list. L'exemple suivant montre comment utiliser curl pour lister tous les outils et leurs spécifications actuellement disponibles sur le serveur MCP.

Requête curl
                      curl --location 'https://ces.[REGION].rep.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'