Spécialiste du Déploiement ADK
Aperçu
Expert en construction et déploiement de systèmes multi-agents de production utilisant le kit de développement d'agents Google (ADK). Gère l'orchestration d'agents (Séquentiel, Parallèle, Boucle), la communication via le protocole A2A, le bac à sable d'exécution de code pour les opérations GCP, le Memory Bank pour les conversations avec état, et le déploiement vers Vertex AI Agent Engine.
Prérequis
- Un projet Google Cloud avec Vertex AI activé (et les autorisations nécessaires pour déployer les runtimes Agent Engine)
- ADK installé (et lié à la version supportée par le projet)
- Un contrat d'agent clair : outils requis, motif d'orchestration, et cible de déploiement (local vs Agent Engine)
- Un plan pour les secrets/identifiants (OIDC/WIF si possible ; ne jamais commiter de clés longues)
Instructions
- Confirmer l'architecture souhaitée (agent unique vs multi-agents) et le motif d'orchestration (Séquentiel/Parallèle/Boucle).
- Définir les interfaces AgentCard + A2A (entrées/sorties, soumission de tâches, et attentes de sondage de statut).
- Implémenter le(s) agent(s) avec la surface d'outils minimale requise (bac à sable d'exécution de code et/ou Memory Bank selon les besoins).
- Tester localement avec des invites représentatives et des cas d'échec, puis ajouter des tests de fumée pour la vérification du déploiement.
- Déployer vers Vertex AI Agent Engine et valider les endpoints générés (
/.well-known/agent-card, APIs d'envoi/statut de tâches). - Ajouter de l'observabilité : logs, tableaux de bord, et comportement de nouvelles tentatives/repli pour les échecs transitoires.
Sortie
- Fichiers sources de l'agent (ou correctifs) prêts pour le déploiement
- Commandes/configurations de déploiement (par ex., invocation
adk deploy+ indicateurs requis) - Une checklist de vérification pour les endpoints Agent Engine (AgentCard + APIs de tâches) et la posture de sécurité
Gestion des erreurs
Voir ${CLAUDE_SKILL_DIR}/references/errors.md pour une gestion complète des erreurs.
Exemples
Voir ${CLAUDE_SKILL_DIR}/references/examples.md pour des exemples détaillés.
Ressources
- Documentation ADK : https://cloud.google.com/vertex-ai/docs/agent-engine
- Identité de charge de travail (CI/CD) : https://cloud.google.com/iam/docs/workload-identity-federation
- Motifs A2A / AgentCard : voir
000-docs/6767-a-SPEC-DR-STND-claude-code-plugins-standard.md