Add knowledge from files

Knowledge is the set of documents a Web Agent searches before it answers. Upload the material your users ask about, such as policies, manuals, price lists and FAQs. Knowledge is for questions. To make the agent do something in the app, it needs an action.

Uploaded files are the only knowledge source a Web Agent reads.

Before you begin

Upload files

To add documents:

  1. In the portal, go to Web Agents and select your agent.
  2. Select the Assistant tab, then Files & links.
  3. In the Files row, drop the files on the upload area, or select it and choose them. You can add several at once.

Each file appears in the list with a status.

Status Meaning
Processing Faustine is reading the file and splitting it into chunks.
Ready The agent can search the file. The row shows its size and its number of chunks.
Failed The file could not be processed. The row shows the reason.

A document is searchable as soon as it is Ready. Documents are not part of a version, so there is nothing to publish, and every environment of the agent reads the same documents.

How the agent uses documents

Once the agent has one document that is Ready, it searches the knowledge base before it answers a question about rules, policies, procedures or prices, and answers from what it finds. An agent with no documents does not search.

The search returns the passages that match the question, not the whole file, and the agent answers from those.

Remove a file

Select the delete button on the file's row. The agent stops finding the document's content.

To replace a document with a newer copy, delete the old one and upload the new one. Uploading a file whose content is identical to an existing document is refused with Already uploaded.

Limits

Limit Value
File types .pdf, .docx, .txt, .md
Size of one file 25 MB

Troubleshooting

Symptom Cause Fix
Already uploaded — this file's content matches an existing document. The same content is in the knowledge base, under this name or another. Nothing to do. Delete the existing document first if you meant to replace it.
The upload is rejected as an unsupported document type The file is not PDF, DOCX, TXT or MD. Convert it to one of those formats.
The agent answers from memory and does not use a document The document is still Processing, or it Failed. Wait for Ready, or upload the file again.

Next steps

Last updated November 13, 2026