Skip to main content

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.

From your content to answers on the call — upload documents or scrape a website into the knowledge base, which the agent uses to answer questions during calls

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.

tip

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

ProblemWhat to check
Upload rejectedConfirm the file is a supported type (PDF/HTML) and within the size limit.
Scrape returns little contentSome sites block crawlers or load content with JavaScript; try a more specific URL or a different depth.
Agent doesn't use the knowledgeMake 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.