MiniMax_Agent文件上传入门教程

Minimax平台提供四种互不干扰的文件导入路径：Web界面上传（适配1～3个PDF/TXT/DOCX/MD）、API批量导入（支持自动化脚本）、挂载云存储桶（自动同步阿里云OSS/腾讯云COS）、CLI工具导入（终端党高效操作）。

想让MiniMax Agent读取你电脑里的PDF合同、会议纪要或产品说明书，但上传按钮点了没反应、文件拖进去没识别、或者提示“不支持该格式”——这通常不是Agent坏了，而是你没走对入口或没选对方式。Minimax平台提供四种互不干扰的文件导入路径，适配不同场景和操作习惯，选错一种就卡在第一步。

Web界面上传：适合单次传1～3个常规文档

这是最直观的方式，专为临时上传、快速验证内容效果设计，不需要装工具、不写代码，但仅支持PDF/TXT/DOCX/MD等文本类格式。

打开Minimax控制台 → 进入【知识库】模块 → 点击右上角“新建文档” → 选择“上传本地文件”。

在弹出的系统文件选择窗口中，

选中文件后直接点击“打开”，页面显示蓝色进度条即开始上传；进度条走完不代表解析完成，需等待右下角出现绿色“已就绪”标签，才算真正可用。

API批量导入：适合每天要处理50+份销售报告的运营团队

当你需要把CRM导出的Excel报表、邮件归档的EML文件、甚至扫描件OCR后的TXT批量喂给Agent做分析，就得用接口方式。它不依赖浏览器，能嵌进你的自动化脚本里。

方法一：用curl命令行直传（推荐测试用）
执行：curl -X POST https://api.minimax.chat/v1/documents/upload
-H "Authorization: Bearer sk-xxx"
-F "file=@/path/to/report.pdf"
-F "metadata={"source":"sales_q2"}"

方法二：使用Python的 requests 库（更适合直接集成到内部系统里）
这里有个很容易踩坑的点：Header 里必须设置 Content-Type: multipart/form-data，但 boundary 绝对不要手动去拼。原因很简单，requests 会自动生成；一旦自己硬写，反而很容易触发 400 错误。

上传成功后返回JSON里有"id": "doc_xxx"字段，这个ID就是后续让Agent引用该文档的唯一钥匙，

挂载云存储桶：适合文档长期存放在阿里云OSS或腾讯云COS的公司

如果你的合同库、产品手册、员工培训资料已经稳定存在对象存储里，没必要反复下载再上传。Minimax支持监听Bucket事件，新文件一放进去，自动触发解析流水线。

第一步：在Minimax控制台【数据源管理】→【添加云存储】，填入Bucket名称、Region和具备oss:GetObject权限的AccessKey。

第二步：上传一个名为minimax-verify.txt的空文件到Bucket根目录，勾选“启用事件通知”，这步是活体检测，跳过则配置不生效。

第三步：设置同步规则时，文件前缀填/docs/contract/比填docs/contract/更安全——前者只匹配路径开头严格匹配，后者可能误拉/docs/contract_v2/下的旧版本。

保存后系统立刻扫描全量文件，首次同步耗时取决于文件数量，但后续新增或修改的文件，10秒内就能被Agent调用。

CLI工具导入：适合终端党、喜欢用Tab键补全路径的工程师

Minimax官方CLI工具（minimax-cli）能把上传变成一行命令，还能顺手打标签、设分类、加摘要，比网页点点点更可控。

先确保已安装Node.js和npm，然后执行：npm install -g minimax-cli。

登录授权：minimax login --key sk-xxx，注意这里填的是API Key，不是Agent ID。

上传单个文件并标注用途：minimax document upload --file ./2026-Q3-plan.pdf --tags "plan,executive" --category "strategy"。

如果要把整个文件夹连同子目录一起上传，可以直接用这条命令：minimax document upload --dir ./meeting-notes/ --recursive。执行后，系统会给每个文件分别生成独立 ID，不过它们会共用同一组 tags 和 category。这样一来，后面用filter=tags:executive做批量检索时，就会顺手很多。