How abhi8893/genai-shopping-assistant works
The repository’s product is a conversational shopping assistant backed by an e-commerce API. A user submits a query to the assistant service, which maintains a chat and uses a router to direct requests to product search, shopping actions, or customer service. Product retrieval and cart operations are supported by vector search and the e-commerce backend. The README documents the multi-agent workflow; the sampled service entry point shows chat initialization and integrations, but several agent implementations and runtime connections were not sampled, so those links are omitted or marked unverified.
Main entry points: app.py Chat API · router.py Router agent · client.py E-commerce client · service.py Product service
Components 19
Shopping assistant
- Chat API
services/shopping-assistant/app.py - Chat session
packages/shopping-assistant/src/shopping_assistant/chat.py - Router agent
packages/shopping-assistant/src/shopping_assistant/agent_definitions/router.py - Product search
packages/shopping-assistant/src/shopping_assistant/agent_definitions/product_search.py - Shopping actions
packages/shopping-assistant/src/shopping_assistant/agent_definitions/shopping_actions.py - Customer service
packages/shopping-assistant/src/shopping_assistant/agent_definitions/customer_service.py - Agent graph
packages/shopping-assistant/src/shopping_assistant/graph/graph.py
Search and integrations
- Product retrieval
packages/shopping-assistant/src/shopping_assistant/product_retrieval.py - Vector search
- E-commerce client
packages/shopping-assistant/src/shopping_assistant/external/ecom_api_client/client.py
E-commerce backend
- E-commerce API
services/ecom-backend/app.py - Product API
services/ecom-backend/domains/products/api/router.py - Product service
services/ecom-backend/domains/products/service.py - Product repository
services/ecom-backend/domains/products/repository.py - Cart service
services/ecom-backend/domains/carts/service.py - User service
services/ecom-backend/domains/users/service.py
Shared backend
- SQL database
services/ecom-backend/core/database.py - Observability
packages/shopping-assistant/src/shopping_assistant/observability/preflight.py
Other components
- Shopper
Connections 19
- Shopper → Chat API: sends query
services/shopping-assistant/app.py - Chat API → Chat session: creates session
services/shopping-assistant/app.py - Chat API → Observability: sets up logging
services/shopping-assistant/app.py - Chat API → E-commerce client: creates client
services/shopping-assistant/app.py - Chat API → Vector search: connects client
services/shopping-assistant/app.py - Router agent → Product search: routes to
README.md - Router agent → Shopping actions: routes to
README.md - Router agent → Customer service: routes to
README.md - Chat session → Router agent: dispatches via
- Product search → Product retrieval: uses
- Product retrieval → Vector search: searches
- Shopping actions → E-commerce client: uses
- E-commerce client → E-commerce API: calls API
- E-commerce API → Product API: mounts routes
services/ecom-backend/app.py - Product API → Product service: calls
services/ecom-backend/domains/products/api/router.py - Product service → Product repository: delegates to
services/ecom-backend/domains/products/service.py - Cart service → Product service: gets products
services/ecom-backend/domains/carts/service.py - Product repository → SQL database: queries
- User service → SQL database: persists users