Knowledge Base
A Knowledge Base is the set of documents and web content your agents can draw on to answer callers accurately. Instead of cramming everything into a prompt, you add your material once and let the agent look things up during a call — pricing, policies, product details, FAQs, and more.
Where knowledge lives
Knowledge can be attached at two levels:
- Workspace knowledge base — shared Knowledge items available to agents in the workspace.
- Per-agent documents — files attached directly to a single agent.
Both places have the same two tabs: your content (Documents / Knowledge items) and URL scrape history.
Add knowledge
1. Upload documents
Upload files directly — PDF and HTML are supported. Drag and drop or pick files, and they're added to the knowledge base once processed.
Well-structured documents work best. Clear headings and short sections help the agent find the right passage quickly.
2. Scrape a website
Point Chatley at a URL and it will crawl the site and turn the pages into knowledge:
- Scrape depth — how many links deep to crawl from the starting URL (default
is
2). Higher depth pulls in more pages but takes longer. - Scrape history — every scrape job is recorded. Track progress in the URL scrape history tab.
- Reuse — if a URL has already been scraped, Chatley can reuse the existing result instead of crawling again, saving time.
How agents use it
Once knowledge is in place, an agent (or a workflow Knowledge Base tool) can query it mid-call to answer questions from your content rather than guessing. You add the knowledge once; every call the agent handles can use it.
Keeping knowledge fresh
- Re-scrape a site when its content changes (reuse keeps unchanged pages fast).
- Remove documents that are out of date so the agent doesn't cite stale info.
- Split very large documents into focused files for better retrieval.
Troubleshooting
| Problem | What to check |
|---|---|
| Upload rejected | Confirm the file is a supported type (PDF/HTML) and within the size limit. |
| Scrape returns little content | Some sites block crawlers or load content with JavaScript; try a more specific URL or a different depth. |
| Agent doesn't use the knowledge | Make sure the knowledge is attached to that agent (or its workspace) and the agent/workflow is set up to consult it. |