Skip to Content
Docs are being rebuilt — start at Introduction → How it works.
AgentsBuilding an agentKnowledge tabAttaching knowledge bases

Attaching knowledge bases

Knowledge bases let your agent answer questions using your content: policies, runbooks, product docs, past transcripts, or any source you have indexed.

What you can do here

  • Attach one or more knowledge bases to an agent.
  • Search the available knowledge bases by title or description.
  • Review each source type, chunk count, and size before attaching it.
  • Switch an attached source between Read and Read & Write access.
  • Remove a knowledge base from the agent draft.
Select Knowledge Bases dialog with searchable knowledge bases, checkboxes, chunk counts, and confirm selection

Attach a knowledge base

  1. Open the Knowledge tab in the agent builder.
  2. Click Add.
  3. Search available knowledge bases by name or description.
  4. Select the checkbox next to each knowledge base the agent should use.
  5. Review the listed type, chunk count, and size.
  6. Click Confirm Selection.
  7. Click Save in the builder header.

The attached knowledge bases appear in the Knowledge tab list. You can attach multiple sources; the agent can retrieve from all selected sources during chat.

Knowledge tab with an attached knowledge base, Read access button, and remove icon

Choose access

AccessUse when
ReadThe agent should reference the source but not update it. This is the safest default.
Read & WriteThe agent is expected to maintain or update the source through tools that support writing.

Remove a knowledge base

Click the trash icon next to the knowledge base in the list, then save the agent. Removing a source stops future retrieval from that source; it does not change existing chat history.

Choosing what to attach

  • One knowledge base per topic. A “Sales playbook” knowledge base and a “Product specs” knowledge base is easier to test than one large mixed source.
  • Keep sources fresh. See Organize & edit for maintenance.
  • Watch the chunk count. Very large sources can increase retrieval latency.