> ## Documentation Index
> Fetch the complete documentation index at: https://help.callaro.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Knowledge bases

# Knowledge bases

Use **Knowledge base** when the agent should answer from approved tenant documents instead of a long custom knowledge block in the prompt.

![Knowledge base list with a published collection and create action.](https://mintcdn.com/callaro-docs/1fJs_sKJdgiwY8nj/images/scripts-ai/knowledge-bases.svg?fit=max\&auto=format\&n=1fJs_sKJdgiwY8nj\&q=85\&s=9d24d79d239e397832a5cf51b8ca5c24)

**What the static should show:** The **Knowledge base** list with a published row, status badge, and **Create knowledge base**.

## When to use a knowledge base

* The same facts are reused across more than one agent.
* Pricing, eligibility, or policy text changes more often than the rest of the script.
* You want retrieval scoped to published sources instead of stuffing the prompt.

Keep one knowledge base focused on a single domain. A “everything we know” corpus makes live answers less reliable.

## Create and publish

1. Open **Knowledge base** and create a collection.
2. Add file or website sources and wait until processing finishes.
3. Review the generated summary if your workspace uses published summaries.
4. **Publish** the knowledge base. Draft collections cannot be linked for live calls.

Website imports and some file extractions can appear as knowledge-base lines on **Usage**. Check that page before you crawl a large site.

## Link it to an agent

1. Open the agent wizard and go to **Prompt & Goals**.
2. In **Knowledge**, choose a **linked** published knowledge base instead of custom text.
3. Keep the rest of the prompt focused on identity, flow, and guardrails.
4. Publish the agent so the live version picks up the link.

If the linked-KB option is locked, the tenant plan or publish state is blocking it. Publish the knowledge base first, then refresh the agent editor.

## Common mistakes

1. **Linking a draft** — The agent continues to use custom text or empty retrieval. Publish first.
2. **Duplicate sources** — Two PDFs that disagree on the same policy cause inconsistent answers.
3. **Sandbox content in production** — Knowledge bases are environment-scoped. Recreate or promote deliberately.

![GIF of opening a knowledge base and reviewing source status.](https://mintlify.s3.us-west-1.amazonaws.com/callaro-docs/images/scripts-and-ai/knowledge-bases-slot-01.gif)

**What the GIF should show:** Opening a published knowledge base from the list and scanning source status.

## Related articles

* [How the AI handles calls](https://help.callaro.ai/scripts-and-ai/how-the-ai-handles-calls.md)
* [Customising your call script](https://help.callaro.ai/scripts-and-ai/customising-your-script.md)
* [Prompt writing fundamentals](https://help.callaro.ai/scripts-and-ai/prompt-writing-fundamentals.md)
* [Usage-based billing](https://help.callaro.ai/billing-and-account/usage-based-billing.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.