Upload files
1
Open the Knowledge tab
Go to an agent or swarm, then select Knowledge from the top navigation.
2
Add files
Click Files and either drag files into the dropzone or click to browse. You can also drop files directly onto the Knowledge page.
3
Wait for processing
Each file is automatically converted into searchable text. While processing, the status shows Waiting or Processing. Once ready, the agent can recall the content during conversations and tasks.
Supported types include documents, images, audio, and video. There is a per-file size limit shown in the UI. If a file is too large, split it into smaller files and upload again.
Add text or web links
If you have text that is not in a file, or you want to reference a public web page, use the other add options:- Text: Click Text, enter a resource name, paste the content, and confirm.
- Link: Click Link, paste one or more URLs (one per line or comma-separated, up to 20 at a time), and confirm. Each page is fetched and saved as searchable Markdown.
Organize with folders
Keep your library tidy by creating folders and moving items into them.1
Create a folder
Click New Folder, enter a name, and choose a parent folder if you want nesting.
2
Move items
Select one or more files or folders, click Move To, and pick the destination folder. You can also drag and drop items in the tree.
3
Rename or delete folders
Open a folder’s menu to Rename it. To delete, choose Delete Folder. If the folder is not empty, move the contents first, or use Force Delete to remove everything inside.
Give agents and swarms access
By default, nothing is shared automatically. You control which agents and swarms can read each knowledge resource.1
Open access settings
On a knowledge item, click the access pill (it may show Everyone or a count). This opens Access to .
2
Choose who can use it
Toggle access for individual agents and swarms, or select All agents & swarms to share broadly. The All agents grant never includes Maya.
3
Save
Click to confirm. You will see an Access updated confirmation.
Delete or archive documents
To remove a file, open its menu and choose Delete. The item moves to the Archive, where you can Restore it later or Delete forever to purge it. To empty the entire archive, use Delete All.Troubleshoot processing errors
If a document fails to process, check the error message and try the recommended fix:Next steps
Create an Agent
Build an agent that uses your knowledge.
Create a Swarm
Give a team of agents shared context.
Connect Apps
Connect the services your agents work with.