For the complete documentation index, see llms.txt. This page is also available as Markdown.

Train Your AI Agent

Training is how your AI agent learns about your business. It answers from the sources you add, so the better the sources, the better the answers. You can add websites, files, spreadsheets, FAQs and short text snippets. The Un-answered Questions tab then shows what the agent could not answer, so you know what to add next.

Prerequisites

  • An AI agent. See Create your first AI Agent.

  • Content to train on, for example your website address, a PDF or a list of common questions. [CHECK: confirm the plan and role needed.]

  • Sample data only. The screens in this guide use the sample company Acme Inc.

Key definitions

Term
Meaning

Training source

A place your agent learns from, such as a website or a file.

Re-sync

Read a website again so the agent has the latest content.

FAQ

A question with the answer you want the agent to give.

Snippet

A short piece of text, such as a policy or product details.

Un-answered question

A customer question the agent could not answer correctly.

Open Training

  1. Click Training under Setup in the AI Agent sidebar.

  2. The page opens on Overview. Key analytics shows how many Web URLs, Files, Snippets and FAQs your agent has. Training data lists everything you added. Click Add training data to add more.

  3. Use the tabs to work on one source type: Website, File Upload, Google Sheets, FAQ's, Snippets, Un-answered Questions and Other Sources.

Open Training and click Add training data

Add training data

  1. Click Add training data.

  2. On Source, choose how you want to train your agent.

  3. On Details, fill in the details for that source.

  4. Click Add and train. A Confirmation screen shows that training has started, then that it is complete.

Train on a website

  1. Click the Website tab. The table lists each website, how many URLs it has, its status and its actions.

  2. Click Add website. Choose The full website to read every page it can find, or Specific URLs only to read just the pages you list.

  3. Enter the website address and click Add and train.

  4. To refresh a website after it changes, click Re-sync. Use Reschedule to set when it re-syncs. Use the first icon in the row to see the pages it read.

Website tab with the websites your agent learned from

Train on files

  1. Click the File Upload tab. The table shows each file's name, format, training status and when it was last trained.

  2. Click Add file. Choose Upload a file to pick a file from your computer, or Use a file link to paste the web address of the file.

  3. Click Add and train. Wait until the status shows that training is complete before you test.

  4. Use the icons in the Actions column to download or delete a file.

File Upload tab with sample files

Train on Google Sheets

  1. Click the Google Sheets tab. The table shows each spreadsheet, the sheet name and its training status.

  2. Click Add sheet, choose your Google account and pick the sheet.

  3. Click Add and train.

Google Sheets tab with sample sheets

Train on FAQs

  1. Click the FAQ's tab. The table shows each question, its answer and when it was last updated.

  2. Click Add FAQ. Choose One by one to type a question and its answer, or Upload in bulk to import many from a spreadsheet.

  3. Click Add and train.

  4. Use Download all as CSV to back up your FAQs. Use Upload CSV to add many at once.

FAQ's tab with sample questions and answers

Train on snippets

  1. Click the Snippets tab. The table shows each snippet's name, content and tags.

  2. Click Add snippet. Type a name, add a tag that says what it is about, for example Returns, and paste the text your agent should know.

  3. Click Add and train.

Snippets tab with sample snippets

Review un-answered questions

  1. Click the Un-answered Questions tab. The table lists questions your agent could not answer, with the reply it gave and the date.

  2. Use Search questions to find one, and Filter by date to look at a period.

  3. Click Create a FAQ on a row to turn that question into an FAQ. Type the answer you want, and the agent learns it.

  4. Click Export unanswered questions to share the list with your team.

Un-answered Questions tab with sample questions

Other sources

Click Other Sources to connect Notion, Dropbox or an MCP server. Notion and Dropbox read pages or files from your workspace. MCP connects a Model Context Protocol server as a source of knowledge.

Other Sources tab with Notion, Dropbox and MCP

Keep your agent up to date

  • Re-sync a website after you change it.

  • Replace files that are out of date.

  • Review Un-answered Questions often and turn repeat questions into FAQs.

  • Test your agent in the Agent Preview after each change.

[CHECK: the old pages describe Website import preferences (Scan Full Page, Scan Single Page, Scan JSON Only) and a "Train on Images as well" option. The prototype offers The full website and Specific URLs only. Confirm the options on the real screen.]

[CHECK: the old pages list these file types: PDF, DOC, DOCX, PPTX, TXT, CSV, XLS, XLSX and an RSS feed. The prototype shows PDF, DOCX, XLSX, CSV and PPTX. Confirm the supported types and any size limit.]

[CHECK: the old FAQs page uses categories. The prototype lists FAQs in one table with no categories. Confirm.]

[CHECK: the old Un-answered Questions page says entries cannot be deleted. The prototype has a delete icon on each row. Confirm.]

[CHECK: each source type will get its own page later. Add links when they are published.]

Common errors

My agent does not use the website I added

Open the Website tab and check the status. If it is still training, wait for it to finish. If the site changed, click Re-sync.

My file does not appear in the answers

Check the Training status on the File Upload tab. Answers use the file only after training is complete. Test again in the Agent Preview.

My agent gives an old answer

The source may be out of date. Re-sync the website, replace the file or edit the FAQ. Then test again.

I cannot find a question I added

Clear the search box. Use Load more to see more rows.

The Un-answered Questions tab is empty

Your agent has not missed any question in the period you chose, or customers have not asked yet. Clear the date filter to check.

When should I use a FAQ and when a snippet?

Use a FAQ when you have a question and an exact answer. Use a snippet for background text, such as a policy, where customers may ask in many ways.

Support

Still not working? Write to us at support@botpenguin.com. We will reach out to you within 24 hours.