MiniMax Agent文件上传有四类路径：桌面端拖拽（限100MB内常规格式）、Web控制台建知识库（支持批量同类型文件）、API上传（需document:write权限及合法JSON元数据）、CLI工具（自动注入author/source等字段，author禁含@）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让MiniMax Agent把本地文件上传到知识库或处理任务，但发现它在桌面端没反应、网页端找不到上传入口、API调用返回403错误——这通常是因为没选对上传路径，或权限/格式没配对。
桌面端直接拖拽上传
适用于Mac或Windows用户想快速传单个PDF、TXT、DOCX等常规文档，不写代码、不配密钥。
打开MiniMax Agent 2.0桌面应用，确保左下角状态栏显示“已连接”且图标为绿色。
将目标文件（如会议纪要.pdf）直接拖入主聊天窗口空白区，松手即触发上传流程。
上传成功后，Agent会自动回复：“已收到文件《会议纪要.pdf》，正在解析内容……”，几秒内即可开始问答。若卡在“上传中”超15秒，【请检查文件是否超过100MB】，桌面端暂不支持超大文件分片上传。
Web控制台手动上传知识库
适合需要长期复用文档、构建私有知识库的用户，比如上传《产品需求文档v3》供多个Agent调用。
方法一：基础上传流程
登录Minimax平台控制台 → 进入左侧导航栏“知识库” → 点击右上角“新建知识库” → 填写名称（如“内部产品文档”）并保存 → 在知识库详情页点击“添加文档” → 选择“上传本地文件” → 选取文件 → 等待状态变为“已就绪”。
方法二：批量上传技巧
支持一次勾选多个同类型文件（如5个Markdown文档），但【不能混传PDF和Excel】，系统会因格式校验失败跳过非白名单类型。
上传后无需手动触发解析，系统自动完成文本提取与向量化，约10秒内可被Agent检索到。
通过API上传带元数据的文件
开发者需批量导入带分类标签的文档，例如给销售合同打上“客户类型：KA”“签约年份：2026”。
第一步：确认API权限已开通
进入“开发者后台→项目设置→API密钥”，检查当前Key是否拥有document:write权限，无则需重新生成并勾选该权限。
第二步：构造请求体
使用curl命令时，在-form参数中必须同时传file=@/path/to/contract.pdf和metadata='{"client_type":"KA","year":"2026"}'，缺一不可；否则metadata会被忽略，文档将按默认规则归类。
第三步：验证响应
收到JSON返回中status字段为success且id字段为非空字符串（如"doc_abc123xyz"），表示文件已入队；若返回error_code: "invalid_metadata_format"，说明metadata不是合法JSON对象。
CLI工具上传并标注作者信息
面向终端熟练用户，上传时自动注入author、source等字段，避免后期人工补录。
安装minimax-cli后，执行：minimax document upload --file report.xlsx --author "张三" --source "季度经营分析会" --tags "Q2,营收"。
命令执行后终端输出“✅ Uploaded: report.xlsx (id: doc_qwe789)”即完成；该ID可用于后续API查询或调试。
注意：--author值不能含@符号或换行符，否则CLI会静默截断，导致知识库中作者字段为空。
