GML016

Présentation

Les grands modèles de langage (LLM) sont puissants, mais ils présentent deux limites majeures : leurs connaissances sont figées au moment de leur entraînement, et ils ne peuvent pas interagir avec le monde extérieur pour accéder à des données en temps réel, ou effectuer des actions comme planifier une réunion ou mettre à jour un enregistrement client.

C'est là qu'intervient le protocole MCP (Model Context Protocol), une norme ouverte conçue pour repousser les limites des LLM.

Pourquoi utiliser le protocole MCP ?

Le protocole MCP fournit un "langage" sécurisé et standardisé pour que les LLM puissent communiquer avec des données, des applications et des services externes. Semblable à une passerelle, il permet aux agents IA d'aller au-delà des connaissances statiques et de devenir dynamiques. Grâce au MCP, les agents IA peuvent récupérer des informations à jour et entreprendre des actions, ce qui les rend plus précis, utiles et automatisés.

Cet atelier fournit des instructions détaillées pour installer l'Agent Development Kit (ADK), modifier un agent ADK existant pour qu'il utilise MCP et déployer l'agent mis à jour afin d'initialiser une session interactive au moyen de l'interface de ligne de commande.

Objectifs

Dans cet atelier, vous allez apprendre à :

• installer l'Agent Development Kit (ADK) et créer un environnement virtuel pour votre projet ;
• tester le système currency-agent (l'état antérieur) ;
• modifier l'agent pour qu'il utilise un serveur MCP ;
• redémarrer le serveur MCP et l'agent pour que les modifications prennent effet ;
• vérifier les modifications apportées au serveur MCP (l'état postérieur).

Préparation

• Les ateliers sont minutés et ne peuvent pas être mis en pause. Le minuteur démarre lorsque vous cliquez sur Démarrer l'atelier.
• Le terminal cloud inclus est préconfiguré avec le SDK gcloud.
• Utilisez le terminal pour exécuter les commandes, puis cliquez sur Vérifier ma progression pour que votre travail soit validé.

Configurer l'environnement et installer les dépendances appropriées

1. Exécutez la commande suivante dans le terminal pour copier les fichiers de code d'un bucket Cloud Storage pour cet atelier :

   gcloud storage cp -r gs://{{{project_0.project_id| YOUR_GCP_PROJECT_ID}}}-bucket/currency-agent .

2. Configurez l'environnement et créez le fichier .env dans le répertoire currency-agent à l'aide des commandes suivantes :

   cd currency-agent cp /home/student/keys.json . uv venv --python 3.13 source .venv/bin/activate uv sync touch .env echo "GOOGLE_CLOUD_PROJECT={{{ project_0.project_id }}}" >> .env echo "GOOGLE_CLOUD_LOCATION=global" >> .env echo "GOOGLE_GENAI_USE_VERTEXAI=True" >> .env echo "MODEL={{{project_0.startup_script.gemini_flash_model_id | gemini_flash_model_id}}}" >> .env

Tâche 1 : Installer l'Agent Development Kit (ADK)

1. Dans un nouveau terminal (sélectionnez Terminal > Nouveau terminal dans la barre de menu ou appuyez sur CTRL+MAJ+'), démarrez le serveur MCP à l'aide des commandes suivantes :

   cd currency-agent uv run mcp-server/server.py

2. Dans un nouveau terminal (sélectionnez Terminal > Nouveau terminal dans la barre de menu ou appuyez sur CTRL+MAJ+'), démarrez le serveur A2A (il démarre sur le port 10000) à l'aide des commandes suivantes :

   cd currency-agent uv run uvicorn currency_agent.agent:a2a_app --host localhost --port 10000

Tâche 2 : Exécuter l'agent de référence (l'état antérieur)

1. Dans votre instance de terminal initiale, lancez l'agent de devises existant à l'aide des commandes suivantes :

   adk run currency_agent

2. Interagissez avec l'agent en lui envoyant le prompt suivant :

   Quel est le taux de change USD/EUR ?

   L'agent doit vous donner le taux de change en temps réel entre le dollar américain et l'euro.

3. Essayez un autre prompt :

   Quel est le taux de change USD/CNY ?

   L'agent doit vous donner le taux de change en temps réel entre le dollar américain et le yuan chinois.

4. Interagissez avec l'agent en lui envoyant le prompt suivant :

   Quel est le cours du bitcoin ?

   La réponse devrait vous permettre de comprendre que l'agent ne connaît que les devises fiduciaires (c'est-à-dire qu'il ne peut pas vous fournir de données actuelles sur les cryptomonnaies).

Tâche 3 : Modifier l'agent

Dans cette tâche, vous allez modifier votre agent de devises pour qu'il puisse utiliser le serveur MCP (Model Context Protocol). Considérez-le comme un moyen d'appeler un "serveur de devises" distinct (par le biais de l'API Coinbase disponible publiquement) pour obtenir des taux auxquels l'agent n'a pas accès autrement.

1. Cliquez sur l'icône Explorateur de fichiers dans le volet de gauche, puis accédez au dossier de votre projet currency-agent/mcp-server.

2. Dans l'explorateur de fichiers, sous le répertoire mcp-server, ouvrez le fichier server.py, insérez le code suivant à la ligne 52 et enregistrez vos modifications :

   @mcp.tool() def get_crypto_price(currency_pair: str = "BTC-USD") -> dict: """Obtiens le cours actuel d'une paire de cryptomonnaies.""" # Aucune clé d'API n'est requise pour ce point de terminaison public url = f"https://api.coinbase.com/v2/prices/{currency_pair}/spot" response = httpx.get(url) return response.json()["data"]

Tâche 4 : Redémarrer les serveurs MCP et A2A

1. Passez à l'instance de terminal où le serveur MCP est toujours en cours d'exécution.

2. Appuyez sur CTRL+C pour arrêter le serveur.

3. Toujours dans le même terminal, exécutez la commande suivante pour redémarrer le serveur MCP :

   uv run mcp-server/server.py

4. Passez à l'instance de terminal où le serveur A2A est toujours en cours d'exécution.

5. Appuyez sur CTRL+C pour arrêter le serveur.

6. Toujours dans ce terminal, exécutez la commande suivante pour redémarrer l'agent :

   uv run uvicorn currency_agent.agent:a2a_app --host localhost --port 10000

Tâche 5 : Exécuter et tester votre agent mis à jour (l'état postérieur)

1. Passez à l'instance de terminal où currency_agent s'exécutait précédemment.

2. Saisissez Quitter pour mettre fin à la session d'origine.

3. Exécutez la commande suivante pour relancer et tester votre agent :

   adk run --save_session currency_agent Remarque : Vous pouvez ignorer les avertissements liés aux dépendances de la version Python.

4. Essayez d'envoyer le prompt suivant pour interagir avec l'agent :

   Utilise l'outil get_crypto_price pour me donner le cours actuel du Bitcoin.

L'agent a désormais accès à l'outil get_crypto_price (avec MCP), ce qui lui permet de répondre à des questions sur les devises fiduciaires, mais aussi sur les cryptomonnaies.

5. Saisissez Quitter, puis 1 lorsque vous êtes invité à entrer un ID de session.

Cliquez sur Vérifier ma progression pour valider l'objectif. Modifier un agent ADK pour qu'il utilise MCP

Félicitations !

Vous avez déployé un agent ADK que vous avez modifié pour qu'il utilise le serveur MCP (Model Context Protocol).

Dernière mise à jour du manuel : 21 janvier 2026

Dernier test de l'atelier : 21 janvier 2026

Copyright 2026 Google LLC. Tous droits réservés. Google et le logo Google sont des marques de Google LLC. Tous les autres noms d'entreprises et de produits peuvent être des marques des entreprises auxquelles ils sont associés.