Tutoriel Google ADK Visual Agent Builder avec projet démo : Travel Planner

Le Visual Agent Builder d’ADK de Google est une boîte à outils pratique pour concevoir, connecter et exécuter des workflows multi-agents sans avoir à construire tout le pipeline vous-même. Il associe un générateur d’agents basé sur des invites à une CLI ADK, aux modèles Gemini et à des outils intégrés, afin de transformer un brief en langage naturel en agent opérationnel. 

Dans ce tutoriel, je vous montre pas à pas comment créer un Travel Planner fonctionnel avec le Visual Agent Builder du kit de développement d’agents (ADK) de Google. Vous apprendrez à :

• Lancer l’éditeur visuel et relier des agents 
• Donner des instructions en langage naturel pour générer automatiquement des sous-agents et des outils.
• Ajouter la recherche web, un score simple et le traçage
• Tester et déboguer votre agent

À la fin, vous aurez un agent qui vous demande vos villes/dates/budget, exécute trois workers en parallèle (vols, hébergements, activités) et renvoie une ou deux options d’itinéraire claires.

Si vous découvrez l’IA agentique, nous vous recommandons le parcours de compétences AI Agent Fundamentals. Vous pouvez aussi consulter le cours Building AI Agents with Google ADK.

Qu’est-ce que Google ADK Visual Agent Builder ?

Le Visual Agent Builder d’ADK de Google est un canevas pour concevoir des workflows multi-agents propulsés par Gemini. Vous décrivez votre intention à un assistant IA, qui propose et matérialise une architecture d’agent complète, l’affiche sur un canevas visuel et vous permet de la tester immédiatement en chat. 

À partir de là, vous pouvez inspecter les traces et, quand vous êtes prêt, exporter des fichiers YAML prêts pour la production.

Voici les éléments clés de cet Agent Builder :

• Agents LLM : chaque nœud associe une invite et un modèle avec des outils optionnels. Par exemple, vous pouvez combiner un agent de raisonnement (Gemini 2.5 Pro ou Gemini 3 Pro) et un agent de recherche rapide (Gemini 2.5 Flash).
• Agents d’orchestration : des nœuds Loop, Parallel ou Sequential coordonnent la façon dont les agents LLM enfants s’exécutent à la demande du nœud racine.
• Outils : des outils intégrés comme google_search, ainsi que des outils de fonction et de fichiers/contexte tels que url_context et FilesRetrieval, facilitent la combinaison de plusieurs utilitaires par les agents.
• Callbacks et Trace : une vue Events et Trace en temps réel montre quel agent a tourné, avec ses entrées/sorties, pour déboguer pas à pas le raisonnement et les appels d’outils.

ADK gère les appels modèles, l’intégration des outils et le passage d’état pour que vous puissiez vous concentrer sur le comportement. 

Démo ADK Visual Agent Builder : construire un workflow d’agent Travel Planner

Dans cette section, nous allons créer un Travel Planner avec le Visual Agent Builder de Google ADK. Le workflow utilise un agent LLM racine et un agent parallèle qui s’appuie sur trois agents pour les vols, les hébergements et les activités, puis concilie le tout en options de voyage claires et immédiatement actionnables.

Voici le fonctionnement :

• Intention de voyage : saisissez l’itinéraire envisagé, incluant les villes, les dates, le budget et vos préférences (à privilégier/à éviter).
• Recherche en parallèle : l’agent parallèle investigue :
• L’agent Vols propose des trajets réalistes, avec horaires, escales, durée totale et coût.
• L’agent Hébergements suggère 1 à 2 options par ville.
• L’agent Activités propose 2 à 3 idées par ville.
• Conciliation et classement : l’agent racine compare les arbitrages (coût, temps total de trajet, adéquation aux préférences, etc.) et renvoie jusqu’à deux options avec avantages/inconvénients plus un programme jour par jour pour le plan recommandé.
• Traçage et itérations : vous pouvez observer le déclenchement de chaque sous-agent dans la vue Trace, puis affiner avec des relances.

Au final, vous obtenez un workflow multi-agents qui transforme une idée de voyage en anglais courant en un itinéraire concret, conscient du budget et accompagné d’un raisonnement transparent.

Étape 1 : installer Google ADK

Avant de concevoir des agents, nous avons besoin de la CLI ADK. C’est l’outil en ligne de commande qui lance le Visual Agent Builder et exécute l’interface web locale. 

pip install --upgrade google-adk
adk --versionPropulsé par

