Especialista en Despliegue ADK
Descripción General
Experto en construir y desplegar sistemas multi-agente en producción utilizando el Agent Development Kit (ADK) de Google. Maneja la orquestación de agentes (Secuencial, Paralelo, Bucle), la comunicación mediante el protocolo A2A, el Sandbox de Ejecución de Código para operaciones en GCP, el Memory Bank para conversaciones con estado, y el despliegue en Vertex AI Agent Engine.
Prerrequisitos
- Un proyecto de Google Cloud con Vertex AI habilitado (y permisos para implementar entornos de ejecución de Agent Engine)
- ADK instalado (y fijado a la versión compatible del proyecto)
- Un contrato de agente claro: herramientas requeridas, patrón de orquestación y destino de despliegue (local vs Agent Engine)
- Un plan para secretos/credenciales (OIDC/WIF cuando sea posible; nunca confirmar claves de larga duración)
Instrucciones
- Confirmar la arquitectura deseada (agente único vs multi-agente) y el patrón de orquestación (Secuencial/Paralelo/Bucle).
- Definir las interfaces de AgentCard + A2A (entradas/salidas, envío de tareas y expectativas de consulta de estado).
- Implementar el/los agente(s) con la superficie mínima de herramientas requerida (Sandbox de Ejecución de Código y/o Memory Bank según sea necesario).
- Probar localmente con prompts representativos y casos de fallo, luego agregar pruebas de humo para la verificación del despliegue.
- Desplegar en Vertex AI Agent Engine y validar los endpoints generados (
/.well-known/agent-card, APIs de envío y estado de tareas). - Agregar observabilidad: registros, paneles y comportamiento de reintentos/retroceso para fallos transitorios.
Salida
- Archivos fuente del agente (o parches) listos para el despliegue
- Comandos/configuración de despliegue (por ejemplo, invocación de
adk deploy+ banderas necesarias) - Una lista de verificación para los endpoints de Agent Engine (AgentCard + APIs de tareas) y la postura de seguridad
Manejo de Errores
Consulte ${CLAUDE_SKILL_DIR}/references/errors.md para un manejo completo de errores.
Ejemplos
Consulte ${CLAUDE_SKILL_DIR}/references/examples.md para ejemplos detallados.
Recursos
- Documentación de ADK: https://cloud.google.com/vertex-ai/docs/agent-engine
- Identidad de Carga de Trabajo (CI/CD): https://cloud.google.com/iam/docs/workload-identity-federation
- Patrones de A2A / AgentCard: ver
000-docs/6767-a-SPEC-DR-STND-claude-code-plugins-standard.md