Skip to content

Automatic translation — the Portuguese version is the reference. View in Portuguese

Updated on 2026-10-03

Teach the agent documents

AI → Knowledge: create a knowledge base, upload documents, see what was indexed and what failed — and the agent answers quoting the document and the passage.

On this page (5)

In AI → Knowledge. The agent starts answering about sales policy, process manuals, contracts — quoting the document and the passage.

How it works#

  1. Click Create knowledge base, fill in Knowledge base name (e.g., "Sales policies") and What it's for (optional), and confirm with Create.
  2. Open the knowledge base and upload the document: fill in Title and Content (pasting the text) or use Choose a text file. The button that saves is Index (while saving: "Indexing…").
  3. Turn it on in the agent: in Configure, check the Search documents tool and choose the knowledge bases under Documents it looks up.

Each document shows its status: Indexed, Indexing, Queued, or Not indexed. To remove one, the button is Delete, with the confirmation "The agent stops looking it up."

The knowledge base belongs to the workspace, not to the agent. The same manual serves several agents, and you fix it in one place only.

Accepted formats#

Pasted text and .txt, .md, .csv, .json, .html, .xml files.

PDF and Word not yet. For those, copy the text and paste it — that way you see exactly what was indexed, instead of trusting a conversion no one checked.

The most important thing: it says when it doesn't know#

If the question isn't answered by the documents, the agent replies "I didn't find it in the documents" instead of quoting the least-bad passage. A citation that looks like a source but answers nothing is worse than no answer at all — people believe it precisely because it has a citation.

A document that failed shows up#

The list shows what was not indexed, with the reason. A knowledge base that says "12 documents" when 3 failed promises knowledge the agent doesn't have.

Limits#

LimitValue
Characters per document400,000
Documents per knowledge base200

Indexing consumes AI and shows up on the monthly bill as "Knowledge indexing" — separate from the spending on answering. The same content sent twice isn't indexed again.

Related links