Le code ci-dessus doit renvoyer adk, version 1.18.0. Il récupère d’abord le dernier paquet ADK et ses dépendances. L’option --upgrade garantit que vous n’êtes pas bloqué sur une ancienne CLI qui pourrait ne pas inclure les fonctionnalités du Visual Agent Builder utilisées dans ce tutoriel. 

Enfin, nous vérifions l’installation et que notre shell trouve bien l’exécutable adk.

ADK étant installé et vérifié, nous pouvons lancer le Visual Agent Builder et créer notre workflow Travel Planner. À l’étape suivante, nous allons configurer votre clé API et ouvrir l’interface locale pour commencer à assembler les agents visuellement.

Étape 2 : configurer la clé API Google

Commencez par ouvrir Google AI Studio et, en bas à gauche, cliquez sur Get API Key. Sélectionnez ensuite Create API Key et nommez votre clé API. Notez que vous devrez créer un nouveau projet Google Cloud ou utiliser un projet existant avec la facturation activée. Une fois prêt, retournez dans Google AI Studio, copiez la clé API et définissez-la comme variable d’environnement dans votre répertoire de travail.

export GOOGLE_API_KEY=YOUR_API_KEY —-> for macOS/Linux
setx GOOGLE_API_KEY "YOUR_KEY" —-> for Windows (PowerShell)Propulsé par

Redémarrez votre terminal pour que la modification prenne effet.

En option, vous pouvez cloner un dépôt de démarrage avec un projet prêt à tester et toutes les dépendances déjà configurées :

git clone https://github.com/thomas-chong/google-adk-visual-agent-builder-demo.git
cd google-adk-visual-agent-builder-demoPropulsé par

La commande ci-dessus clone un repo contenant une démo d’agent de recherche pour démarrer. Maintenant qu’ADK est installé, lançons l’interface web.

Étape 3 : lancer l’interface web

Avec votre clé API configurée et ADK installé, vous pouvez ouvrir le Visual Agent Builder. Exécutez la commande suivante pour démarrer le serveur local de l’interface Dev. 

adk webPropulsé par

Par défaut, il se lance sur http://127.0.0.1:8000. Ouvrez cette URL dans votre navigateur.

L’interface initiale ressemble à ceci :

Cliquez sur le bouton + pour créer un nouvel agent, nommez-le Travel_Agent, et vous arriverez dans l’éditeur en trois panneaux : Configuration (à gauche), Canvas (au centre) et Assistant/Chat (à droite).

J’ai d’abord envoyé une invite à Gemini dans le chat pour créer automatiquement l’agent, un peu comme vous utiliseriez AgentKit d’OpenAI pour construire un workflow.

Create a Travel Ops planner agent. Given user input (ordered cities, dates, budget, must/avoid prefs), run three workers in parallel—Flights, Stays, Activities—(use google_search where helpful). 
Recommend up to 2 options. Prioritize stated preferences; if options are close, prefer lower cost and less total travel time. 
Clearly explain the trade-offs. If options are nearly identical, return one best option and say why. 
For each option, return text-only bullets: Cost (USD), Total travel time (h), Preference-fit (0–1), Pros/Cons (cost, time, experience), and a brief day-by-day (give the full day-by-day only for the recommended option). 
Defaults: prices in USD, time in hours, max 2 options. Ask at most 2 clarifying questions; if data is thin, return a degraded single option with a warning. 
Avoid fake booking links; provide sensible estimates and caveats.Propulsé par

À ma surprise, Google ADK se montre assez efficace pour répartir modèles et sous-agents en fonction de la tâche. Après que Gemini a généré du code et l’a réparti dans des fichiers d’agent spécifiques, il injecte les instructions dans votre agent et ajoute automatiquement les sous-agents et outils appropriés. 

Voici le pipeline de bout en bout généré à partir de mon invite.

Voici à quoi ressemble l’éditeur une fois l’invite traitée par Gemini : instructions appliquées, outils connectés, sous-agents ajoutés et description de l’agent renseignée.

Enfin, cliquez sur Enregistrer : votre agent est prêt. Vous arrivez alors dans l’interface de chat où j’ai posé quelques questions de voyage à l’agent.

Au départ, j’ai demandé à l’agent :

I want to travel from New York to Dubai for New Year’s for a week long vacation. Help me plan my trip within a budget of $1000Propulsé par

Dans la vidéo ci-dessous, vous pouvez voir la réponse de l’agent.