Product datasheet — live prototype

An AI retrieval & agent layer for WooCommerce.

Runtime
Python · FastAPI sidecar
Platform
WooCommerce · no theme lock-in
Catalogue
23,591 products
Surfaces
chat · search · generation
Status
running

The layer runs beside a live WooCommerce store. It resolves plain-language requests to real, in-stock catalogue items through a tool-using agent and a vector index, mirrors its results into the store's native filters and cart, and generates the store's promotional assets. Every capability documented below is running against the live catalogue.

§1Agent

A tool-using chat agent over the catalogue.

It runs a clarify-then-retrieve loop: an underspecified request triggers a question rather than an inferred answer; a specified one issues a semantic query, maps the results onto the store's filters, and writes to the cart only on explicit instruction. Conversation state is checkpointed per session, so context survives across turns and restarts.

outfit for a beach rehearsal dinner
linen, or flowier? colours to rule in or out?
flowy, warm tones — nothing beige
3 in-stock matches under those constraints; confirm to add to cart
Transcript — illustrative, no fixed script
Loop
clarify → retrieve → present
Guardrail
never infers gender / age / body type
Grounding
results limited to real, in-stock items
Cart
explicit user intent only
State
per-session checkpoints
§2Retrieval

Vector retrieval, not keyword match.

Queries are embedded and matched by nearest-neighbour against an index of the catalogue, so a phrase like warm but not bulky retrieves relevant products even when those tokens appear in no listing. Stated hard constraints are applied as filters, not blended into the similarity score; an empty constrained set returns the nearest candidates — flagged — rather than a relaxed match.

Method
embed → k-NN over catalogue
Grounding
guessed attributes → real taxonomy terms (RAG)
Constraints
price · gender · stock, as filters
Empty set
honest "closest" — never relaxed
Taxonomy
duplicates & overlaps reconciled at query time
§3Generation

The same service makes the store's marketing.

A product plus a free-text brief composes a correctly-sized banner from the product and copy; the output is written to object storage and published into the homepage banner slot. Banners re-render on demand, extend into a short product video, or push to a CRM as a hosted landing page.

Input
product + free-text brief
Output
banner · 1K–4K · fast or premium model
Publish
object store → homepage slot
Extend
→ short product video
Distribute
→ CRM hosted landing page
Run it

Everything above is live on this storefront.

Open the shop and query the agent, or search the way you'd describe a product out loud — against the live 23,591-product catalogue.

A live prototype by AWS GALAXY
Shopping Cart
Scroll to Top