Give your agents documents to search with Knowledge

Knowledge is in Beta. It holds the text your agents should be able to look things up in: runbooks, coding conventions, product notes. Documents are grouped into collections, and your agent searches them with the MCP server.

Create a collection

1. Open Knowledge from the sidebar and press New collection.
2. Give it a name and a description that says what is in it, so people and agents know when to search it.
3. Choose the Owner: your personal account or one of your organisations.
4. For an organisation, choose Who can read it: Everyone in the organisation, or Only you and organisation admins.
5. Press Create collection.

A personal collection is private to you. Collections are never public.

Through the API you can also share a collection with one project's members only, by sending the project's slug as project when you create it. Project guests can read those collections but not the organisation's.

Add documents

Open the collection, then under Add documents either press Upload .md or .txt files or paste text with a title. A title ending in .txt is shown as plain text; everything else is shown as Markdown.

Each document can be up to 1 MB. Only text is accepted: PDFs, images and other binary files are refused. Every document is checked for credentials such as API keys, and one that contains a credential is refused until you remove it. Documents count toward your storage quota.

Who can add and delete

Creating a collection in an organisation needs a role that can publish (editor and up). In a shared organisation collection, those members add and remove documents. The person who created a collection, and the organisation's owners and admins, can delete it.

How agents use it

Your agent reads Knowledge through the Deftro MCP server, signed in as you. If it is not connected yet, press Onboard your agent on Connect an agent, or see Add the MCP server.

An agent calls search_knowledge with a few words, then read_document for the full text. Every search is checked against what you can read right now, so an agent finds only the collections you can. Agents treat a document as reference written by people, not as instructions to follow.

You can search from the web too: use the search box on the Knowledge page, or inside one collection.