Skip to main content

File Resources

File resources allow you to upload and store any type of file to provide as context for AI models. This includes PDFs, images, data files, and more.

Creating a File Resource​

  1. Navigate to Resources in the left sidebar
  2. Click + New Resource
  3. Select File as the resource type
  4. Fill in the resource details:
    • Name: Use letters, numbers, and underscores (e.g., product_catalog)
    • Description: Brief description of the file
    • URI: Auto-generated or provide a custom URI
  5. Upload your file

Supported File Types​

File resources support any file type, including:

  • Documents: PDF, Word, Excel
  • Images: PNG, JPG, GIF
  • Data Files: CSV, JSON, XML
  • Text Files: TXT, MD, LOG
  • Archives: ZIP (note: contents are not extracted)

Security Restrictions​

For security reasons, the following file types are blocked:

  • Executable files (.exe, .sh, .bat)
  • Scripts that could be executed server-side

Size Limits​

  • Maximum file size: 25MB
  • Files are stored securely in cloud storage
  • Large files may take longer to process by AI models

Example Use Cases​

Product Documentation​

Upload PDF product manuals or specification sheets:

  • Technical specifications
  • User guides
  • API documentation PDFs

Reference Images​

Provide visual context with images:

  • UI mockups for development reference
  • Diagrams and flowcharts
  • Brand assets and style guides

Data Tables​

Share structured data files:

  • CSV files with pricing data
  • Excel spreadsheets with project plans
  • JSON files with configuration schemas

Make contracts and agreements available:

  • Terms of service
  • Privacy policies
  • Licensing agreements

Uploading Files​

During Creation​

When creating a new file resource, click the file upload area and select your file.

After Creation​

To update the file content:

  1. Navigate to the resource detail page
  2. Scroll to the Content section
  3. Click Upload New File
  4. Select the replacement file
  5. Click Save

Downloading Files​

To download a file resource:

  1. Go to the resource detail page
  2. Click the Download button in the Content section

MIME Type Detection​

Reeva automatically detects the MIME type of uploaded files based on the file extension. This helps AI models understand how to process the file content.

Linking to Servers​

After uploading a file resource:

  1. Open the resource detail page
  2. In the Linked Servers section, select a server
  3. The file is now accessible to AI clients

File Storage​

Files are stored securely in Firebase Storage with:

  • Encryption: All files are encrypted at rest
  • Access Control: Only you can access your files
  • Durability: Files are stored redundantly for reliability

Best Practices​

  • Use Descriptive Names: Include file type in the resource name
  • Compress When Possible: Smaller files process faster
  • Update Metadata: Keep descriptions accurate after file updates
  • Consider Alternatives: For frequently changing data, consider using Text resources with JSON or connecting external services
  • Check File Size: Large files may impact AI model response times

Limitations​

  • Files are provided as-is to AI models; Reeva does not extract or process content
  • Binary files may not be interpretable by all AI models
  • Consider using Text resources for text-based content when possible for better AI comprehension