ADK Agent Builder
Construye agentes listos para producción con el Kit de Desarrollo de Agentes (ADK) de Google: andamiaje, conexión de herramientas, patrones de orquestación, pruebas y despliegue opcional en Vertex AI Agent Engine.
Resumen
- Crea un andamio mínimo orientado a producción para ADK (punto de entrada del agente, registro de herramientas, configuración y pruebas).
- Soporta flujos de trabajo de agente único con estilo ReAct y orquestación multi-agente (Secuencial/Paralelo/Bucle).
- Produce una lista de verificación de validación adecuada para CI (lint/pruebas/prompts de humo) y verificación opcional de despliegue en Agent Engine.
Prerrequisitos
- Entorno de ejecución de Python compatible con tu proyecto (generalmente Python 3.10+)
google-adkinstalado e importable- Si se despliega: acceso a un proyecto de Google Cloud con Vertex AI habilitado y permisos para desplegar entornos de ejecución de Agent Engine
- Secretos disponibles mediante variables de entorno o un gestor de secretos (nunca codificados)
Instrucciones
- Confirma el alcance: andamio local solo para el agente vs despliegue en Vertex AI Agent Engine.
- Elige una arquitectura:
- Agente único (ReAct) para tareas adaptativas basadas en herramientas
- Sistema multi-agente (especialistas + orquestador) para flujos de trabajo complejos de varios pasos
- Define la superficie de herramientas (herramientas integradas de ADK + cualquier herramienta personalizada que necesites) y las credenciales requeridas.
- Andamia el proyecto:
src/agents/,src/tools/,tests/y un archivo de dependencias (pyproject.tomlorequirements.txt)
- Implementa el agente mínimo viable y un prompt de humo; añade pruebas de regresión para fallos de herramientas.
- Si se despliega, produce un comando
adk deploy ...y una lista de verificación posterior al despliegue (AgentCard/puntos finales de tareas, permisos, registros).
Salida
- Un andamio ADK listo para repositorio (archivos y directorios) más código inicial del agente
- Stubs de herramientas y puntos de conexión (dónde añadir nuevas herramientas de forma segura)
- Un plan de pruebas y validación (pruebas unitarias y un prompt de humo mínimo)
- Opcional: comandos de despliegue y pasos de verificación para Agent Engine
Manejo de Errores
- Problemas de dependencia/ejecución: proporciona comandos de instalación fijos y valida las importaciones.
- Fallos de autenticación/permisos: identifica el rol/API faltante y propone correcciones de privilegio mínimo.
- Fallos de herramientas/límites de velocidad: añade orientación sobre reintentos/retroceso y una prueba de regresión para prevenir recurrencia.
Ejemplos
Ejemplo: Andamia un agente ReAct único
- Solicitud: "Crea un agente ADK que resuma PRs y proponga actualizaciones de pruebas."
- Resultado: punto de entrada del agente + registro de herramientas + un comando de prueba de humo para verificación local.
Ejemplo: Orquestador multi-agente
- Solicitud: "Construye un equipo de supervisor + desplegador + verificador y despliega en Agent Engine."
- Resultado: esqueleto del orquestador, responsabilidades por agente y
adk deploy ...+ comprobaciones de salud posteriores al despliegue.
Recursos
- Guía detallada completa (guardada como referencia):
${CLAUDE_SKILL_DIR}/references/SKILL.full.md - Estándares del repositorio (fuente de verdad):
000-docs/6767-a-SPEC-DR-STND-claude-code-plugins-standard.md000-docs/6767-b-SPEC-DR-STND-claude-skills-standard.md
- Documentación de ADK / Agent Engine: https://cloud.google.com/vertex-ai/docs/agent-engine