文件上传需按场景选择正确方式:桌面端拖拽最快,网页端知识库适合长期存储,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完成身份绑定;
Agent Security DLP - 企业级数据防泄漏系统 功能: 入口防护、记忆保护、工具管控、出口过滤、审计日志 规则: 170条,覆盖金融、医疗、汽车、销售、人力资源、物流等25+行业 触发: check-output(对话出口) / check-input(对话入口) / check-tool(工具执...
再运行: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完全无法定位内容】。

















