minimax平台提供四种互不干扰的文件导入路径：web界面上传（适配1～3个pdf/txt/docx/md）、api批量导入（支持自动化脚本）、挂载云存储桶（自动同步阿里云oss/腾讯云cos）、cli工具导入（终端党高效操作）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想让MiniMax Agent读取你电脑里的PDF合同、会议纪要或产品说明书，但上传按钮点了没反应、文件拖进去没识别、或者提示“不支持该格式”——这通常不是Agent坏了，而是你没走对入口或没选对方式。Minimax平台提供四种互不干扰的文件导入路径，适配不同场景和操作习惯，选错一种就卡在第一步。
Web界面上传：适合单次传1～3个常规文档
这是最直观的方式，专为临时上传、快速验证内容效果设计，不需要装工具、不写代码，但仅支持PDF/TXT/DOCX/MD等文本类格式。
打开Minimax控制台 → 进入【知识库】模块 → 点击右上角“新建文档” → 选择“上传本地文件”。
在弹出的系统文件选择窗口中，【必须取消勾选“隐藏文件”选项】，否则你放在桌面的“.draft.md”这类带点开头的文件会被自动过滤掉。
选中文件后直接点击“打开”，页面显示蓝色进度条即开始上传；进度条走完不代表解析完成，需等待右下角出现绿色“已就绪”标签，才算真正可用。
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引用该文档的唯一钥匙，【务必存下来，API不提供二次查询接口】。
挂载云存储桶：适合文档长期存放在阿里云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批量检索。
