Getting Started

The Shopping Assistant is delivered as a fully managed service. You add a small snippet to your storefront, and it loads a launcher that opens the chat panel. Everything else — the agent, the catalogue search, the model — runs on Google Cloud, scoped to your storefront key.

Add the snippet

Drop the loader script near the end of your <body>, with your storefront key. It is loaded asynchronously and never blocks rendering.
```
<script
  src="https://assistant.thgingenuity.com/loader.js"
  data-storefront="your-storefront-key"
  async
></script>
```
Choose where the launcher mounts. By default it docks to the bottom-right of the viewport. To anchor it to your own element instead, give the loader a target selector:
```
<script
  src="https://assistant.thgingenuity.com/loader.js"
  data-storefront="your-storefront-key"
  data-target="#ask-assistant"
  async
></script>
```
Ship it. The launcher appears on the next deploy. Opening it starts a session scoped to your storefront; the assistant answers from your live catalogue.

Verify it works

Open your storefront and click the launcher. Ask something a shopper would ask — for example “what should I take after a workout?” You should see:

A short, on-brand reply.
One or more product cards drawn from your catalogue, with live prices.
Suggested follow-up chips that continue the conversation.

If the panel opens but answers are empty or generic, the storefront key is likely not yet pointed at your catalogue — contact your THG Ingenuity representative.

Next steps

How it works Understand the reasoning loop behind every answer.

Theming Set your colour, the assistant's name, avatar, and greeting.

Trust & safety How grounding, moderation, and isolation protect your brand.

Support Status, contacts, and how to get help.