Open in
提示词风格指南
如何编写和编辑 ThunderPhone 语音智能体的提示词:提示词审查检查的指南,以及其发现引用的 ID。
本指南适用于编写或编辑语音智能体提示词的所有人:构建器中的人员、Copilot,或通过 API 工作的编程 智能体。提示词审查工具将其作为评估标准,并引用其指南 ID(P1、W2 等)。
来电者只会以正常语速听到智能体说一次,且无法回看。智能体会在每个轮次阅读提示词,并严格沿用其中的措辞。这两个事实决定了以下所有内容。
结构
P1. 按照真人向新接待员交代工作的方式来写。 简短的开场应说明智能体是谁,以及它为谁工作。随后按通话实际发生的顺序展开:如何开场、需要了解什么、需要确认什么、如何结束。每条规则都应放在其适用的通话环节中。读者应能针对每一段提出这样的问题:“经营这家企业的人会这样写吗?”需要了解的内容应涵盖企业处理该请求所需的信息,而不仅是来电者是谁以及如何联系他们。
P2. 使用简单的标题,并在下方写正文。 “您是谁”“通话”“事实”和“转接”等标题很有帮助。机器式结构则没有帮助:编号规则手册、camelCase 或类似代码的标题、长篇使用破折号作为项目符号的规则列表、开头的工具参考,以及“请参阅下方第 4 节”之类的交叉引用。对于智能体需要查找的数据(营业时间、价格、地址),可以使用列表。
P3. 简要说明一次说话方式。 智能体在整个通话中的说话方式(简短的第一人称回应、亲切、用词朴实;参见 S2)应放在靠前位置的一小段中。某个步骤特有的内容应放在该步骤中。
P4. 将事实与行为分开。 营业时间、价格、地点、政策和其他事实应放在提示词的事实部分或知识库中,而不是分散在通话流程中。较长的目录和常见问题应放在知识库中。智能体只能陈述已向其提供的事实。
内容
C1. 原则和事实,而不是脚本。 描述智能体要实现的目标以及需要了解的信息。不要加入“如果来电者说 X,就说 Y”这样的分支、针对预期问题的脚本化回答或套话。已配置的开场问候语是唯一的脚本化元素。
C2. 修复应说明一般原则。 当提示词变更是为了应对已观察到的失败时,变更应补充一般原则或缺失事实,而不是仅针对该个案打补丁。失败通话的具体细节(姓名、数字和原话)不得写入提示词。
C3. 优先删减,而不是添加。 当失败可追溯到某条现有规则过于具体、过于宽泛或位置不当时,应修改或删除该规则,而不是在旁边添加一条相反的规则。
C4. 某些事项由设置决定,而不是提示词。 以下属于智能体设置,提示词中关于它们的文本会被忽略或与设置冲突:工具运行期间说什么(工具启动语句、填充短语)、静默确认及静默后的最终操作、复述确认的节奏、语言切换方式、录音提示,以及由智能体还是来电者先说话。应让提示词指向结果(“保存前确认电子邮件地址”),然后设置相应选项。开场问候语本身应写在提示词中。
C5. 示例是智能体会说出的句子。 智能体几乎会逐字复用示例措辞,因此每个示例都应是完整、自然的口语句子,多个不同示例优于单个示例。应将它们作为示例引入(“例如,您可以这样说……”),而不是作为必须说出的固定语句。“仍然准确吗?”这类简短标签一旦说出口会显得生硬。
C6. 不要使用我们客户通话中的示例。 示例应以概括性方式描述情境,或使用虚构企业。
C7. 提示词面向来电者,而非构建过程。 提示词上线后,来电者会听到其中的所有内容,因此应省略有关构建、测试或合规状态的说明(“此版本用于测试”、预约名称中的“TEST”、 “在协议签署之前”)。还应省略企业未要求的免责声明、责任限制说明和结束时的回顾,例如接受某个方案并不代表什么,或对尚未确认内容的总结。智能体回答来电者提出的问题后即结束;企业需要免责声明时会自行添加。缺失的事实或系统限制应写成智能体的行为(“如需价格,请提供由办公室回电的选项”),而不是说明该信息未提供或请求如何被记录;也不应保留起草过程中的任何残留内容,例如多余的名称或标题。
措辞
W1. 用清晰的话说一次该做什么。 用日常语言将所需行为表述为指令:“逐位复述订单编号,以便来电者可以更正。”在适用的位置说一次即可。
W2. 不要强调。 不要使用“重要”“注意”或“关键”标签,不要用全大写单词加强语气,不要使用感叹号,不要使用“错误:”和“正确:”对比,也不要大段说明不要做什么。用于加强语气的“绝不”“始终”和“必须”等词也属于这一类。强调会让模型将注意力集中在某一条规则上,从而降低其处理通话其余部分的能力。当智能体忽略某项指令时,应使指令更清晰、更具体或放在更合适的位置,而不是加强语气。
W3. 修复导致行为的结构。 在添加一条禁止智能体某种行为的规则之前,先找出引导它产生该行为的措辞或结构:模型会按字面填充的模板、具有两种含义的术语,或快速模型会宽泛解读的 if-else 分支。应修改这些内容。
W4. 具体优于笼统。 “提供最早的两个可预约时段,然后询问哪个合适”优于“协助安排日程”。模糊的指令会产生模糊的行为。
W5. 先查询,再提问。 当来电者提到只读查询工具可以核实的内容(产品、订单或现有预约)时,智能体应使用来电者提供的词语进行查询,只有在结果需要时才继续追问。“查询来电者提到的产品库存,并告知他们查询结果”优于“先确认品牌、尺寸和款式,再查询库存”:被要求先确认的智能体会不断提问,查询永远不会执行。这仅适用于查询。在使用可预约、修改、取消或保存内容的工具之前,智能体仍应与来电者确认详细信息。
语音
S1. 每轮只问一个问题,并以问题结束该轮。 问题之后的任何内容都会盖过来电者的回答。应将所有说明放在问题之前。
S2. 简短轮次,使用完整的口语句子。 除非来电者要求详细说明,否则每轮使用一两句简短的话。 口头提供的选项应限制在几个以内。简短是指字数少,而不是句子残缺:智能体应像优秀的电话接待员一样,以第一人称说完整的句子,例如“我现在就为您安排。”或“我已为您安排在周一十点。”备注式的片段(“正在为您安排。”“已完成。”“已记录。”)说出来会显得生硬,而电子邮件式的措辞(“请注意……”“敬请……”“希望这能帮到您”)听起来像是在朗读,而不是在说话。提示词中的说话方式段落应明确提出这一点,例如:“每轮保持一两句话,并像电话接待员那样用第一人称说话。”
S3. 为听觉而写。 在智能体说出的内容中,避免使用语音会以不自然方式读出的 Markdown、符号和记法(斜杠、& 符号、“@”、“.com”、千位分隔符、未分隔的电话号码)。智能体传递给工具的事实和值(例如电子邮件地址或账号)应保持其准确的书写形式;如果其中某项也必须说出来,应在旁边补充其说法,而不是重写它。应写明不常见姓名或首字母缩略词的读法,并在保留新术语前先试听它们在智能体语音中的效果。
S4. 确认出错代价高的信息。 数字、电子邮件地址、地址和代码应按来电者提供时的形式复述一次,在来电者提供信息后紧接着的回复中、提出下一个问题之前进行,每次复述仅确认一个值。默认情况下,姓名按来电者所说记录,不进行复述;仅当姓名不常见或不清楚时,智能体才询问其拼写,且只询问一次。当企业需要准确的姓名时,例如需要与其记录匹配,或以该姓名进行预约,提示词应明确说明,智能体应拼读该姓名以供确认。复述是让来电者更正信息的机会,而不是一道关卡:如果来电者回答下一个细节,或在未更正的情况下继续交流,即表示其已接受该值,之后不应再次询问已接受的值。企业将用于回电或发送短信的电话号码是例外:复述该号码后应结束本轮,并等待来电者回应。要求逐位读取的提示词,只列出需要如此读取的值(电话号码、代码);门牌号、价格、时间或日期应按人们通常的说法读出。提示词说明需要确认什么;平台控制复述节奏。
迭代
I1. 在保留更改前先进行测试。 在编辑后的草稿上重放智能体的开发集,并与当前版本进行比较:某项更改修复了哪些示例,又破坏了哪些示例。以来电者实际听到的方式阅读回复。来电者会注意到的任何问题都不是细节,而是问题。
I2. 留出集只检查一次。 仅在开发集上调优。当某项更改准备就绪时运行测试集,并如实报告结果。在查看测试结果后做出的更改需要新的测试示例。
I3. 当补丁不断累积时进行重构。 收集了许多小修复的提示词会偏离 P1:规则会重复、冲突,或距离其约束的步骤太远。此时应将其重写为这种结构,同时保留它要求的所有行为。将每项行为列为保留、合并、改写或删除,不要悄然删除任何内容。重放重构前后的开发集;重构应改变措辞,而非行为。
I4. 在提示词之前检查配置。 有些故障并非由提示词导致:误听逐个拼读的字母属于听觉能力限制(请尝试 Plus 听觉能力),回复缓慢可能与智能或听觉层级,或断句设置有关。在重写文本之前,先排除配置问题。