扣子平台提示词调试需四步：先确认系统提示词开关已启用；再分步排查角色覆盖、约束未校验、知识库未绑定三类失效点；接着用日志节点、变量检查、原始响应日志逐层拦截；最后通过few-shot示例、拒答规则和显式记忆声明优化稳定性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在扣子平台配置完提示词后，发现智能体回答跑偏、格式错乱、关键信息遗漏，甚至反复生成无关内容——这不是模型不行，而是提示词在运行时暴露了隐性缺陷，必须进入真实环境调试才能定位问题根源。
确认提示词是否已生效
进入智能体编辑页→点击右上角「测试」按钮→在弹窗中输入一条典型用户问题→观察返回结果是否与你设定的角色、指令、约束完全一致。如果返回仍是默认风格（比如用“我理解了”开头、无指定格式、未调用知识库术语），说明提示词根本没加载成功。
此时不要重写提示词，先检查【系统提示词开关是否开启】：在「大模型设置」区域，确认「启用系统提示词」复选框已被勾选。该开关默认关闭，未开启时所有提示词文本形同虚设。
快速定位三类高频失效点
方法一：角色设定被覆盖
若提示词中写了“你是一位医疗法律顾问”，但测试时回答仍像普通客服，大概率是工作流中某处节点（如插件调用后）重置了上下文。需检查所有连接至大模型节点的上游节点输出，确保没有意外插入“你是AI助手”之类覆盖性语句。
方法二：约束条件未强制执行
例如你要求“输出必须为JSON格式且含status、message、data三个字段”，但返回却是纯文本段落。这不是模型不听话，而是约束未加校验机制——必须在大模型节点的「输出解析」中启用JSON Schema校验，并填写对应结构定义，否则模型仅当建议看待。
方法三：知识库引用失效
上传了《2026医保报销细则.pdf》并写入提示词“依据附件文档第3.2条执行”，但测试时完全无视该条款。此时要验证：【知识库资源是否已绑定至当前智能体】，且在「资源感知」设置中勾选了该文件；同时提示词中不能写“见附件”，必须明确写成“根据已加载的知识库《2026医保报销细则》第3.2条”。
分步调试：从输入到输出逐层拦截
第一步：在开始节点后插入「日志节点」，打印原始用户输入，确认接收内容无截断、编码错误或隐藏字符。
第二步：在大模型节点前插入「变量检查节点」，查看提示词拼接后的完整字符串——重点核对换行符是否被转义、中文标点是否变成全角、占位符${xxx}是否被正确替换。常见坑：复制粘贴时混入不可见的Zero Width Space（U+200B），导致整段提示词被模型忽略。
第三步：启用大模型节点的「原始响应日志」开关，获取模型未经任何后处理的原始输出。若此处已偏离预期，说明问题出在提示词本身；若此处正确但最终返回异常，则问题在后续节点（如格式转换、插件过滤）。
第四步：将原始响应日志中的文本复制回本地Chat工具，用同一模型（如豆包-1.5-Pro-32k）单独测试，验证是否为扣子平台特有解析偏差。若本地表现正常，需检查扣子侧的「响应后处理规则」是否误启了自动摘要或敏感词过滤。
实战优化：让提示词在真实对话中稳定输出
把测试中暴露出的典型失败案例（如用户问“报销需要哪些材料”，AI却列出药品目录）直接加入提示词末尾的Few-shot示例区，格式为：用户输入→期望输出。至少放3个真实失败样本，模型会优先模仿这些强信号。
对关键约束添加双重保险：例如要求“禁止提及政策未覆盖地区”，除了在提示词中声明，还需在大模型节点的「拒答规则」里手动添加关键词黑名单，如“西藏”“新疆生产建设兵团”等易被误判的地理名词。
当智能体需处理多轮上下文时，提示词开头必须显式声明记忆机制：“你拥有对话历史记忆，当前轮次需结合前两轮用户提问与你的回答共同推理。若用户未提供新信息，不得虚构补充。”否则模型会在第三轮突然“失忆”或编造前序内容。
