必须将知识库接入工作流才能让MiniMax Agent引用真实文档而非凭空生成：第一步整理PDF/Excel等格式的原始文件并OCR处理扫描件；第二步在网页端上传解析；第三步在Bot工作流中配置知识库检索节点并正确连接输入输出；第四步通过调试验证返回内容是否准确匹配原文。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想让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。
MiniMax 语音合成技能 - 支持同步/异步文本转语音(T2S)、音色克隆(Voice Clone)、音色设计(Voice Design)、音色查询与删除。使用模型 speech-2.8-hd，输出 mp3/wav/pcm 音频文件至本地。
第三步：配置工作流中的知识库节点
进入【Bot管理】→选择目标Bot→点击【工作流】标签页→在画布空白处双击，或从左侧节点栏拖入【知识库检索】节点。
点击该节点，在右侧面板中下拉选择刚创建的知识库名称；设置“最大返回片段数”为3–5（太多会干扰LLM理解，太少可能漏关键信息）；勾选“启用语义匹配”（默认开启，禁用则退化为关键词搜索）。
将用户输入消息连接至该节点的“query”输入口；再把该节点的“retrieved_content”输出口，连到后续LLM节点的“context”字段——【顺序不能颠倒：必须先检索，再把结果喂给LLM，否则LLM只能瞎猜】。
第四步：验证知识库是否生效
保存工作流后，点击右上角【调试】按钮，输入一个明确指向知识库内容的问题，例如：“差旅住宿标准最高是多少？”或“试用期解除合同需要提前几天通知？”
观察调试面板左侧的“执行路径”，确认【知识库检索】节点被触发且返回了非空content；右侧输出中应出现来自你上传文件的具体条款原文，而非泛泛而谈的通用答案。
如果返回内容为空或明显偏离，检查知识库是否处于“启用”状态（顶部开关为蓝色），以及问题表述是否包含知识库原文中的核心词——知识库不支持模糊联想，依赖语义向量匹配，需有基本关键词锚点。
