要让 AI 客服话术“吸引人”，重点通常是改结构而不是堆形容词：第一条回复先复述用户问的那个具体对象（商品、订单、功能名），第二句给出能确定的答案，第三句给一个成本很低的下一步动作。用户觉得“这个客服懂我”，往往是因为第一句就命中了具体实体，语气亲切与否反而不是关键。下面按配置和排查顺序写，话术本身是写进提示词模板或话术编辑器里的文本，改完之后能否生效、是否越权、有没有走知识库，都要靠页面字段和接口返回值确认。
适用场景：在线客服机器人的首响与追问话术，尤其是尺码、退换、发货时效这类高频问题。操作动作：把话术拆成“复述问题 + 给结论 + 给下一步”三段，写进系统提示词，价格时效类信息只允许引用知识库片段。验证方式：用 20 条真实历史会话在调试面板回放，逐条看首句是否命中用户问的实体、是否出现知识库里没有的数字。风险边界：涉及价格、赔付、时效的话术不能交给模型自由生成；不同平台的版本号字段、权限项名称差异较大，需要结合自己的控制台确认，不要照抄字段名。
AI客服话术之前先确认这三件事
话术写得再好，如果改错版本、权限不够、或者改了一份线上不读的文件，效果都不会出现。这三件事建议在动笔前就核对完。
1. 版本。要确认线上正在跑的是哪一版话术模板。查看位置通常是控制台「机器人 / 助手 → 概览」里的“当前发布版本”字段，或者配置文件头部的版本行。用接口核对更直接：
curl -s -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.example.com/v1/bots/BOT_ID/config"返回体里一般能找到 version 和 system_prompt 两个字段。如果你本地改的文件和这里返回的文本对不上，说明改的不是线上那一份。
2. 权限。话术编辑和发布经常是两个不同的权限点。查看位置：控制台「成员与权限 → 角色」看自己的角色是否带“话术编辑 / 发布”，API Key 详情页看 scope 列表里有没有 bot:write 这类写权限。只读 Key 调更新接口会直接被拒，这一点在后面的排查小节会再出现。
3. 入口位置。话术可能写在两个地方：可视化「话术 / 提示词编辑器」里，或者代码仓库的 prompts/cs_system.md。要确认发布流程读哪一个。常见情况是编辑器里改了但发布流水线从仓库拉文件覆盖，或者仓库改了但没点发布。先在编辑器里搜一段独特文本（比如“转人工”），看仓库文件里是否也搜得到同一段，两边都有就说明存在两份来源。
AI客服话术：最短可用路径
从零到能跑通，保留四步就够，每步做完都有一个可观察的结果。
拉取当前配置。用上面的 curl 保存成
current_config.json。做完应该看到文件里有version和完整的系统提示词文本；如果返回 401，先回去查权限，不要继续往下走。写话术骨架。新建
prompts/cs_system.md，按三段式写，把变量位置标出来：# 角色 你是「某某店」在线客服，只处理尺码、发货、退换三类问题。 # 回答结构（每次按顺序，不要输出小标题） 1. 复述问题：一句话确认用户问的商品或订单，例如“您问的是 {{product_name}} 的尺码”。 2. 给结论：先给能确定的答案，控制在 40 字以内。 3. 给下一步：只给一个动作，例如“回复身高体重，我帮您选码”。 # 硬性约束 - 价格、时效、赔付金额只能引用【知识库片段】；片段为空时回答“我帮您转人工确认”。 - 不连续使用两次以上“亲”。 - 不出现“一定”“保证”“当天到”这类承诺。做完应该得到一个 300 字以内的模板。超过 500 字时，模型容易只执行前面几条约束，后面的结构要求会被稀释。
调试面板跑样例。在控制台「调试 / 沙箱」页，把模板粘进去，输入三条真实问题（一条尺码、一条退换、一条问价格）。做完应该看到每条回复都是“复述 + 结论 + 下一步”的结构；问价格那条如果知识库没命中，应该落到“转人工确认”而不是给出一个数字。
发布并回放。点发布后，重新调一次第 1 步的 curl，确认
version已经变化、system_prompt与本地文件一致。做完这一步才算上线。
AI客服话术：一个真实场景的完整做法
设定一个卖鞋的店铺：知识库约 120 条 FAQ，绝大部分咨询集中在尺码和退换，每天几十条会话。这个规模和问题分布决定了话术不需要覆盖太多品类，把尺码追问做透就够。
配置写在 prompts/cs_system.md 和机器人设置页两处，具体取值如下：
- 系统提示词：用上一步的三段式模板，角色限定为“只处理尺码、发货、退换”。
- 开场白（控制台「欢迎语」字段）：
您好，鞋码问题直接发身高体重和平时穿的码，退换请发订单号。——开场白直接给动作，比“请问有什么可以帮您”更容易让用户一句话说清需求。 - 检索参数（「知识库 → 召回设置」页）：
top_k = 3，相似度阈值0.72左右起步。FAQ 只有百余条时，召回条数给太多反而会把不相关条款带进上下文。 - 生成参数（「模型设置」页）：
temperature = 0.3，max_tokens = 200。客服话术要稳，不需要发挥。 - 兜底话术（「兜底 / 转人工」页）：
这个我确认一下，先帮您转人工，稍等。 - 转人工条件：连续两轮未命中知识库，或用户输入里出现“投诉”“退款没到”时直接转。
验证时拿 10 条历史会话回放，重点看两件事：问尺码的会话里，首句有没有复述具体鞋款；问价的会话里，有没有出现知识库之外的数字。前者决定话术是否“吸引人”，后者决定话术能不能上线。
AI客服话术：跑不通先查这三处
按实际遇到的频率从高到低排。
卡点一：改完不生效。页面提示形如“草稿已保存，线上仍为 v12”。判断方法：先看控制台顶部的版本徽标，再调第 1 步的 curl 看返回的 version 和提示词文本。两处版本号一致但对话仍是旧话术，就去查发布流水线是不是从仓库重新拉了文件覆盖；仓库和编辑器两份来源同时存在时，这类问题会反复出现。检查位置：控制台概览页、prompts/ 目录、发布记录页。
卡点二：回复里出现知识库没有的数字。典型表现是知识库写“48 小时内发货”，回复却说“3 天内发出”。判断方法：在「对话日志 → 单条详情」里看 retrieved_chunks 字段是否为空。为空还输出了时效，说明提示词里没有把“片段为空就转人工”写死，或者兜底分支被模型绕过了。检查位置：对话日志的召回字段、提示词中的硬性约束段、temperature 取值。
卡点三：保存或发布被拒。接口返回形如 401 Unauthorized，或 {"code":"FORBIDDEN","message":"missing scope: bot:write"}。判断方法：看 API Key 详情页的 scope 列表和控制台角色页，确认写权限是否单独授予；改话术和发布话术常常是两个权限。检查位置：API Key 详情页、成员与权限页。