How genaidevelopment/demo-hero-production-zero works
This repository is a hands-on AI reliability workshop, not a deployed QuickBasket service. Its principal learning workflow moves from asking a policy question (prompt-only, then retrieval with citations) to giving a support agent narrowly scoped refund tools and checking whether its actions were safe. The map also preserves the documented help-centre generation and major knowledge domains. Notebook internals were not sampled, so notebook-to-runtime relationships are based on the README; unsampled implementation links are omitted.
Main entry points: render.py Document rendering · common.py KB facts and conflicts · build_kb.py Help-centre build · faq.py Customer FAQ
Components 23
Workshop workflows
- Policy Q&A
quickbasket/myth1_prompt_is_enough.ipynb - Refund agent
quickbasket/myth2_agent_with_tools.ipynb
Knowledge base
- Help-centre build
quickbasket/build_kb.py - Customer policies
quickbasket/kb_src/policies.py - City addenda
quickbasket/kb_src/cities.py - Customer FAQ
quickbasket/kb_src/faq.py - Agent playbook
quickbasket/kb_src/playbook.py - Promotions
quickbasket/kb_src/promos.py - Promo details
quickbasket/kb_src/promo_detail.py - Membership terms
quickbasket/kb_src/terms.py - Partner SOP
quickbasket/kb_src/sop.py - Warranty directory
quickbasket/kb_src/warranty.py - KB facts and conflicts
quickbasket/kb_src/common.py - Document rendering
quickbasket/kb_src/render.py - Document chunking
quickbasket/kb_chunker.py - Help-centre documents
quickbasket/kb
Refund agent
- Narrow MCP tools
quickbasket/qb_mcp_server.py - Synthetic orders
quickbasket/quickbasket.db - Refund safety audit
quickbasket/refund_audit.py
Shared runtime
- Gemini helpers
common/gemini_helpers.py - Cached embeddings
common/cached_embeddings.py - Pricing helpers
common/pricing.py
Other components
- Workshop participant
Connections 22
- Workshop participant → Policy Q&A: asks policy questions
README.md - Policy Q&A → Help-centre documents: retrieves with citations
README.md - Workshop participant → Refund agent: tests refund requests
README.md - Refund agent → Narrow MCP tools: uses narrow tools
README.md - Refund agent → Refund safety audit: checks agent safety
README.md - Help-centre build → Help-centre documents: builds documents
README.md - Help-centre build → Customer policies: imports policy data
quickbasket/build_kb.py - Help-centre build → KB facts and conflicts: imports shared facts
quickbasket/build_kb.py - Help-centre build → Document rendering: imports renderers
quickbasket/build_kb.py - Promotions → Promo details: uses campaign details
quickbasket/kb_src/promos.py - City addenda → KB facts and conflicts: imports shared facts
quickbasket/kb_src/cities.py - City addenda → Document rendering: writes documents
quickbasket/kb_src/cities.py - Customer FAQ → City addenda: uses city data
quickbasket/kb_src/faq.py - Customer FAQ → Warranty directory: uses warranty data
quickbasket/kb_src/faq.py - Customer FAQ → Document rendering: uses rendering
quickbasket/kb_src/faq.py - Agent playbook → KB facts and conflicts: imports shared facts
quickbasket/kb_src/playbook.py - Agent playbook → Document rendering: uses rendering
quickbasket/kb_src/playbook.py - Partner SOP → KB facts and conflicts: imports shared facts
quickbasket/kb_src/sop.py - Partner SOP → Document rendering: uses rendering
quickbasket/kb_src/sop.py - Warranty directory → KB facts and conflicts: imports shared facts
quickbasket/kb_src/warranty.py - Warranty directory → Document rendering: uses rendering
quickbasket/kb_src/warranty.py - Cached embeddings → Gemini helpers: calls retry helper
common/cached_embeddings.py