需在MiniMax开发者控制台为Agent启用“文件读取”和“文件解析”权限，保存发布后，方可通过Web UI拖入文件或API传file_url调用解析功能，并支持多文件交叉分析与结构化输出。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让MiniMax Agent直接读取、解析或处理你本地的Excel表格、PDF说明书、Word合同这些文件，而不是手动复制粘贴文字进去问问题。
确认Agent已启用文件工具权限
进入MiniMax开发者控制台 → 左侧导航栏点击【Agent】→ 找到你要配置的Agent → 点击右侧【编辑】→ 切换到【工具】标签页。
勾选“文件读取”和“文件解析”两个能力，其他如“图像识别”“视频分析”按需开启。⚠️【未勾选文件读取权限时，Agent收到文件会直接报错“不支持该操作”，不会尝试解析内容】
点击【保存并发布】，等待状态变为“已发布”才生效。
在Web UI中上传并触发解析
打开Agent调试页面（控制台→Agent列表→对应Agent右侧【调试】按钮），进入聊天窗口。
直接将PDF、Excel、TXT、DOCX等文件拖入对话框，或点击回形针图标选择文件。
文件上传完成后，Agent会自动识别类型并调用对应解析器——PDF走OCR+文本提取，Excel走结构化表格解析，Word走语义段落切分。
这时你不需要额外输入指令，Agent会主动回复：“已读取《用户协议_v2.3.pdf》，共17页，含3个关键条款章节。”
通过API调用时传入文件URL
方法一：使用MiniMax托管文件服务
调用POST https://api.minimax.chat/v1/files/upload接口上传文件，获取返回的file_id和file_url。
在后续的chat completion请求中，把file_url作为messages数组中一条message的content字段值，格式为：{"role":"user","content":[{"type":"file_url","url":"https://files.minimax.chat/xxx"}]}。
方法二：自行托管文件并提供可公开访问的HTTPS直链
确保你的文件放在Nginx、S3或GitHub Pages等支持CORS且无需登录即可GET访问的地址上。
【必须是HTTPS协议，HTTP链接会被Agent拒绝；链接必须能被MiniMax服务器直接curl通，内网地址或带登录跳转的链接均无效】
将该直链填入上述file_url字段位置即可。
让Agent执行具体文件操作任务
第一步：明确指定动作
不要只说“看看这个Excel”，要写清目标，例如：“从附件《销售数据Q2.xlsx》中提取所有‘华东区’的订单金额总和，并列出前5名客户。”
第二步：限定输出格式
加一句“请用JSON格式返回，字段为{total, top5: [{name, amount}] }”，Agent会严格按此结构输出，方便你程序直接解析。
第三步：处理多文件交叉分析
同时上传PDF说明书 + Excel测试数据 + Word需求文档后，可提问：“对比说明书第4.2节要求与Excel中实测结果，指出3处偏差，并引用Word文档中的验收标准佐证。”
Agent会跨文件定位原文段落、提取数值、比对逻辑，生成带引用锚点的结论。
