ADK Engineer
Implement, review, and deploy Google ADK agents following proven patterns and best practices.
Quick Start
Single agent: Read references/adk-patterns.md -> Use assets/templates/single-agent/ -> Validate with references/adk-best-practices.md.
Multi-agent system: Choose pattern (Coordinator, Sequential, Parallel, Loop) -> Use matching template from assets/templates/ -> Consult references/adk-patterns.md.
Pattern Selection
| Task Type | Pattern | Template |
|---|---|---|
| Linear data processing | Sequential Pipeline | assets/templates/workflow/ |
| Intent-based routing | Coordinator/Dispatcher | assets/templates/multi-agent/ |
| Independent concurrent tasks | Parallel Fan-Out/Gather | assets/templates/workflow/ |
| Nested agent structures | Hierarchical Decomposition | assets/templates/multi-agent/ |
| Validation loops | Generator-Critic | assets/templates/workflow/ |
| Quality improvement | Iterative Refinement | assets/templates/workflow/ |
| Critical decisions | Human-in-the-Loop | assets/templates/single-agent/ |
Implementation Workflow
New Agent
- Choose pattern from table above based on task analysis.
- Copy template:
cp -r assets/templates/[single-agent|multi-agent|workflow]/ ./my_agent/ # Or: bash scripts/init_adk_project.sh my_agent [template_type] - Implement domain logic: Define custom tools, update instructions, configure
output_keyvalues. - Test locally: Run
python agent.pyoradk ui. - Validate:
python scripts/validate_agent.py agent.py - Deploy per
references/adk-deployment.md.
Code Review
- Read agent code and identify patterns used.
- Check implementation against
references/adk-patterns.md. - Review against
references/adk-best-practices.md. - Run
python scripts/validate_agent.py agent.py. - Provide specific, actionable recommendations with references.
Validation Checklist
-
root_agentproperly defined - Agent descriptions are clear and specific
- Descriptive
output_keyvalues for state management - Loop agents have
max_iterations - Parallel agents use unique
output_keyvalues - Tools follow verb-noun naming pattern
- Error handling with graceful degradation
- Appropriate model selection per agent complexity
-
REQUIRE_CONFIRMATIONfor high-stakes operations
Deployment
# Vertex AI Agent Engine (recommended)
adk deploy agent_engine --project=PROJECT_ID --region=us-central1 \
--staging_bucket=gs://BUCKET/staging --agent-file=agent.py
# Cloud Run
adk deploy cloud_run --project=PROJECT_ID --region=us-central1 \
--agent-file=agent.py
See references/adk-deployment.md for Docker, CI/CD, monitoring, and security details.
Error Handling
- If
validate_agent.pyreports issues, fix all CRITICAL/HIGH items before deployment. - If pattern selection is ambiguous, default to Coordinator for routing tasks, Sequential for pipelines.
- If deployment fails, check project permissions and staging bucket access first.
References
references/adk-patterns.md-- 7 design patterns with code examplesreferences/adk-best-practices.md-- Agent design, state management, tools, securityreferences/adk-deployment.md-- Deployment workflows, CI/CD, monitoring, cost optimizationassets/templates/-- Single-agent, multi-agent, workflow starter templates- Google ADK Docs