---
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)用來檢查提示詞的指南，
  其結果會引用下方的識別碼。連線至
  [MCP 伺服器](/zh-Hant/guides/thunderphone-mcp-server)的程式碼智慧體會將相同文字讀取為資源
  `thunderphone://guides/prompt-style`。如需範本和範例，請參閱
  [提示詞指南](/zh-Hant/guides/prompting)。
</Note>

本指南適用於所有撰寫或編輯語音智慧體提示詞的人：建置工具中的人員、Copilot，或透過 API 作業的程式碼
智慧體。提示詞審查工具會將此指南作為評估準則，並引用其指南識別碼（P1、W2 等）。

來電者只會以正常說話速度聽到智慧體一次，無法往回捲動。智慧體會在每個回合閱讀提示詞，並緊密遵循其中的措辭。這兩項事實決定了以下所有內容。

## 結構

**P1. 像向新接待人員說明那樣撰寫。** 開頭簡短說明智慧體是誰，以及它代表誰工作。接著依照通話實際發生的順序安排：如何開場、需要了解什麼、需要確認什麼，以及如何結束。每條規則都放在通話中適用的部分。讀者應能針對每一段問自己：「經營這家企業的人會這樣寫嗎？」需要了解的事項應涵蓋企業處理請求所需的資訊，而不只是致電者是誰及如何聯絡對方。

**P2. 使用簡潔標題，下方以散文說明。** 「你是誰」、「通話」、「事實」和「轉接」等標題很有幫助。機器式結構則沒有幫助：編號規則手冊、駝峰式或類似程式碼的標題、冗長的破折號規則清單、開頭就放工具參考資料，以及「請見下方第 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 聽辨），回覆緩慢可能與智慧或聽辨層級，或斷句設定有關。改寫文字前，先排除設定問題。
