Générateur d'Agents ADK
Créez des agents prêts pour la production avec le Google Agent Development Kit (ADK) : échafaudage, câblage d'outils, motifs d'orchestration, tests et déploiement optionnel sur Vertex AI Agent Engine.
Aperçu
- Crée un échafaudage ADK minimal et orienté production (point d'entrée de l'agent, registre d'outils, configuration et tests).
- Prend en charge les workflows à agent unique de type ReAct et l'orchestration multi-agent (séquentiel/parallèle/boucle).
- Produit une liste de validation adaptée à l'IC (lint/tests/prompts de fumée) et une vérification optionnelle du déploiement sur Agent Engine.
Prérequis
- Environnement d'exécution Python compatible avec votre projet (souvent Python 3.10+)
google-adkinstallé et importable- Si déploiement : accès à un projet Google Cloud avec Vertex AI activé et autorisations pour déployer des environnements d'exécution Agent Engine
- Secrets disponibles via des variables d'environnement ou un gestionnaire de secrets (jamais codés en dur)
Instructions
- Confirmez la portée : échafaudage d'agent local uniquement vs déploiement sur Vertex AI Agent Engine.
- Choisissez une architecture :
- Agent unique (ReAct) pour des tâches adaptatives pilotées par des outils
- Système multi-agent (spécialistes + orchestrateur) pour des workflows complexes en plusieurs étapes
- Définissez la surface d'outils (outils ADK intégrés + tout outil personnalisé nécessaire) et les identifiants requis.
- Échafaudez le projet :
src/agents/,src/tools/,tests/et un fichier de dépendances (pyproject.tomlourequirements.txt)
- Implémentez l'agent minimal viable et un prompt de test de fumée ; ajoutez des tests de régression pour les échecs d'outils.
- Si déploiement, produisez une commande
adk deploy ...et une liste de validation post-déploiement (points de terminaison AgentCard/tâches, autorisations, journaux).
Résultat
- Un échafaudage ADK prêt pour le dépôt (fichiers et répertoires) plus le code de démarrage de l'agent
- Des stubs d'outils et des points de câblage (où ajouter de nouveaux outils en toute sécurité)
- Un plan de test et de validation (tests unitaires et un prompt de fumée minimal)
- Optionnel : commandes de déploiement et étapes de vérification pour Agent Engine
Gestion des Erreurs
- Problèmes de dépendances/exécution : fournissez des commandes d'installation épinglées et validez les imports.
- Échecs d'authentification/autorisation : identifiez le rôle/API manquant et proposez des correctifs de moindre privilège.
- Échecs d'outils/limites de débit : ajoutez des conseils de réessai/backoff et un test de régression pour éviter la récurrence.
Exemples
Exemple : Échafauder un agent ReAct unique
- Requête : « Crée un agent ADK qui résume les PR et propose des mises à jour de tests. »
- Résultat : point d'entrée de l'agent + registre d'outils + une commande de test de fumée pour vérification locale.
Exemple : Orchestrateur multi-agent
- Requête : « Construis une équipe superviseur + déployeur + vérificateur et déploie-la sur Agent Engine. »
- Résultat : squelette d'orchestrateur, responsabilités par agent et
adk deploy ...+ contrôles de santé post-déploiement.
Ressources
- Guide détaillé complet (conservé pour référence) :
${CLAUDE_SKILL_DIR}/references/SKILL.full.md - Normes du dépôt (source de vérité) :
000-docs/6767-a-SPEC-DR-STND-claude-code-plugins-standard.md000-docs/6767-b-SPEC-DR-STND-claude-skills-standard.md
- Documentation ADK / Agent Engine : https://cloud.google.com/vertex-ai/docs/agent-engine