Open in
提示詞風格指南
如何撰寫及編輯 ThunderPhone 語音智能體的提示詞:提示詞審核檢查所依據的指南,以及其結果引用的識別碼。
本指南適用於任何撰寫或編輯語音智能體提示詞的人:包括使用建立工具的人、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 聽辨),回覆緩慢可能與智能或聽辨級別,或端點偵測設定有關。在重寫文字前,先排除設定問題。