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
- The files are within the limits.
- Your workspace has an embeddings provider. Faustine uses it to index the documents. See Choose an embeddings provider.
Upload files
To add documents:
- In the portal, go to Web Agents and select your agent.
- Select the Assistant tab, then Files & links.
- 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
- Turn on web search: let the agent look up what your documents do not cover.
- Write the agent's persona: say how the agent should talk about what it finds.
- Read the logs: see when the agent searched the knowledge base in a conversation.
Last updated November 13, 2026