MiniMax Agent 要实现基于结构化 FAQ 逻辑的自动回复高频问题，需要在系统提示词中嵌入包含 faq_list 字段的 JSON 知识库；其中 keywords 数组不能为空，也不能包含空字符串。调用接口时，messages 中不能额外携带 system 字段；调试阶段还需关闭历史上下文，并确认关键词使用半角英文引号包裹。
如果你希望 MiniMax Agent 自动识别用户提问中的常见问题，例如“怎么退款”“API 调用失败”“积分怎么查”，并直接返回预设的标准回复，从而减少重复人工答复、提高客服效率与服务一致性，就需要在 Agent 的系统提示词中加入结构化 FAQ 规则。同时还要确保请求体中不携带多余的 system 字段，否则模型可能会忽略已有的预设规则。
准备FAQ知识库与匹配关键词
可先从客服工单、用户咨询记录或历史对话中整理至少 5 条高频问题，并为每条问题提炼 2～4 个核心关键词。关键词建议不含标点，且默认不区分大小写。例如，“退款流程”可以拆分为【退款、退回、钱没到账、订单取消】。
建议将每组关键词及其对应的标准回复统一整理为 JSON 数组，字段名必须使用 faq_list，格式如下：{"faq_list":[{"keywords":["退款","退回"],"reply":"请提供订单号，我们将在2小时内核实并原路退回。"},{"keywords":["API","401"],"reply":"请检查Authorization头是否含Bearer前缀，且API密钥未过期。"}]}。
这一步非常关键，【如果keywords数组为空，或者其中包含空字符串，Agent 会直接忽略 FAQ 匹配逻辑】。
编写带FAQ解析逻辑的系统提示词
在 Minimax 控制台的 Agent 配置页面中，找到“系统提示词”输入框，并粘贴以下模板（请保留原有换行和缩进格式）：
你的角色是专业客服助手，回复时请严格遵循这套流程：①先快速检查用户消息，判断是否命中faq_list里任意一个keywords数组；②一旦命中，直接返回对应的reply字段，不额外解释，不修改标点，也不要自行补全句子；③只有在未命中的情况下，才进入常规推理流程。当前FAQ知识库：
```json
{faq_list}
```
注意：{faq_list} 这个占位符必须替换为上一步生成的完整真实 JSON，不能留空，也不能仅保留变量名。该提示词能够正常生效的前提是 Agent 已经完成发布，并且调用时 messages 中没有额外添加 system 角色消息，否则会覆盖这里的配置内容。
测试与验证FAQ触发效果
第一步：打开 Minimax 控制台 → 进入 Agent 列表 → 点击目标 Agent 右侧的“调试”按钮。
第二步：在 Web 聊天框中输入一条包含关键词的测试消息，例如：“API 401 错误怎么办”。
第三步：查看返回结果是否与 faq_list 中预设的 reply 完全一致，包括标点、空格和换行。如果返回的是模型自由生成的长篇解释，通常说明系统提示词没有生效，或者 keywords 没有匹配成功。
第四步：如果没有触发 FAQ 自动回复，请立即排查以下三点：①调试页面是否开启了“启用历史上下文”开关（必须关闭）；②输入内容中是否夹杂中文全角标点（FAQ 关键词通常只匹配半角）；③JSON 中的 keywords 数组是否误用了中文引号“”而不是英文引号""。