Ingénieur ADK
Concevez des agents et systèmes multi-agents prêts pour la production avec le Kit de Développement d'Agents (ADK) : structure propre, testabilité, utilisation sûre des outils et automatisation du déploiement.
Aperçu
Utilisez cette compétence pour concevoir et implémenter du code d'agent ADK qui est maintenable et livrable : limites de modules claires, interfaces d'outils structurées, tests de régression et une checklist de déploiement (en local ou sur Agent Engine).
Prérequis
- Un runtime cible (Python/Java/Go) cohérent avec les versions figées du projet
- ADK installé (ainsi que les SDK des modèles/fournisseurs requis configurés)
- Un exécuteur de tests disponible dans le dépôt (tests unitaires au minimum)
- Si déploiement : accès à un projet Google Cloud et les autorisations pour la cible de déploiement choisie
Instructions
- Clarifier les exigences : objectifs de l'agent, surface d'outils, contraintes de latence/coût et cible de déploiement.
- Proposer une architecture : agent unique vs multi-agents, pattern d'orchestration, stratégie d'état (Memory Bank / stockage externe).
- Structurer le squelette : point(s) d'entrée de l'agent, modules d'outils, configuration et tests.
- Implémenter de manière incrémentale :
- ajouter un outil à la fois avec validation d'entrée et sorties structurées
- ajouter des tests de régression pour chaque outil et les flux de prompts critiques
- Ajouter des garde-fous opérationnels : tentatives/réessais avec backoff, timeouts, journalisation et messages d'erreur sécurisés.
- Valider localement (tests + prompts de test) et fournir un plan de déploiement (sur demande).
Résultat
- Un plan d'architecture concret et une disposition des fichiers
- Des implémentations d'agent et d'outils (ou des correctifs) avec des tests
- Une checklist de validation (commandes à exécuter, résultats attendus et diagnostic des échecs)
- En option : des instructions de déploiement et des vérifications de santé post-déploiement
Gestion des erreurs
- Échecs de construction/test : isoler le module défaillant, minimiser la reproduction, corriger et ajouter un test de régression.
- Erreurs d'outil/runtime : imposer des réponses d'erreur structurées et des tentatives sécurisées le cas échéant.
- Échecs de déploiement : fournir la commande exacte qui échoue, les journaux à inspecter et les correctifs IAM de moindre privilège.
Exemples
Exemple : Mise en production d'un agent ADK existant
- Demande : "Refactorisez cet agent en une structure de module propre et ajoutez des tests avant de déployer."
- Résultat : disposition
src/réorganisée, limites d'outils, une suite de tests et une checklist de déploiement.
Exemple : Workflow multi-agents
- Demande : "Créez une équipe d'agents validateur + déployeur + moniteur avec un orchestrateur séquentiel."
- Résultat : squelette de l'orchestrateur, responsabilités par agent et tests de fumée pour chaque étape.
Ressources
- Playbook détaillé complet (conservé pour référence) :
${CLAUDE_SKILL_DIR}/references/SKILL.full.md - Standards 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