ADK Agent Builder

This file serves as a directory of specialized reference guides for developing agents with ADK. To avoid context pollution, read only the relevant reference file based on your current task.

Core Concepts Directory

Refer to these files for foundational knowledge:

• Getting Started & Basic Agents: getting-started.md
  • Environment setup, API key configuration, and minimal agent definitions.
• Tool Catalog: tool-catalog.md
  • How to bind function tools, MCP tools, OpenAPI specs, and Google API tools.
• Agent Modes (Task / Single-Turn): task-mode.md
  • Multi-turn structured delegation and autonomous single-turn execution patterns.
• Import Paths: import-paths.md
  • Canonical and verbose import paths for core components, tools, and events.

Workflow & Graph Orchestration

Refer to these files when building complex graphs:

• Function Nodes: function-nodes.md
  • How to use functions as nodes, type resolution, and generators.
• Routing & Conditions: routing-and-conditions.md
  • Edge patterns, dict-based routing, self-loops, and conditional execution.
• LLM Agent Nodes: llm-agent-nodes.md
  • How to use LLM agents as workflow nodes, task wrappers, and handling output schemas.
• Advanced Patterns: advanced-patterns.md
  • Nested workflows, custom node types, and graph validation rules.

Advanced Orchestration Patterns

• Parallel Processing & Fan-Out: parallel-and-fanout.md
  • ParallelWorker for list splitting and concurrent processing, fan-out/join patterns.
• Human-in-the-Loop: human-in-the-loop.md
  • Pausing execution for user input, resumable workflows, and AuthConfig on nodes.
• Dynamic Nodes: dynamic-nodes.md
  • Scheduling nodes at runtime dynamically via ctx.run_node().

Infrastructure & Utilities

• State & Events: state-and-events.md
  • Using context API, sharing global state, and yield event structures.
• Session & Memory: session-and-state.md
  • Session state mutation, scope conventions, and database session services.
• Callbacks & Plugins: callbacks-and-plugins.md
  • Implementing callbacks, plugin manager integration, and override behavior.
• Multi-Agent Systems: multi-agent.md
  • Hierarchical execution (e.g., SequentialAgent, LoopAgent, ParallelAgent).
• Testing Strategies: testing.md
  • Automated queries with adk run, unit tests, and integration testing with sample agents.

Standards & Guidelines

• Best Practices: best-practices.md
  • Critical rules (Pydantic schemas, content events, state-based data flow).