How mauripsale/doc-adk-training works
This repository is an ADK training course, with the supplied runtime files showing two hands-on sample applications: personalized shopping and lead qualification. The shopping sample turns agent tool calls into actions in a simulated webshop; the lead-qualification sample researches a company, gathers qualification details, and saves the result. The graph focuses on these executable samples rather than the course’s unsupplied module content. Some links are based on the source index’s import/reference lists; unsampled implementation details are not inferred.
Main entry points: agent.py Qualifier Agent · fast_api_app.py API Service · orchestrator.py Shopping Agent · researcher.py Company Researcher
Components 28
Personalized Shopping
- Shopping Agent
sample-agents/personalized-shopping/personalized_shopping/orchestrator.py - Personalization
sample-agents/personalized-shopping/personalized_shopping/personalization_agent.py - Shopping Prompts
sample-agents/personalized-shopping/personalized_shopping/prompt.py - Web Agent
sample-agents/personalized-shopping/personalized_shopping/web_agent.py - Search Tool
sample-agents/personalized-shopping/personalized_shopping/tools/search.py - Click Tool
sample-agents/personalized-shopping/personalized_shopping/tools/click.py
Webshop Runtime
- Environment Setup
sample-agents/personalized-shopping/personalized_shopping/shared_libraries/init_env.py - Text Environment
sample-agents/personalized-shopping/personalized_shopping/shared_libraries/web_agent_site/envs/web_agent_text_env.py - Webshop Engine
sample-agents/personalized-shopping/personalized_shopping/shared_libraries/web_agent_site/engine/engine.py - Goal Scoring
sample-agents/personalized-shopping/personalized_shopping/shared_libraries/web_agent_site/engine/goal.py - Normalization
sample-agents/personalized-shopping/personalized_shopping/shared_libraries/web_agent_site/engine/normalize.py - Product Conversion
sample-agents/personalized-shopping/personalized_shopping/shared_libraries/search_engine/convert_product_file_format.py
Lead Qualification
- API Service
sample-lead-qualifier-agent/app/fast_api_app.py - Qualifier Agent
sample-lead-qualifier-agent/app/agent.py - Qualification Prompts
sample-lead-qualifier-agent/app/prompts.py - Company Researcher
sample-lead-qualifier-agent/app/agents/researcher.py - Save Qualification
sample-lead-qualifier-agent/app/tools.py
Lead Services
- Configuration
sample-lead-qualifier-agent/app/app_utils/config.py - Responsible AI
sample-lead-qualifier-agent/app/rai_service.py - Firestore Sessions
sample-lead-qualifier-agent/app/app_utils/firestore_session.py - Memory Plugin
sample-lead-qualifier-agent/app/app_utils/memory_plugin.py - Telemetry
sample-lead-qualifier-agent/app/app_utils/telemetry.py - Telemetry Plugin
sample-lead-qualifier-agent/app/app_utils/telemetry_plugin.py - API Client
sample-lead-qualifier-agent/utils/api_client.py
Other components
- Shopper
- Lead User
- Google Search
- Cloud Language API
Connections 32
- Shopper → Shopping Agent: requests shopping
- Shopping Agent → Personalization: delegates to
- Shopping Agent → Shopping Prompts: uses prompts
- Shopping Agent → Web Agent: delegates to
- Web Agent → Search Tool: registers tool
sample-agents/personalized-shopping/personalized_shopping/web_agent.py - Web Agent → Click Tool: registers tool
sample-agents/personalized-shopping/personalized_shopping/web_agent.py - Search Tool → Environment Setup: gets environment
sample-agents/personalized-shopping/personalized_shopping/tools/search.py - Click Tool → Environment Setup: gets environment
sample-agents/personalized-shopping/personalized_shopping/tools/click.py - Environment Setup → Text Environment: registers environment
sample-agents/personalized-shopping/personalized_shopping/shared_libraries/init_env.py - Text Environment → Webshop Engine: uses engine
sample-agents/personalized-shopping/personalized_shopping/shared_libraries/web_agent_site/envs/web_agent_text_env.py - Text Environment → Goal Scoring: uses scoring
sample-agents/personalized-shopping/personalized_shopping/shared_libraries/web_agent_site/envs/web_agent_text_env.py - Webshop Engine → Goal Scoring: delegates to
- Goal Scoring → Normalization: uses normalization
sample-agents/personalized-shopping/personalized_shopping/shared_libraries/web_agent_site/engine/goal.py - Product Conversion → Webshop Engine: references engine
sample-agents/personalized-shopping/personalized_shopping/shared_libraries/search_engine/convert_product_file_format.py - Lead User → API Client: sends requests
- API Client → API Service: calls API
- API Service → Qualifier Agent: serves agent
sample-lead-qualifier-agent/app/fast_api_app.py - Qualifier Agent → Qualification Prompts: uses prompts
sample-lead-qualifier-agent/app/agent.py - Qualifier Agent → Company Researcher: delegates to
sample-lead-qualifier-agent/app/agent.py - Company Researcher → Qualification Prompts: uses instructions
sample-lead-qualifier-agent/app/agents/researcher.py - Company Researcher → Configuration: reads settings
sample-lead-qualifier-agent/app/agents/researcher.py - Company Researcher → Google Search: searches with
sample-lead-qualifier-agent/app/agents/researcher.py - Qualifier Agent → Save Qualification: registers tool
sample-lead-qualifier-agent/app/agent.py - Qualifier Agent → Configuration: reads settings
sample-lead-qualifier-agent/app/agent.py - Qualifier Agent → Responsible AI: configures plugin
sample-lead-qualifier-agent/app/agent.py - Responsible AI → Configuration: reads settings
sample-lead-qualifier-agent/app/rai_service.py - Responsible AI → Cloud Language API: moderates text
sample-lead-qualifier-agent/app/rai_service.py - API Service → Firestore Sessions: uses sessions
sample-lead-qualifier-agent/app/fast_api_app.py - API Service → Telemetry: uses telemetry
sample-lead-qualifier-agent/app/fast_api_app.py - API Service → Telemetry Plugin: configures plugin
sample-lead-qualifier-agent/app/fast_api_app.py - API Service → Configuration: reads settings
sample-lead-qualifier-agent/app/fast_api_app.py - Qualifier Agent → Memory Plugin: saves session memory
sample-lead-qualifier-agent/app/agent.py