Skip to content

Add training documents and choose which agents use them

Create a folder under Assistant > Trainings, add files, snippets, webpages or product documents to it, then select the folder under Training datasets on each agent's General tab. An agent uses the files, snippets and webpages in the folders attached to it.

Use this guide when the AI Shopping Assistant cannot answer a shopper’s question because the information is not in your product catalog. The Training data settings reference lists every content type and field.

Create the folder and its content first. An agent can only use a folder that already exists: you pick it under Training datasets on the agent’s General tab. A product document applies to the products you pick under Product SKUs when you add it, at least one and as many as it covers.

Add training documents

  1. Go to Assistant > Trainings and select Create a folder. Name it with letters, numbers, hyphens or underscores.
  2. Select Create folder, open the folder and select Add new.
  3. Pick the type of content. For a short policy, select Snippet, give it a name and enter the Content.
  4. Select Save. The item shows Completed when it is ready, which can take a while.
  5. Open the agent. On the General tab, select the folder under Training datasets and select Save.
  1. Go to Assistant > Trainings and select Create a folder.
  2. Under Folder name, enter a name and select Create folder. Folder names can use letters, numbers, hyphens and underscores only, for example shipping-delivery.
  3. Open the folder and select Add new.
  4. Choose the type of content to add:
    • Files for a document you already have, such as a size chart or care guide. Accepts PNG, JPEG, JPG, PDF and DOCX.
    • Snippet for a short policy or fact. Enter a name and the Content.
    • Webpages for a policy or help page on your site. Enter the URL. Each entry imports one page. It does not update on its own when the page on your site changes. Select Resync in its row menu to fetch it again.
    • Product documents for content that applies to certain products only, such as a spec sheet or manual. Upload a PDF or DOCX file or paste the text, then select the products under Product SKUs.
  5. Repeat for each item, then wait until every item in the folder shows Completed. Processing can take a while, sometimes an hour or more.
  6. Go to Assistant > Agents and open the agent that should use this content.
  7. On the General tab, select the folder under Training datasets and select Save.
  8. Open Advanced settings and check that the Customer Support and RAG Agent specialist agents are switched on. Answers that use Trainings content come mainly from these two.

Open your agent and select Playground to open the Playground panel, then ask the question a shopper would ask. The Playground answers from saved settings. It answers only when the agent is active. An agent that isn’t active replies that the service is inactive. Try a few phrasings, including a short one and one with a typo. The AI Shopping Assistant should answer with the facts from your new content. See Test changes in the Playground for more ways to test.

Write content the AI Shopping Assistant can find

Section titled “Write content the AI Shopping Assistant can find”

The AI Shopping Assistant searches your attached folders for the content that best matches each question. It does not read every item on every answer, so content written for retrieval works better.

  • Keep each snippet to one topic. Separate snippets for returns and exchanges work better than one snippet covering both.
  • Use the words your shoppers use. If shoppers say “send back,” include that phrase alongside “return.”
  • Make each snippet make sense on its own. Avoid references like “as above.”
  • Write facts out in full, such as “Returns are accepted within 30 days of delivery for unworn items.”

When a policy changes, update Trainings at the same time. Delete the old item and add the new version so the AI Shopping Assistant does not answer from outdated content.

For a webpage, update the page on your site first. Then open the webpage’s row menu in the folder and select Resync. To resync every webpage in the folder, select Resync webpages at the top of the folder and confirm with Resync. Don’t delete a webpage and add the same URL again. Webscale AI skips a URL it imported in the last 24 hours. Resync has no such limit.

To stop agents from using a folder for a while without deleting it, archive the folder. Its files, snippets and webpages drop out of answers until you unarchive it.

Problem Fix
The AI Shopping Assistant says it does not have the information Check that the folder is selected under Training datasets on the agent’s General tab and that the item shows Completed
Answers still ignore Trainings content Check that Customer Support and RAG Agent are switched on in Advanced settings
The folder or snippet name is rejected Remove spaces and special characters. Use letters, numbers, hyphens or underscores
A file will not upload Convert it to PNG, JPEG, JPG, PDF or DOCX
An item shows Failed Check that the file opens or the page loads in a browser. For a webpage, select Resync in its row menu. For other items, delete the item and add it again. Contact Webscale support if it fails a second time
The AI Shopping Assistant gives an old answer Delete the outdated item and add the current version. Webpages do not update on their own. For a webpage, select Resync in its row menu instead
A webpage you added again stays in Processing Webscale AI skips a URL it imported in the last 24 hours. After the item has been in Processing for 30 minutes, select Resync in its row menu
Resync is grayed out The webpage is still processing. Resync becomes available when processing finishes or after 30 minutes in Processing
“Unarchive this folder before resyncing its webpages” Webpages in an archived folder can’t be resynced. Unarchive the folder first
Content from an archived folder is not used Files, snippets and webpages in an archived folder drop out of answers. Unarchive the folder
A product document is not used Check that the right products are selected under Product SKUs
“Select at least one product SKU” A product document needs at least one product. Search for it by name, brand or SKU under Product SKUs
The folder isn’t listed under Training datasets Create the folder under Assistant > Trainings first
The answer has the right facts but the wrong tone or length Trainings controls what the AI Shopping Assistant knows. Set rules for tone and length with prompt instructions

Frequently asked questions

Why does the AI Shopping Assistant ignore content I added to Trainings?
The folder is probably not attached to the agent. Open the agent, go to the General tab and select the folder under Training datasets.
Which file types can I upload to Trainings?
Files accepts PNG, JPEG, JPG, PDF and DOCX. Save plain text or Markdown files as DOCX or PDF first, or paste the text into a snippet.
Can I import a whole section of my website at once?
No. Each Webpages entry imports one page. Add each policy or help page as its own entry.
Does a webpage in Trainings update when I change the page on my site?
Not on its own. To pick up a change, open the webpage's row menu in the folder and select Resync. Webscale AI fetches the page again and replaces its content. The Last synced column shows when the webpage last finished syncing.
Does archiving a folder stop the AI Shopping Assistant from using it?
Archiving stops the files, snippets and webpages in the folder from being used in answers. Nothing is deleted. Unarchive the folder to use them again without adding them again.
Do I need to add my product catalog to Trainings?
No. The AI Shopping Assistant gets product names, prices, attributes and descriptions from your catalog sync. Use Trainings for information your catalog does not hold.