MiniMax Agent工作流连接知识库教程

要让 MiniMax Agent 在工作流中引用真实文档内容、而不是凭空生成结果，必须先完成知识库接入。可按以下顺序处理：

，整理 PDF、Excel 等格式的原始文件，并对扫描件进行 OCR 识别；，在网页端完成文件上传与解析；，在 Bot 工作流中配置知识库检索节点，并正确连接输入与输出；，通过调试验证返回内容是否能够准确匹配原文。

想让MiniMax Agent在回答问题时自动引用你自己的PDF、Excel或内部文档，而不是只靠模型记忆胡编乱造，就必须把知识库接入工作流。这一步不做，Agent再聪明也只会“凭空想象”，无法调用你公司的真实数据。

第一步：准备知识源文件

把你要喂给Agent的原始材料整理成单一目录，支持格式包括PDF、DOCX、XLSX、TXT、MD，不支持压缩包或扫描版图片PDF。若文件含扫描文字，请先用OCR工具转成可选中文本——否则后续切片会失败，整个知识库将无法检索。

文件名建议用中文+下划线命名，例如“2026_财务报销制度_v3.docx”，避免空格和特殊符号。系统对文件名长度无硬限制，但过长（超64字符）可能在部分界面显示截断。

第二步：上传并解析知识库

登录MiniMax Agent网页端（https://agent.minimaxi.com），进入左侧菜单【知识库】→点击【新建知识库】→填写名称（如“HR政策库”）→点击【上传文件】→从本地目录中批量拖入已准备好的文件。

上传完成后，系统自动启动解析：PDF提取文字+表格结构，Word保留标题层级，Excel识别Sheet与字段名。解析状态条显示“处理中”时，不要关闭页面或刷新——

。

全部解析完成（通常1–3分钟/MB），状态变为“就绪”，右侧会显示成功解析的文件数与总文本量（单位：token）。若某文件显示“解析失败”，鼠标悬停可查看原因，常见为加密PDF或损坏XLSX。

第三步：配置工作流中的知识库节点

进入【Bot管理】→选择目标Bot→点击【工作流】标签页→在画布空白处双击，或从左侧节点栏拖入【知识库检索】节点。

点击该节点，在右侧面板中下拉选择刚创建的知识库名称；设置“最大返回片段数”为3–5（太多会干扰LLM理解，太少可能漏关键信息）；勾选“启用语义匹配”（默认开启，禁用则退化为关键词搜索）。

将用户输入消息连接至该节点的“query”输入口；再把该节点的“retrieved_content”输出口，连到后续LLM节点的“context”字段——

。

第四步：验证知识库是否生效

保存工作流后，点击右上角【调试】按钮，输入一个明确指向知识库内容的问题，例如：“差旅住宿标准最高是多少？”或“试用期解除合同需要提前几天通知？”

观察调试面板左侧的“执行路径”，确认【知识库检索】节点被触发且返回了非空content；右侧输出中应出现来自你上传文件的具体条款原文，而非泛泛而谈的通用答案。

如果返回内容为空或明显偏离，检查知识库是否处于“启用”状态（顶部开关为蓝色），以及问题表述是否包含知识库原文中的核心词——知识库不支持模糊联想，依赖语义向量匹配，需有基本关键词锚点。