# Add knowledge sources

> Upload documents or crawl your website so the AI agent has something to answer from.

The AI agent answers only from the sources you list. That is what keeps its answers accurate and lets it link to where an answer came from.

Open **AI agent**, then **Knowledge**. Only admins and owners can add or change sources.

## Upload documents

1. Select **Choose files to upload**.
2. Pick up to 10 files at a time.
3. Upload them.

Accepted types are Markdown (`.md`, `.markdown`, `.mdx`), plain text (`.txt`), HTML (`.html`, `.htm`), PDF and Word (`.docx`). Each file can be up to 25 MB and must not be empty. A file that fails a check is listed with the reason, and the others still upload.

## Crawl a website

1. In **Crawl a website**, enter a sitemap address, such as `https://example.com/sitemap.xml`, or the address of a single page.
2. Set **Most pages to index**. The default is 100 and the limit is 500.
3. Select **Start crawl**.

A sitemap crawls each page it lists. Tirver respects your robots.txt and crawls at a polite rate, then turns each page into text with its title and address.

## Source status

| Status | Meaning |
|---|---|
| Pending | Waiting its turn. |
| Indexing | Being read and prepared. |
| Indexed | Ready. The agent can answer from it. |
| Failed | Something went wrong. The reason is shown. |
| Skipped | Left out, for example blocked by robots.txt. |

For a website, the status summarises its pages, and a few failed or skipped pages are listed with their reasons.

## Keep sources fresh

- **Re-crawl** fetches a website again. Pages that have not changed are skipped, changed pages are updated, and pages that disappeared are removed.
- **Re-index** processes a source again without fetching it.
- **Refresh** updates the list.
- Delete a source, after confirming, to stop the agent using it.

The **Last synced** column shows when each source was last updated.

## Tips for good answers

- Prefer clear, current pages over long archives.
- Put each topic in its own page or section.
- Test with real customer questions. See [test the agent](https://tirver.com/help/test-the-agent.md).

Your help articles are for customers to read in the widget. To let the agent use their content too, point a crawl at your published help pages or upload the articles as documents.

Source: https://tirver.com/help/add-knowledge-sources