---
title: "提示詞風格指南"
description: "如何撰寫及編輯 ThunderPhone 語音智能體的提示詞：提示詞審核檢查所依據的指南，以及其結果引用的識別碼。"
---

{/*
  自動生成檔案：請勿手動編輯。
  來源：api/agents/prompt_style_guide.md
  重新生成：python3 scripts/docs-freshness/generate_prompt_style_guide.py
  CI 會重新生成此頁面，並在出現差異時失敗
  （scripts/docs-freshness/generators.d/50-prompt-style-guide.sh）。
*/}

<Note>
  這是 [提示詞審核](/api-reference/agents#review-a-prompt) 用來檢查提示詞的指南，
  其結果會引用以下識別碼。已連接至
  [MCP 伺服器](/yue/guides/thunderphone-mcp-server)的編碼智能體，會將相同內容讀取為資源
  `thunderphone://guides/prompt-style`。如需範本及範例，請參閱
  [提示詞指南](/yue/guides/prompting)。
</Note>

本指南適用於任何撰寫或編輯語音智能體提示詞的人：包括使用建立工具的人、Copilot，或透過 API 工作的編碼
智能體。提示詞審核工具會以此作為評核準則，並引用其指南識別碼（P1、W2
等）。

來電者只會以正常說話速度聽到智能體一次，無法向上捲動重聽。智能體會在每一輪
讀取提示詞，並密切遵從其中的措辭。以下所有內容均基於這兩項事實。

## 結構

**P1. 以真人向新接待員交代工作的方式撰寫。** 開頭簡短說明智能體的身分及其服務的對象。然後按通話實際發生的次序編排：如何開場、需要了解甚麼、需要確認甚麼、如何結束。每項規則應放在適用的通話部分。讀者應能對每一段問：「經營這間公司的真人會這樣輸入嗎？」需要了解的內容應涵蓋公司處理要求所需的資料，而不只是來電者的身分和聯絡方式。

**P2. 使用簡潔標題，標題下方寫正文。** 「你的身分」、「通話」、「資料」及「轉交處理」
等標題均有幫助。機器式結構則沒有幫助：編號規則手冊、camelCase 或類似程式碼的標題、冗長的破折號規則
清單、開首的工具參考資料，以及「見下文第 4 節」等交叉參照。清單適合列出智能體需要查閱的資料
（營業時間、價格、地址）。

**P3. 說話方式只說一次，簡短交代。** 智能體在整段通話中的說話方式（簡短的第一身回應、親切、用字淺白；參閱 S2）應放在開首附近的一小段。每個步驟的具體要求應放在該步驟中。

**P4. 資料與行為分開。** 營業時間、價格、地點、政策及其他資料應放在提示詞的資料部分，
或知識庫中，而非散落於通話流程各處。冗長目錄及常見問題應放入知識庫。智能體只可說出已獲提供的資料。

## 內容

**C1. 原則和事實，而非腳本。** 說明智能體嘗試達成甚麼，以及需要知道甚麼。不要加入「如果來電者說 X，便說 Y」的分支、為預期問題準備的腳本式答案，以及制式對白。已設定的開場問候語是唯一的腳本元素。

**C2. 修正應說明通用原則。** 當提示詞修改是針對已觀察到的失敗情況，修改應加入通用原則或缺漏的事實，而非只為該個案作修補。失敗通話的具體資料（名稱、數字、原話）不應放入提示詞。

**C3. 優先刪減，而非新增。** 當失敗可追溯至現有規則過於具體、過於寬泛或位置不當時，應修改或移除該規則，而非在旁邊新增相反規則。

**C4. 部分事項由設定決定，而非提示詞。** 以下屬於智能體設定，相關提示詞文字會被忽略或與設定衝突：工具執行期間所說的內容（工具開始提示語、填充語句）、靜默檢查提示及靜默後的最終動作、覆述的節奏、語言切換方式、錄音通知，以及由智能體還是來電者先說話。提示詞應著重結果（「儲存電郵地址前先確認」），並設定相關選項。開場問候語本身則寫在提示詞內。

**C5. 範例是智能體會說的句子。** 智能體幾乎會逐字複製範例措辭，因此每個範例都應是完整、自然的口語句子，而且幾個不同的範例勝過一個範例。應以範例方式引入（「例如，你可以說……」），而非列為指定對白。「仍然正確嗎？」這類簡短標籤說出口時會顯得生硬。

**C6. 不要使用我們客戶通話中的範例。** 範例應以通用方式描述情況，或使用虛構商戶。

**C7. 提示詞供來電者使用，而非用於說明開發流程。** 提示詞一旦上線，來電者會聽到當中所有內容，因此不應包含有關開發、測試或合規狀態的註記（「此版本用於測試」、「預約名稱中的『測試』」、「待協議簽署後」）。同樣不應包含業務未有要求的免責聲明、責任限制說明及結尾重述，例如接受方案不會確立的事項，或仍未確認內容的摘要。語音智能體回答來電者所問後便應結束；業務如有需要，會自行加入相關說明。缺少的事實資料或系統限制，應寫成語音智能體會採取的行動（「如查詢價格，安排辦公室回電」），而非註明資料未有提供或說明如何記錄請求；同時不應保留任何撰寫時遺下的內容，例如多餘的名稱或標題。

## 措辭

**W1. 清楚直接地說明要做甚麼，只說一次。** 以一般用語將所需行為表述為指示：「逐個數字覆述訂單編號，讓來電者可以更正。」在適用位置說一次即可。

**W2. 不要強調。** 不要使用「重要」、「注意」或「關鍵」標籤，不要用全大寫字母加強語氣，不要使用感嘆號，不要使用「錯誤：」與「正確：」配對，也不要大段列出不應做甚麼。用於加強語氣的「絕不」、「一律」及「必須」等字眼亦屬此類。強調會令模型將注意力集中在單一規則，反而降低其處理通話其餘部分的表現。當智能體忽略指示時，應令指示更清晰、更具體或放在更合適的位置，而非加強語氣。

**W3. 修正導致行為的結構。** 在新增規則禁止智能體某種行為前，先找出引導它作出該行為的措辭或結構：模型會逐字填寫的範本、一個有兩種意思的詞語、快速模型會寬鬆理解的 if-else 分支。修正該部分。

**W4. 具體勝於籠統。** 「提供最早兩個可預約時段，然後詢問哪個合適」勝過「協助安排時間」。模糊的指示只會帶來模糊的行為。

**W5. 先查詢，再提問。** 當來電者提及可由唯讀查詢工具核實的項目（產品、訂單或現有預約），智能體應使用來電者提供的字詞進行查詢，只有在結果需要時才提出跟進問題。「查核來電者提及產品的庫存，並告知查詢結果」勝過「先釐清品牌、尺寸及款式，然後查核庫存」：被指示先釐清的智能體會不斷提問，查詢永遠不會執行。此原則只適用於查詢。使用可預約、修改、取消或儲存資料的工具前，智能體仍須與來電者確認詳情。

## 語音

**S1. 每輪只問一條問題，並以問題結束該輪。** 在問題後補充內容會蓋過來電者的回答。所有說明應放在問題之前。

**S2. 每輪簡短回應，並以完整口語句子表達。** 除非來電者要求詳細說明，否則每輪以一至兩句簡短句子回應。口頭列出的選項應限於數項。簡短指字數少，而非斷章截句：智能體應如優秀接待員般在電話中以第一身完整句子說話，例如「我現在為你安排預約。」或「我已為你預約星期一上午十時。」備註式片語（「正在為你安排預約。」「完成。」「已記錄。」）一旦說出口便會顯得唐突；電郵式措辭（「請注意……」「敬請……」「希望以上資料有幫助」）則聽起來像照稿讀出，而非自然說話。提示詞中有關說話方式的段落應清楚提出這項要求，例如：「每輪保持一至兩句，並以第一身說話，猶如接待員在電話中交談。」

**S3. 為聆聽而寫。** 智能體說出的內容應避免使用 Markdown、符號及語音會讀得不自然的標記（斜線、& 符號、"@"、".com"、千位分隔符、未分隔電話號碼）。智能體傳送至工具的事實及數值，例如電郵地址或帳戶編號，應保持原有的準確書寫格式；如同時需要說出來，應在旁註明讀法，而非重寫內容。應拼寫說明不常見名稱或縮寫的讀法，並在保留新詞語前先聽取智能體讀出的效果。

**S4. 確認出錯成本高的資料。** 數字、電郵地址、地址及代碼應按來電者提供的形式覆述一次，並在來電者提供資料後、提出下一個問題前的回覆中進行；每次覆述只涵蓋一項資料。預設情況下，姓名會按來電者所說直接採用，無須覆述；只有在姓名罕見或不清晰時，智能體才要求拼寫，且只詢問一次。當業務需要姓名完全準確，例如用作比對記錄或以該姓名預約時，提示詞應說明此要求，智能體亦應把姓名的拼法讀回。覆述是讓來電者更正資料的機會，而非必經確認程序：若來電者以後續資料作答，或沒有更正便繼續交談，即表示已接受該資料，智能體不應再次詢問。業務將用作回電或傳送短訊的電話號碼是例外：覆述後應結束該輪並等待來電者回應。如提示詞要求逐位數字讀出，應只列明須以此方式讀出的資料（電話號碼、代碼）；門牌號碼、價格、時間或日期則按人們日常說法讀出。提示詞指定需確認哪些資料；平台負責控制覆述的節奏。

## 迭代

**I1. 保留修改前先測試。** 在已編輯的草稿上重播智能體的開發集，並與目前版本比較：某項修改修正了哪些示例，又破壞了哪些示例。以來電者實際聽到的方式閱讀回覆。任何來電者會察覺到的問題，都是問題，不是細節。

**I2. 保留集只檢查一次。** 只在開發集上調整。當修改準備就緒時才執行測試集，並如實報告結果。查看測試結果後作出的修改，需要使用新的測試示例。

**I3. 修補累積時進行重構。** 收集了許多小型修正的提示詞，會偏離 P1：規則重複、互相衝突，或與其規管的步驟相距太遠。此時應將其改寫為這種結構，同時保留它要求的每項行為。將每項行為列為保留、合併、改寫或刪除，並且不要在未說明的情況下刪除任何內容。重構前後均重播開發集；重構應只改變措辭，不應改變行為。

**I4. 先檢查設定，再檢查提示詞。** 部分失敗並非由提示詞造成：聽錯逐個拼讀的字母屬於聽辨限制（可嘗試 Plus 聽辨），回覆緩慢可能與智能或聽辨級別，或端點偵測設定有關。在重寫文字前，先排除設定問題。
