How google/adk-python works
ADK is a code-first Python framework for defining agents, composing workflow execution, and connecting tools and models. Its principal path is developer-defined agents and workflows, followed by runtime execution and event/session state; the README also documents evaluation, deployment, and multi-agent delegation. The map preserves those capabilities and key runtime layers. Some major subsystems are represented by their exact tree directories because their implementation files were not sampled; edges are limited to README statements and visible source-index or excerpt evidence.
Main entry points: invocation_context.py Invocation context · base_agent.py Agent definitions · base_tool.py Tool execution · llm_flows LLM flows
Components 23
Agent authoring
- Agent definitions
src/google/adk/agents/base_agent.py - Agent config
src/google/adk/agents/agent_config.py - Workflow composition
src/google/adk/workflow - Task delegation
src/google/adk/a2a
Execution runtime
- Invocation context
src/google/adk/agents/invocation_context.py - LLM flows
src/google/adk/flows/llm_flows - Model requests
src/google/adk/models/llm_request.py - Tool execution
src/google/adk/tools/base_tool.py - Event stream
src/google/adk/events/event.py - Plugin callbacks
src/google/adk/plugins/plugin_manager.py
State and services
- Session state
src/google/adk/sessions/session.py - Session services
src/google/adk/sessions/base_session_service.py - Database sessions
src/google/adk/sessions/database_session_service.py - Artifact services
src/google/adk/artifacts - RAG memory
src/google/adk/memory/vertex_ai_rag_memory_service.py
Tools and integrations
- Authentication
src/google/adk/auth/auth_handler.py - Tool ecosystem
src/google/adk/tools - Code execution
src/google/adk/code_executors
Evaluation and operations
- Agent evaluation
src/google/adk/evaluation - CLI and web UI
src/google/adk/cli/cli.py - Deployment
src/google/adk/cli/deployers
Other components
- Developer
- Agent user
Connections 26
- Developer → Agent definitions: defines
- Developer → Workflow composition: composes
- Agent definitions → Workflow composition: orchestrated by
- Workflow composition → Invocation context: runs with
src/google/adk/agents/invocation_context.py - Agent definitions → Invocation context: runs with
src/google/adk/agents/invocation_context.py - Invocation context → LLM flows: drives
- LLM flows → Model requests: requests
- LLM flows → Tool execution: dispatches
- Tool execution → Tool ecosystem: uses
src/google/adk/tools/base_tool.py - Tool execution → Code execution: can execute
- Invocation context → Event stream: records
src/google/adk/agents/invocation_context.py - Plugin callbacks → Event stream: callbacks receive
src/google/adk/plugins/plugin_manager.py - Session state → Event stream: contains
src/google/adk/sessions/session.py - Session services → Session state: manages
src/google/adk/sessions/base_session_service.py - Database sessions → Session state: persists
src/google/adk/sessions/database_session_service.py - Invocation context → Session services: uses
src/google/adk/agents/invocation_context.py - Invocation context → Artifact services: can access
src/google/adk/agents/invocation_context.py - Invocation context → RAG memory: can access
- Tool execution → Authentication: may require
- Developer → Agent config: configures
- Agent definitions → Task delegation: delegates tasks
- Agent user → CLI and web UI: runs locally
- CLI and web UI → Agent definitions: loads
- Developer → Agent evaluation: evaluates
- Developer → Deployment: deploys
- Deployment → Agent definitions: packages