Convex Agents Files

Upload and attach files with metadata and URLs to Convex agent conversations.

25|4|Updated Oct 18, 2025
One-click install
npx skills add https://github.com/Sstobo/convex-skills --skill convex-agents-files
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Convex Agents Files
Source: https://github.com/Sstobo/convex-skills/tree/main/convex-agents-files
Command: npx skills add https://github.com/Sstobo/convex-skills --skill convex-agents-files

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Agents often need to receive and process user files and images within conversations. This skill provides a reliable, secure way to upload, store, and attach files to messages, enabling rich media workflows.

Core Features & Use Cases

  • File upload and storage: accepts binary or base64 data, stores with metadata and accessible URLs.
  • Image attachments and media processing: attaches images to messages, supports image processing hooks.
  • File lifecycle management: tracking, cleanup, and access control for files referenced by messages.
  • Use Case: When an agent analyzes a uploaded document, or generates a result based on user-provided media.

Quick Start

Use this skill to upload a file as part of a thread: call uploadFile with fileData, filename, mimeType, then attach via saveMessage with the returned file info.

Frequently Asked Questions about Convex Agents Files

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upload and attach files to messages in Convex agent conversations?

To upload and attach files to messages in Convex agent conversations, call uploadFile with fileData, filename, and mimeType, then attach it via saveMessage using the returned file info. This provides a reliable, secure way to store files and attach them to threads.

What data formats does Convex file storage support for agent attachments?

Convex file storage for agent attachments supports both binary and base64 data formats. It stores the uploaded files with associated metadata and generates accessible URLs for use within the conversation threads.

Can I process images and track the file lifecycle within Convex agent threads?

Yes, you can process images and track the file lifecycle within Convex agent threads. The system supports image processing hooks and provides lifecycle management including tracking, cleanup, and access control for files referenced by messages.

Does Convex agent file storage work for workflows generating media within threads?

Convex agent file storage works for workflows generating media within threads. It applies to scenarios where agents analyze uploaded documents or generate results based on user-provided media, enabling rich media workflows.

What is the best way to manage access control and cleanup for agent file uploads?

The best way to manage access control and cleanup for agent file uploads is using the provided file lifecycle management features. This functionality tracks files referenced by messages and handles both cleanup operations and secure access control.

Why do I need to integrate agent file storage APIs for base64 uploads in Convex?

You need to integrate agent file storage APIs for base64 uploads in Convex to securely accept binary or base64 data, store it with metadata, and generate accessible URLs required to attach the files to agent messages.