retail-agent-learner
Learn ADK concepts and understand the retail agent pipeline. Use when asking how the agent works, what ADK is, wanting to understand the architecture, state flow, or individual agent purposes.
📖 中文导读:Learn ADK concepts and understand the retail agent pipeline. Use when asking how the agent works, what ADK is, wanting to understand the architecture, state flow, or individual agent purposes. 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: retail-agent-learner description: Learn ADK concepts and understand the retail agent pipeline. Use when asking how the agent works, what ADK is, wanting to understand the architecture, state flow, or individual agent purposes.
Retail Agent Learner
Pipeline Overview
This is an 8-agent pipeline for retail site selection analysis:
User Query
↓
IntakeAgent ────────────→ Extract location + business type
↓
MarketResearchAgent ────→ Google Search for demographics
↓
CompetitorMappingAgent ─→ Google Maps Places API
↓
GapAnalysisAgent ───────→ Python code execution (pandas)
↓
StrategyAdvisorAgent ───→ Extended thinking synthesis
↓
ParallelAgent ──────────→ Concurrent artifact generation
├── ReportGenerator ─→ HTML report
├── InfographicAgent → Image generation
└── AudioOverview ───→ TTS podcast audio
What Each Agent Does
| Agent | Purpose | Key Tool/Feature |
|---|---|---|
| IntakeAgent | Parse user request | AgentTool pattern |
| MarketResearchAgent | Find market data | google_search built-in |
| CompetitorMappingAgent | Map competitors | Google Maps API |
| GapAnalysisAgent | Calculate viability | Code execution (pandas) |
| StrategyAdvisorAgent | Synthesize recommendations | Extended thinking |
| ReportGenerator | Create HTML report | Artifact generation |
| InfographicAgent | Generate visual | Image generation |
| AudioOverview | Create podcast audio | TTS multi-speaker |
Key ADK Concepts
Agents
- LlmAgent: Single LLM call with tools and instructions
- SequentialAgent: Runs sub-agents one after another
- ParallelAgent: Runs sub-agents concurrently
State Flow
Data passes between agents via session state:
IntakeAgent → state["target_location"], state["business_type"]
MarketResearchAgent → state["market_research_findings"]
CompetitorMappingAgent → state["competitor_analysis"]
GapAnalysisAgent → state["gap_analysis"]
StrategyAdvisorAgent → state["strategic_report"]
Tools
Functions that agents can call to perform actions. Access state via ToolContext.
Callbacks
Lifecycle hooks: before_agent_callback and after_agent_callback.
Learning Path
Start with the 9-part tutorial series:
- Part 1: Setup + First Agent
- Part 2: IntakeAgent
- Part 3: MarketResearchAgent
- Part 4: CompetitorMappingAgent
- Part 5: GapAnalysisAgent (code execution)
- Part 6: StrategyAdvisorAgent (extended thinking)
- Part 7: ArtifactGeneration (parallel outputs)
- Part 8: Testing
- Part 9: Production Deployment
[See references/architecture.md for detailed data flow] [See references/adk-concepts.md for ADK deep dive]