用途：在 Convex Agent 对话中处理文件与图片，让智能体能够理解视觉内容并生成文件。适用于用户上传图片供智能体分析、智能体处理文档或文件、使用 DALL-E 生成图片、构建基于文件的工作流，以及实现文件清理与追踪。
主要能力：上传并存储文件（storeFile）；将文件作为消息附件发送（getFile 与 saveMessage 两步流程）；在生成时内联传入文件（仅限 action）；生成并保存图片；自动存储大于 64KB 的文件；通过元数据追踪消息引用的文件；生成签名 URL 防止未授权访问；未提供 MIME 类型时自动推断；追踪文件以便垃圾回收。
使用方式：上传文件使用 storeFile(ctx, components.agent, blob, { filename, sha256 })，返回 fileId、url 和 storageId。发送带附件的消息分两步：先用 getFile 获取 imagePart 或 filePart，再用 saveMessage 保存含附件与文本的消息，最后通过 myAgent.continueThread 与 thread.generateText({ promptMessageId }) 生成回复。内联保存仅在 action 中可用，直接在 generateText 的 message.content 中传入 image 与 mimeType。生成图片使用 generateImage 配合 openai.image("dall-e-2")，再用 storeFile 保存。
限制：内联文件保存仅限 action；资料未提供具体收费、价格、平台支持范围或性能数据；示例中的 sha256 为占位值，实际使用需自行计算。