---
title: "提示词风格指南"
description: "如何编写和编辑 ThunderPhone 语音智能体的提示词：提示词审查检查的指南，以及其发现引用的 ID。"
---

{/*
  GENERATED FILE: do not edit by hand.
  Source: api/agents/prompt_style_guide.md
  Regenerate: python3 scripts/docs-freshness/generate_prompt_style_guide.py
  CI regenerates this page and fails on drift
  (scripts/docs-freshness/generators.d/50-prompt-style-guide.sh).
*/}

<Note>
  这是[提示词审查](/api-reference/agents#review-a-prompt)用于检查提示词的指南，其检查结果会引用下方的 ID。连接到
  [MCP 服务器](/zh/guides/thunderphone-mcp-server)的编程智能体会将相同文本读取为资源
  `thunderphone://guides/prompt-style`。有关模板和示例，请参阅
  [提示词指南](/zh/guides/prompting)。
</Note>

本指南适用于编写或编辑语音智能体提示词的所有人：构建器中的人员、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 听觉能力），回复缓慢可能与智能或听觉层级，或断句设置有关。在重写文本之前，先排除配置问题。
