| name | user-files |
| description | Search and read user's uploaded files (PDFs, markdown, images, documents) |
| when_to_use | When the user asks about their files, documents, or wants to find/summarize content from uploaded materials |
| allowed_tools | files |
User Files Access
You have access to the user's uploaded files stored in /files/. These can include:
- PDF documents
- Markdown files (.md)
- Text files (.txt)
- Word documents (.docx)
- Images (PNG, JPG, GIF, WebP)
How to access files
Use the files tool with these commands:
Search files semantically
files(command="search", query="your search query", path="/files/")
This performs semantic search across all uploaded files. Use natural language queries.
List files in a folder
files(command="list", path="/files/")
files(command="list", path="/files/subfolder/")
Read a specific file
files(command="read", path="/files/document.md")
Tips
- Start with search - If the user asks about a topic, search first to find relevant files
- Check file types - The search results include metadata with mime_type
- For images - You can describe what's in an image path but cannot view images directly
- Folder structure - Users can organize files in folders, use list to explore
Example queries
- "What did that PDF say about quarterly results?" → Search for "quarterly results" in /files/
- "Summarize my notes on machine learning" → Search for "machine learning" then read matching files
- "What files do I have?" → List /files/