MiniMax Agent上传本地文件需按场景区分：桌面客户端（v2.0+）支持拖放PDF/TXT/DOCX等格式；网页端须经知识库上传并显式指定；API调用需构造含二进制流的multipart/form-data请求，文件≤50MB。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在MiniMax Agent中上传本地文件供AI读取、解析或执行任务，必须明确区分操作场景：桌面客户端支持直接拖入文件，网页端需走知识库流程，API调用则要求构造二进制请求体。不同路径的权限、格式限制和后续可用性差异极大，选错方式会导致文件无法被Agent识别或内容不可引用。
桌面客户端直接拖放上传
这一步操作起来很简单，直接把文件拖进聊天窗口就行。
打开已安装的MiniMax Agent桌面客户端（Mac或Windows），确保登录状态正常；【必须使用v2.0及以上版本，旧版不支持本地文件直传】。
在任意对话窗口空白处，按住鼠标左键拖入目标文件（支持PDF、TXT、DOCX、XLSX、CSV、PNG、JPG、MP3等常见格式）；松手后界面立即显示“正在上传…”提示条。
上传完成即刻可被当前Agent读取——你接着输入“总结这份合同的关键条款”或“把Excel里第3列数据转成图表”，它就能实时调用文件内容响应。
网页端通过知识库上传
网页端不支持聊天窗口拖文件，必须先将文件存入知识库，再在Agent调用时显式指定来源。
方法一：控制台手动上传
1、访问 https://platform.minimax.io → 登录 → 进入“知识库”模块；
2、点击“新建知识库”，填写名称（如“客户合同库”）并保存；
3、在该知识库详情页点击“上传文档”，选择本地文件；
4、等待解析完成（状态变为“就绪”），此时文件才真正可用。
方法二：CLI命令行批量导入
需提前安装minimax-cli工具；执行命令：minimax-cli document upload --file ./report.pdf --knowledge-base-id kb_xxx；【注意：--knowledge-base-id必须与控制台中知识库ID完全一致，大小写敏感】。
API调用时附带文件流
适用于自动化脚本或集成到自有系统，要求开发者控制请求结构与鉴权细节。
第一步：获取有效API Key
进入Minimax开发者后台 → “API密钥管理” → 创建Token Plan类型密钥 → 复制sk-开头的字符串。
第二步：构造multipart/form-data请求
URL为 https://api.minimax.chat/v1/document/upload；Header中必须包含：
Authorization: Bearer sk-xxx
Content-Type: multipart/form-data；
Body中file字段值为文件二进制流，metadata字段可选填{“source”: “sales”}等标签。
第三步：校验返回结果
成功响应JSON中含document_id字段，且status为success；若返回400错误，大概率是文件超过50MB限制或格式不在白名单内（如EXE、DMG等被拒绝）。
