必须配置外部知识库接入路径，否则minimax agent无法准确引用公司专有文档；通过minimax data platform上传jsonl问答对或单文件文档（pdf/txt/md）可快速启用，需绑定意图标签、上传后复制知识库id，并在agent配置页或api中显式绑定，最后用真实问题验证命中效果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想让MiniMax Agent自动回复时能准确引用公司产品手册、客服FAQ或内部流程文档，必须配置外部知识库接入路径，否则模型只能依赖通用语料作答，无法响应专有术语与业务规则。
通过Minimax Data Platform上传启用知识库
这是最轻量、无需代码的配置方式，适合非技术运营人员快速上线标准问答库，但仅支持JSONL问答对或单文件文档（PDF/TXT/MD），不支持实时数据库对接。
第一步：登录Minimax控制台，进入【知识库管理】→【新建知识库】，类型选“问答对(Q&A)”，名称填“客服FAQ主库”。
第二步：在设置中开启“意图识别增强”，绑定已有的“退款咨询”“物流查询”等意图标签——【未绑定意图会导致知识检索命中率下降40%以上】。
第三步：准备JSONL格式文件，每行一个问答对，示例：{"question":"怎么查物流？","answer":"请提供订单号，我帮您实时查询顺丰/中通/京东物流轨迹。"}，单次最多上传10个文件，总大小不超过200MB。
第四步：上传完成，等待状态变为“已就绪”，复制生成的知识库ID（如 kb_7x9f2m8q），该ID将用于后续API调用或Agent绑定。
在Agent配置页绑定知识库
知识库本身不自动生效，必须显式关联到具体Agent实例，且需注意模型兼容性——abab6.5s-chat可直接调用，M2.5-search需额外开启联网权限。
方法一：网页端一键绑定
进入Agent详情页→【配置】→【知识库】→点击【添加知识库】→粘贴上一步复制的kb_7x9f2m8q→勾选“启用知识检索”→保存。
方法二：API方式动态绑定
调用PUT /v1/agents/{agent_id}/knowledge接口，Body中传入{"knowledge_base_ids": ["kb_7x9f2m8q"]}，Header带Authorization: Bearer {api_key}——【此操作会覆盖已有知识库列表，不是追加】。
验证知识库是否生效
不要只看控制台显示“已启用”，必须用真实业务问题触发检索链路，观察响应是否包含知识库原文片段。
在Agent调试界面输入：“退货地址填错了怎么办？”
若返回内容含“请重新提交退货申请，地址修改截止时间为签收后24小时内”，说明知识库命中成功；若回复泛泛而谈“您可以联系客服”，则知识库未生效或问题未匹配到条目。
检查点：打开浏览器开发者工具→Network→筛选fetch→点击对应请求→查看Response中的retrieved_knowledge字段是否为空数组。
