Skip to main content
Knowledge is the first tab in Brain, and it’s where most of your agent’s answers come from. There are three sources, and they work together. When a shopper asks something, the agent pulls whatever is relevant, whether that’s a product from your catalog, a page from your site, or a fact you typed in.

Catalog

Your product catalog is the backbone. Connect Shopify and Anagram syncs your products automatically every day, including titles, descriptions, prices, tags, collections, and metafields. The agent uses this to recommend products, answer questions like “does this come in a medium?”, and show product cards in chat. To connect, open Brain, find the Catalog card, and click Connect Shopify. You’ll enter your myshopify.com domain and approve the app install. Full details are on the Shopify page. Once connected, click Manage on the Catalog card to browse and search everything the agent can see. If a product looks wrong here, fix it in Shopify and it will update on the next sync. With web search on, the agent can look up answers on your website in real time. This is how it handles questions your catalog can’t: shipping policies, return windows, brand story, ingredient pages. The Web search card has a few settings:
  • Site to search limits the agent to a specific domain. Leave it blank and it uses your store’s domain.
  • Also search the open web lets the agent look beyond your site. Most brands leave this off so answers stay grounded in their own content.
Web search is on by default. If your site’s policy pages are accurate and current, you’re in good shape without any extra work.

Added knowledge

This is for the facts that live in your head or your team’s Slack, not on your website. The card calls them tribal facts, and that’s the right way to think about it. Examples:
  • “Our candles are made from soy wax”
  • “We don’t offer gift wrapping during December”
  • “The Redwood line is being discontinued; don’t recommend it for restocks”
Click New entry, give it a Title, write the fact, and click Add entry. Each entry is a single fact or a small cluster of related ones. Short, specific entries work better than long documents because the agent retrieves entries individually when they’re relevant.
When you test your agent and it gets something wrong, the fix is usually one knowledge entry away. Ask yourself: where would the agent have found the right answer? If the answer is “nowhere,” add it here.

When changes take effect

Saving a knowledge entry makes it live for shoppers within a few minutes. Catalog changes flow in with the daily Shopify sync, or sooner if you trigger a manual sync.