Knowledge files

Knowledge files let you attach documents to a hosted agent so it can reference them during a run — without you needing to pass the content in the prompt each time.

---

Uploading a file

1. Go to Resources in the sidebar
2. Click Upload and select a file (PDF, TXT, Markdown, CSV)
3. The file is stored in your workspace and available to any agent

---

Attaching a file to an agent

1. Open the agent → Knowledge tab
2. Find the file in the list and toggle it on
3. Save

Attached files are injected into the agent's context window at the start of each run. The agent can reference them directly in its reasoning.

Only files you have toggled on for a specific agent are included. Uploading a file to Resources does not automatically attach it to all agents.

---

File size and token budget

Large files consume a significant number of tokens. As a guide:

• 1 page of text ≈ 500 tokens
• A 10-page PDF ≈ 5,000 tokens
• Models have context limits — a very large file may crowd out the agent's reasoning space

Tips:

• Trim files to the relevant sections before uploading
• Split large reference documents into smaller topic-focused files and attach only the ones each agent needs
• Check the event log for context.overflow events if the agent seems to be ignoring the file

---

Supported formats

Format	Notes
.txt	Plain text, most token-efficient
.md	Markdown — headings and structure are preserved
.pdf	Text is extracted; scanned/image PDFs are not supported
.csv	Tabular data — best for small reference tables

---

Removing a file

Toggle the file off in the agent's Knowledge tab to detach it. The file remains in Resources and can be reattached later. To permanently delete a file, go to Resources and delete it from there — this removes it from all agents.