Product knowledge
In the app: AI → Advanced → Product knowledge
Needs the 'View AI Config' permission.
Product knowledge is the list of facts the AI agent knows about single products: a question and its answer, tied to one product in one store. This page shows those facts, where each one came from and how often it was used, and lets you add, correct, archive and restore them.
What product knowledge is
An entry is one question with one answer about one product of one store, for example which material a jacket is made of. Each entry shows its origin. Later edits are described separately under "Last change":
- "Customer AI, from a conversation": the AI agent saved the answer itself while handling a conversation. "open it" opens that conversation in the Inbox.
- "Added by …": a teammate added it on this page.
- "A Squid Agent proposal": it was created by a Squid Agent proposal that someone approved. A later proposal edit does not replace the original source label.
- "An AI app": it was added through a connected AI app.
- "Squid": no more specific origin is recorded.
The AI agent reads product knowledge when it looks up a product during a conversation. It then gets the active entries of that product in that store, the most recently added first, at most 20. Looking up products and saving facts are AI tools that are switched on per config set; the product lookup tool reads facts and the save tool adds them. Each must be available to the agent for its action to happen. The save tool is also withheld when the agent is preparing drafts rather than sending replies.
An entry only counts for the store it belongs to. The same product in another store needs its own entry.
The row "Product knowledge" in the AI menu is shown in organizations that have Squid Agent. Opening the page needs the 'View AI Config' permission; adding, editing, archiving and restoring need 'Edit AI Config'. A teammate whose access is limited to certain stores only sees and changes entries of those stores.
Search and filters
- Search box ("Search questions and answers"): finds entries whose question, answer, product handle or product ID contains what you typed. Press Enter or click "Search"; the list does not filter while you type.
- Store: "All your stores" or one store.
- Status: "Active" (the default), "Archived" or "All".
The list shows the most recently changed entries first, 50 at a time. An AI look-up updates the entry’s last-change time, so it can move up the list the next time the list is loaded. The store and status filters apply as soon as you choose them. "Show more" loads the next 50 and says how many are left.
An empty list shows "No product knowledge yet." or, after a search, "Nothing matches …".
An entry
Each row shows the question, the answer and a line of details:
- "Active" or "Archived". Only active entries are read by the AI agent.
- the store;
- "Translation out of date", on an entry that is the translation of another store's entry whose question or answer has changed since. Hover over it to see which original changed and when. When a Squid Agent proposal with the new translation is waiting, a link to that proposal is next to it. This badge is only shown to people who can use Squid Agent;
- "Product …": the product's handle or, without one, its ID;
- where the entry came from;
- "Last change": the version number, what was done, by whom and when;
- "Used … times": how often the AI agent received this entry when it looked up the product. It counts look-ups, not whether the fact ended up in the reply. Comparison runs that Squid does in the background are not counted.
Add product knowledge
Needs the 'Edit AI Config' permission.
"Add" at the top right opens the form "Add product knowledge".
- "Store": required. The store the fact is for.
- "Product ID": required, up to 100 characters. The product's ID in Shopify. The AI agent matches entries to a product by this ID or by the handle.
- "Product handle (optional)": the last part of the product's web address in your shop, up to 255 characters.
- "Question": required, up to 1,000 characters.
- "Answer": required, up to 5,000 characters.
"Add" saves the entry as version 1, as active, with your name. The AI agent can use it from its next product look-up. "Cancel" closes the form without saving.
The form does not check that the product ID exists in your shop. An entry with a wrong ID is saved, but the AI agent only finds it when the handle you entered matches the product.
Edit and archive
Needs the 'Edit AI Config' permission.
"Edit" opens the question and the answer of an active entry. The product and the store cannot be changed; to move a fact, archive it and add a new one. "Save as version …" stores changed text as a new version for later product look-ups. Saving identical text creates no version.
If the entry changed after you opened it, your save is refused and nothing is overwritten. The current text is shown under yours; clicking save again replaces it with yours. This also happens when the AI agent used the entry while you were editing: the text shown is then the same as before, and saving again works.
"Archive" takes the entry out of use without asking for confirmation: later product look-ups leave it out. A reply already being prepared may still use facts it has read. Nothing is deleted. The entry moves to the "Archived" filter and keeps its history. An archived entry cannot be edited; bring it back through "History".
There is no delete button. Archiving is the way to remove a fact.
History and restore
"History" opens every version of the entry, newest first. A version shows its number, what happened ("Created", "Updated", "Archived", "Restored version …"), who did it and when, and the question and answer as they were. A version that came from a conversation has the link "From a conversation"; one that came from a Squid Agent proposal has "Open the proposal".
"Restore" on an older version brings back that version's question, answer, product handle and status as a new version, unless all of those values already match the current entry. Restoring a version from before an entry was archived therefore makes the entry active again. The newest version has no "Restore" button, because it is what the entry already is.
Every add, edit, archive and restore is recorded in the audit log under Settings → Audit Log.