# mauripsale/doc-adk-training architecture

> Architecture diagram of the GitHub repository mauripsale/doc-adk-training, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mauripsale/doc-adk-training
- Repository: https://github.com/mauripsale/doc-adk-training

## Overview

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: [`sample-lead-qualifier-agent/app/agent.py`](https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/agent.py) (Qualifier Agent), [`sample-lead-qualifier-agent/app/fast_api_app.py`](https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/fast_api_app.py) (API Service), [`sample-agents/personalized-shopping/personalized_shopping/orchestrator.py`](https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/orchestrator.py) (Shopping Agent), [`sample-lead-qualifier-agent/app/agents/researcher.py`](https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/agents/researcher.py) (Company Researcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shopping["Personalized Shopping"]
  node_shopping_agent["Shopping Agent<br/>[orchestrator.py]"]
  node_personalization["Personalization"]
  node_shopping_prompt["Shopping Prompts<br/>[prompt.py]"]
  node_web_agent["Web Agent<br/>[web_agent.py]"]
  node_search_tool["Search Tool<br/>[search.py]"]
  node_click_tool["Click Tool<br/>[click.py]"]
end

subgraph group_webshop["Webshop Runtime"]
  node_env_setup["Environment Setup<br/>[init_env.py]"]
  node_text_env["Text Environment"]
  node_web_engine["Webshop Engine<br/>[engine.py]"]
  node_goal_scoring["Goal Scoring<br/>[goal.py]"]
  node_normalization["Normalization<br/>[normalize.py]"]
  node_product_conversion["Product Conversion"]
end

subgraph group_lead["Lead Qualification"]
  node_lead_api["API Service<br/>[fast_api_app.py]"]
  node_lead_agent["Qualifier Agent<br/>[agent.py]"]
  node_lead_prompts["Qualification Prompts<br/>[prompts.py]"]
  node_researcher["Company Researcher<br/>[researcher.py]"]
  node_qualification_tool["Save Qualification<br/>[tools.py]"]
end

subgraph group_lead_services["Lead Services"]
  node_configuration["Configuration<br/>[config.py]"]
  node_rai["Responsible AI<br/>[rai_service.py]"]
  node_firestore[("Firestore Sessions")]
  node_memory["Memory Plugin<br/>[memory_plugin.py]"]
  node_telemetry["Telemetry<br/>[telemetry.py]"]
  node_telemetry_plugin["Telemetry Plugin"]
  node_api_client["API Client<br/>[api_client.py]"]
end

node_shopper(("Shopper"))
node_lead_user(("Lead User"))
node_company_search["Google Search"]
node_cloud_language["Cloud Language API"]

node_shopper -.->|"requests shopping"| node_shopping_agent
node_shopping_agent -.->|"delegates to"| node_personalization
node_shopping_agent -.->|"uses prompts"| node_shopping_prompt
node_shopping_agent -.->|"delegates to"| node_web_agent
node_web_agent -->|"registers tool"| node_search_tool
node_web_agent -->|"registers tool"| node_click_tool
node_search_tool -->|"gets environment"| node_env_setup
node_click_tool -->|"gets environment"| node_env_setup
node_env_setup -->|"registers environment"| node_text_env
node_text_env -->|"uses engine"| node_web_engine
node_text_env -->|"uses scoring"| node_goal_scoring
node_web_engine -.->|"delegates to"| node_goal_scoring
node_goal_scoring -->|"uses normalization"| node_normalization
node_product_conversion -->|"references engine"| node_web_engine
node_lead_user -.->|"sends requests"| node_api_client
node_api_client -.->|"calls API"| node_lead_api
node_lead_api -->|"serves agent"| node_lead_agent
node_lead_agent -->|"uses prompts"| node_lead_prompts
node_lead_agent -->|"delegates to"| node_researcher
node_researcher -->|"uses instructions"| node_lead_prompts
node_researcher -->|"reads settings"| node_configuration
node_researcher -->|"searches with"| node_company_search
node_lead_agent -->|"registers tool"| node_qualification_tool
node_lead_agent -->|"reads settings"| node_configuration
node_lead_agent -->|"configures plugin"| node_rai
node_rai -->|"reads settings"| node_configuration
node_rai -->|"moderates text"| node_cloud_language
node_lead_api -->|"uses sessions"| node_firestore
node_lead_api -->|"uses telemetry"| node_telemetry
node_lead_api -->|"configures plugin"| node_telemetry_plugin
node_lead_api -->|"reads settings"| node_configuration
node_lead_agent -->|"saves session memory"| node_memory

click node_shopping_agent "https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/orchestrator.py"
click node_personalization "https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/personalization_agent.py"
click node_shopping_prompt "https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/prompt.py"
click node_web_agent "https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/web_agent.py"
click node_search_tool "https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/tools/search.py"
click node_click_tool "https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/tools/click.py"
click node_env_setup "https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/shared_libraries/init_env.py"
click node_text_env "https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/shared_libraries/web_agent_site/envs/web_agent_text_env.py"
click node_web_engine "https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/shared_libraries/web_agent_site/engine/engine.py"
click node_goal_scoring "https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/shared_libraries/web_agent_site/engine/goal.py"
click node_normalization "https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/shared_libraries/web_agent_site/engine/normalize.py"
click node_product_conversion "https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/shared_libraries/search_engine/convert_product_file_format.py"
click node_lead_api "https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/fast_api_app.py"
click node_lead_agent "https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/agent.py"
click node_lead_prompts "https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/prompts.py"
click node_researcher "https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/agents/researcher.py"
click node_qualification_tool "https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/tools.py"
click node_configuration "https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/app_utils/config.py"
click node_rai "https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/rai_service.py"
click node_firestore "https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/app_utils/firestore_session.py"
click node_memory "https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/app_utils/memory_plugin.py"
click node_telemetry "https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/app_utils/telemetry.py"
click node_telemetry_plugin "https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/app_utils/telemetry_plugin.py"
click node_api_client "https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/utils/api_client.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_shopping_agent,node_personalization,node_shopping_prompt,node_web_agent,node_search_tool,node_click_tool,node_lead_user toneBlue
class node_env_setup,node_text_env,node_web_engine,node_goal_scoring,node_normalization,node_product_conversion toneAmber
class node_lead_api,node_lead_agent,node_lead_prompts,node_researcher,node_qualification_tool,node_cloud_language toneMint
class node_configuration,node_rai,node_firestore,node_memory,node_telemetry,node_telemetry_plugin,node_api_client toneRose
class node_shopper,node_company_search toneIndigo
```

## Components

### Personalized Shopping

- [Shopping Agent](https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/orchestrator.py): `sample-agents/personalized-shopping/personalized_shopping/orchestrator.py`
- [Personalization](https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/personalization_agent.py): `sample-agents/personalized-shopping/personalized_shopping/personalization_agent.py`
- [Shopping Prompts](https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/prompt.py): `sample-agents/personalized-shopping/personalized_shopping/prompt.py`
- [Web Agent](https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/web_agent.py): `sample-agents/personalized-shopping/personalized_shopping/web_agent.py`
- [Search Tool](https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/tools/search.py): `sample-agents/personalized-shopping/personalized_shopping/tools/search.py`
- [Click Tool](https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/tools/click.py): `sample-agents/personalized-shopping/personalized_shopping/tools/click.py`

### Webshop Runtime

- [Environment Setup](https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/shared_libraries/init_env.py): `sample-agents/personalized-shopping/personalized_shopping/shared_libraries/init_env.py`
- [Text Environment](https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/shared_libraries/web_agent_site/envs/web_agent_text_env.py): `sample-agents/personalized-shopping/personalized_shopping/shared_libraries/web_agent_site/envs/web_agent_text_env.py`
- [Webshop Engine](https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/shared_libraries/web_agent_site/engine/engine.py): `sample-agents/personalized-shopping/personalized_shopping/shared_libraries/web_agent_site/engine/engine.py`
- [Goal Scoring](https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/shared_libraries/web_agent_site/engine/goal.py): `sample-agents/personalized-shopping/personalized_shopping/shared_libraries/web_agent_site/engine/goal.py`
- [Normalization](https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/shared_libraries/web_agent_site/engine/normalize.py): `sample-agents/personalized-shopping/personalized_shopping/shared_libraries/web_agent_site/engine/normalize.py`
- [Product Conversion](https://github.com/mauripsale/doc-adk-training/blob/main/sample-agents/personalized-shopping/personalized_shopping/shared_libraries/search_engine/convert_product_file_format.py): `sample-agents/personalized-shopping/personalized_shopping/shared_libraries/search_engine/convert_product_file_format.py`

### Lead Qualification

- [API Service](https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/fast_api_app.py): `sample-lead-qualifier-agent/app/fast_api_app.py`
- [Qualifier Agent](https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/agent.py): `sample-lead-qualifier-agent/app/agent.py`
- [Qualification Prompts](https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/prompts.py): `sample-lead-qualifier-agent/app/prompts.py`
- [Company Researcher](https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/agents/researcher.py): `sample-lead-qualifier-agent/app/agents/researcher.py`
- [Save Qualification](https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/tools.py): `sample-lead-qualifier-agent/app/tools.py`

### Lead Services

- [Configuration](https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/app_utils/config.py): `sample-lead-qualifier-agent/app/app_utils/config.py`
- [Responsible AI](https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/rai_service.py): `sample-lead-qualifier-agent/app/rai_service.py`
- [Firestore Sessions](https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/app_utils/firestore_session.py): `sample-lead-qualifier-agent/app/app_utils/firestore_session.py`
- [Memory Plugin](https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/app_utils/memory_plugin.py): `sample-lead-qualifier-agent/app/app_utils/memory_plugin.py`
- [Telemetry](https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/app_utils/telemetry.py): `sample-lead-qualifier-agent/app/app_utils/telemetry.py`
- [Telemetry Plugin](https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/app/app_utils/telemetry_plugin.py): `sample-lead-qualifier-agent/app/app_utils/telemetry_plugin.py`
- [API Client](https://github.com/mauripsale/doc-adk-training/blob/main/sample-lead-qualifier-agent/utils/api_client.py): `sample-lead-qualifier-agent/utils/api_client.py`

### Other components

- **Shopper**
- **Lead User**
- **Google Search**
- **Cloud Language API**

## Connections

- 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 (evidence: `sample-agents/personalized-shopping/personalized_shopping/web_agent.py`)
- Web Agent → Click Tool: registers tool (evidence: `sample-agents/personalized-shopping/personalized_shopping/web_agent.py`)
- Search Tool → Environment Setup: gets environment (evidence: `sample-agents/personalized-shopping/personalized_shopping/tools/search.py`)
- Click Tool → Environment Setup: gets environment (evidence: `sample-agents/personalized-shopping/personalized_shopping/tools/click.py`)
- Environment Setup → Text Environment: registers environment (evidence: `sample-agents/personalized-shopping/personalized_shopping/shared_libraries/init_env.py`)
- Text Environment → Webshop Engine: uses engine (evidence: `sample-agents/personalized-shopping/personalized_shopping/shared_libraries/web_agent_site/envs/web_agent_text_env.py`)
- Text Environment → Goal Scoring: uses scoring (evidence: `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 (evidence: `sample-agents/personalized-shopping/personalized_shopping/shared_libraries/web_agent_site/engine/goal.py`)
- Product Conversion → Webshop Engine: references engine (evidence: `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 (evidence: `sample-lead-qualifier-agent/app/fast_api_app.py`)
- Qualifier Agent → Qualification Prompts: uses prompts (evidence: `sample-lead-qualifier-agent/app/agent.py`)
- Qualifier Agent → Company Researcher: delegates to (evidence: `sample-lead-qualifier-agent/app/agent.py`)
- Company Researcher → Qualification Prompts: uses instructions (evidence: `sample-lead-qualifier-agent/app/agents/researcher.py`)
- Company Researcher → Configuration: reads settings (evidence: `sample-lead-qualifier-agent/app/agents/researcher.py`)
- Company Researcher → Google Search: searches with (evidence: `sample-lead-qualifier-agent/app/agents/researcher.py`)
- Qualifier Agent → Save Qualification: registers tool (evidence: `sample-lead-qualifier-agent/app/agent.py`)
- Qualifier Agent → Configuration: reads settings (evidence: `sample-lead-qualifier-agent/app/agent.py`)
- Qualifier Agent → Responsible AI: configures plugin (evidence: `sample-lead-qualifier-agent/app/agent.py`)
- Responsible AI → Configuration: reads settings (evidence: `sample-lead-qualifier-agent/app/rai_service.py`)
- Responsible AI → Cloud Language API: moderates text (evidence: `sample-lead-qualifier-agent/app/rai_service.py`)
- API Service → Firestore Sessions: uses sessions (evidence: `sample-lead-qualifier-agent/app/fast_api_app.py`)
- API Service → Telemetry: uses telemetry (evidence: `sample-lead-qualifier-agent/app/fast_api_app.py`)
- API Service → Telemetry Plugin: configures plugin (evidence: `sample-lead-qualifier-agent/app/fast_api_app.py`)
- API Service → Configuration: reads settings (evidence: `sample-lead-qualifier-agent/app/fast_api_app.py`)
- Qualifier Agent → Memory Plugin: saves session memory (evidence: `sample-lead-qualifier-agent/app/agent.py`)
