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 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 is set up to consult it. |
Next steps
- Agents — attach documents to an agent.