How omarcevi/adk-multi-agent-intro works
This repository is a Google ADK teaching demo for a research assistant that evolves from a single tool-using agent to sequential, parallel, iterative, and coordinator-selected agent patterns. The main user workflow is step 5: a coordinator routes a request either to a quick-answer agent or to a web-research-and-brief pipeline. Earlier steps demonstrate date lookup and alternative brief-writing workflows. Edges reflect the shown agent declarations, state keys, and README workflow; the ADK runtime and model internals are not sampled.
Main entry points: step3_parallel/agent.py Research team · step5_coordinator/agent.py Brief pipeline · step4_loop/agent.py Critic · step2_sequential/agent.py Brief pipeline
Components 27
Entry and date demo
- Date assistant
step1_single_agent/agent.py - Date function
step1_single_agent/agent.py
Sequential research
- Brief pipeline
step2_sequential/agent.py - Researcher
step2_sequential/agent.py - Brief writer
step2_sequential/agent.py
Parallel research
- Brief pipeline
step3_parallel/agent.py - Research team
step3_parallel/agent.py - Background researcher
step3_parallel/agent.py - Current-state researcher
step3_parallel/agent.py - Future-outlook researcher
step3_parallel/agent.py - Brief writer
step3_parallel/agent.py
Draft review
- Brief pipeline
step4_loop/agent.py - First-draft writer
step4_loop/agent.py - Improvement loop
step4_loop/agent.py - Critic
step4_loop/agent.py - Reviser
step4_loop/agent.py
Coordinator workflow
- Front desk
step5_coordinator/agent.py - Quick answer
step5_coordinator/agent.py - Brief pipeline
step5_coordinator/agent.py - Web researcher
step5_coordinator/agent.py - First-draft writer
step5_coordinator/agent.py - Improvement loop
step5_coordinator/agent.py - Critic
step5_coordinator/agent.py - Reviser
step5_coordinator/agent.py
Other components
- User
- ADK Web
- Google Search
Connections 37
- User → ADK Web: submits prompt
README.md - ADK Web → Date assistant: selects demo
README.md - ADK Web → Brief pipeline: selects demo
README.md - ADK Web → Brief pipeline: selects demo
README.md - ADK Web → Brief pipeline: selects demo
README.md - ADK Web → Front desk: selects demo
README.md - Date assistant → Date function: calls
step1_single_agent/agent.py - Brief pipeline → Researcher: runs first
step2_sequential/agent.py - Brief pipeline → Brief writer: runs second
step2_sequential/agent.py - Researcher → Brief writer: shares research
step2_sequential/agent.py - Brief pipeline → Research team: runs first
step3_parallel/agent.py - Brief pipeline → Brief writer: runs after
step3_parallel/agent.py - Research team → Background researcher: runs in parallel
step3_parallel/agent.py - Research team → Current-state researcher: runs in parallel
step3_parallel/agent.py - Research team → Future-outlook researcher: runs in parallel
step3_parallel/agent.py - Background researcher → Brief writer: shares notes
step3_parallel/agent.py - Current-state researcher → Brief writer: shares notes
step3_parallel/agent.py - Future-outlook researcher → Brief writer: shares notes
step3_parallel/agent.py - Brief pipeline → First-draft writer: runs first
step4_loop/agent.py - Brief pipeline → Improvement loop: runs after
step4_loop/agent.py - Improvement loop → Critic: runs in loop
step4_loop/agent.py - Improvement loop → Reviser: runs in loop
step4_loop/agent.py - First-draft writer → Critic: shares draft
step4_loop/agent.py - Critic → Reviser: shares feedback
step4_loop/agent.py - Reviser → Critic: updates draft
step4_loop/agent.py - Front desk → Quick answer: routes request
step5_coordinator/agent.py - Front desk → Brief pipeline: routes request
step5_coordinator/agent.py - Brief pipeline → Web researcher: runs first
step5_coordinator/agent.py - Brief pipeline → First-draft writer: runs second
step5_coordinator/agent.py - Brief pipeline → Improvement loop: runs third
step5_coordinator/agent.py - Web researcher → Google Search: searches web
step5_coordinator/agent.py - Web researcher → First-draft writer: shares research
step5_coordinator/agent.py - Improvement loop → Critic: runs in loop
step5_coordinator/agent.py - Improvement loop → Reviser: runs in loop
step5_coordinator/agent.py - First-draft writer → Critic: shares draft
step5_coordinator/agent.py - Critic → Reviser: shares feedback
step5_coordinator/agent.py - Reviser → Critic: updates draft
step5_coordinator/agent.py