MiniMax Agent常见问题自动回复教程

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密钥未过期。"}]}。

这一步不能跳过，

编写带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关键词只匹配半角）；③JSON中keywords数组是否用了中文引号“”而非英文引号""。