Files
Files enables Subagents to work with uploaded documents and produce file-based outputs.
When to use this tool
- Document summarization
- Data extraction from uploaded files
- Artifact generation workflows
Configuration
- Enable OCR where scanned docs are expected
- Define input/output file handling rules
- Specify accepted file type expectations
Example usage
User prompt:
Read this PDF and list all action items.
Expected behavior:
- Parses input file content
- Returns requested extraction/analysis
- Generates output artifact when needed

Validation checklist
- Confirm tool is attached to correct Subagent
- Test both success and failure path in Preview
- Verify deployed behavior in Interact for real user phrasing
Common issues
- Scanned PDFs without OCR reduce extraction quality
- Unsupported file types can fail processing
Best practices
- Set clear file-format requirements for users
- Use consistent output schema for downstream steps