文件上传需按场景选择正确方式：桌面端拖拽最快，网页端知识库适合长期存储，cli适合批量同步，api适用于自动化流程。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要把本地文件交给MiniMax Agent处理，比如让它读PDF写摘要、分析Excel数据、整理桌面杂乱文件，但卡在第一步——文件根本传不进去。这不是权限问题，也不是网络问题，而是没找对上传入口和触发方式。
桌面版Agent直接拖拽上传
这是最快最直观的方式，适用于Mac或Windows桌面客户端已安装且运行中的场景。
打开MiniMax Agent桌面应用，确保右下角状态栏显示“已连接”；
将需要处理的文件（支持PDF、DOCX、XLSX、TXT、PNG、JPG、ZIP）直接拖入主界面空白区域；
松手后界面会出现蓝色高亮边框与“正在解析…”提示，【此时不要切换窗口或最小化应用，否则解析可能中断】；
等待3～10秒，文件名下方自动出现“✅ 已就绪”图标，即可输入指令，例如：“提取这份合同里的甲方信息和付款条款”。
网页端知识库批量导入
当你有一批文档要长期存入Agent记忆系统，供后续反复调用，就得走知识库路径。它不响应单次指令，但能让Agent记住内容并跨会话引用。
方法一：Web控制台手动上传
登录MiniMax开发者平台→左侧导航栏点击“知识库”→选择已有知识库或新建一个→点击“添加文档”→选择“上传文件”→多选文件后确认；
上传完成后，页面显示“解析中”，【PDF超过50页或含扫描图时，OCR阶段可能耗时2分钟以上，页面无进度条，需耐心等待】；
解析成功后，每份文档右侧出现“可用”标签，此时可在Agent对话中提及其标题，如：“参考《2024销售协议V3》第5条”。
方法二：CLI命令行极速同步
适用于熟悉终端操作的用户，尤其适合把整个项目目录一键推入知识库。
先执行minimax-cli login完成身份绑定；
再运行：minimax-cli knowledge upload --path ./docs --format pdf,md --recursive；
该命令会递归扫描./docs下所有PDF和Markdown文件，自动过滤隐藏文件与临时文件（如.DS_Store、~$report.docx）；
上传完毕后终端输出类似✅ 12 files indexed, 0 failed，表示全部进入向量化队列。
通过API接口上传并绑定任务
如果你正在开发自动化流程，比如收到邮件附件后自动喂给Agent分析，就必须用API方式上传，并立刻关联后续动作。
第一步：构造带元数据的上传请求
向POST https://api.minimax.chat/v1/knowledge/documents发送multipart/form-data请求；
Header中必须包含Authorization: Bearer sk-xxx与Content-Type: multipart/form-data; boundary=xxx；
Body中除file字段外，必须携带metadata JSON字符串，至少含{"source": "email_attachment", "task_id": "20260811-773"}；
第二步：获取文档ID并触发处理链
响应体中提取document_id字段值；
立即发起第二个API调用：POST https://api.minimax.chat/v1/agents/{agent_id}/run；
Body中填入：{"input": "分析这份来自客户邮件的报价单，对比历史版本找出价格变动项", "context": {"document_ids": ["doc_abc123"]}}；
【注意：document_ids数组里必须是上一步返回的真实ID，不能填文件名或本地路径，否则Agent完全无法定位内容】。
