> For the complete documentation index, see [llms.txt](https://help.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.botpenguin.com/ai-agents/train-your-ai-agent.md).

# 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.&#x20;
* 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](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/ZRQnN20iQ4GvIrdnxWsL/images/train-your-ai-agent-step-1.png)

### 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](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/sIutH3jxs9a05SKNboQb/images/train-your-ai-agent-step-2.png)

### 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](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/ypyjBH2bCPDDv68l4Mh5/images/train-your-ai-agent-step-3.png)

### 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](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/gigAuYxl8112gTcApDlK/images/train-your-ai-agent-step-4.png)

### 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](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/Iy5ETXGVkZXihdHbyRg0/images/train-your-ai-agent-step-5.png)

### 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](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/2MlcLhtLybGHg3UbB5Ic/images/train-your-ai-agent-step-6.png)

### 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](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/IkMxKfMJQnrVv26CX6GV/images/train-your-ai-agent-step-7.png)

### 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](https://content.gitbook.com/content/APDb8cKQtGlIAfgHjcsQ/blobs/wk69zjIR78rLhfKDKSNM/images/train-your-ai-agent-step-8.png)

### 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.

### Common errors

<details>

<summary>My agent does not use the website I added</summary>

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.

</details>

<details>

<summary>My file does not appear in the answers</summary>

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

</details>

<details>

<summary>My agent gives an old answer</summary>

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

</details>

<details>

<summary>I cannot find a question I added</summary>

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

</details>

<details>

<summary>The Un-answered Questions tab is empty</summary>

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

</details>

<details>

<summary>When should I use a FAQ and when a snippet?</summary>

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.

</details>

### Support

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