內建工具

提示 ThunderPhone 智慧體結束通話、轉接來電者、操作按鍵、等待保留、搜尋知識、播放音效、傳送電子郵件及計算總額。

內建工具可讓智慧體執行常見的通話動作，無須連接你自己的 API。大多數工具會自動提供；電子郵件、音效、計算機和知識搜尋則只會在你設定相關選項或來源後顯示。在提示詞中告訴智慧體何時使用各項動作。

end_call#

當提示詞指示模型執行此操作時，結束目前通話。此工具預設可用，且沒有智慧體設定。

在提示詞中寫明條件，以及任何必要的道別語：

When the caller confirms they need nothing else, say goodbye and end the call.

由模型結束的通話會有 end_reason: "ai_hangup"，也包括在通話時間限制警告後結束的通話。只有在先達到時間限制時，通話才會以 max_duration 結束；預付餘額用盡時，則會以 balance_exhausted 結束。

transfer_call#

將電話來電者轉接至模型提供的固定號碼。冷轉接會立即進行。經篩選的暖轉接會在連接雙方前，先私下致電目的地。暖轉接需要已驗證且可撥出電話的匯入 VoIP 號碼。

在提示詞中填入目的地號碼和精確的路由條件：

If the caller asks for billing, transfer them to +15551234567.

成功的冷轉接會有 end_reason: "ai_transfer"；完成的暖轉接交接會有 end_reason: "ai_warm_transfer"。暖轉接嘗試失敗時，控制權會交回智慧體，因此通話後續的結束方式會決定其結束原因。在非電話工作階段中，轉接要求會改為結束工作階段。

請參閱轉接通話，了解控制台和 API 設定、路由、篩選、失敗處理、限制及測試。

send_keypad_input#

將 DTMF（電話鍵盤）數字 0–9、* 和 # 傳送至電話線路。模型會使用此工具操作 IVR，也就是要求來電者按鍵的自動語音選單。此工具預設可用，且沒有智慧體設定。

請告知模型可操作哪些選單，以及所需值的來源。不要要求它猜測選單選項：

Follow the phone menu for account status. Press a key only after the menu
states what that key does. Enter the account number supplied by the caller.

平台會移除不支援的字元，並依序傳送有效數字。若沒有任何有效數字可傳送，或通話無法傳送鍵盤輸入，失敗資訊會回傳給智慧體，以便它復原處理。

no_response#

在自動系統仍在說話或要求它繼續聆聽時，以及來電者自言自語（「嗯，讓我看看」）或轉向與他人交談時，讓智慧體保持安靜。當來電者要求智慧體在他們處理事情時等待（「等一下」、「讓我確認一下」、「可以稍等我一下嗎？」），且沒有提供其他需要回覆的內容時，智慧體只會說「當然。」（而不是「慢慢來」），然後等待來電者再次說話。如果線路持續安靜，智慧體的靜默確認提示仍會執行，且一律會說出口。這不適用於真人的問候、問題或真正的保留等待佇列。此功能預設可用，且沒有智慧體設定。

如果你的提示詞告訴智慧體當來電者要求稍候時該說什麼，則以提示詞為準。

通常內建說明已足夠。對於大量使用 IVR 的通話，請在提示詞中強化此界線：

Stay silent while a phone menu is still speaking. Answer a live person as soon
as they address you.

此操作不會結束通話。

wait_on_hold#

讓撥出智慧體進入靜默保留狀態，直到真人返回。 模型只會在對方明確表示要將智慧體置於保留狀態後使用此工具。此工具會自動於撥出通話中提供，且沒有 控制台設定。

If a person explicitly puts you on hold, wait silently. When they return,
continue from the question you were discussing.

請勿提示智慧體針對 IVR 的「請稍候」訊息使用此工具。保留狀態預設最長可持續 15 分鐘。對於一般撥出通話，POST /v1/call 接受正整數 max_hold_seconds；內嵌 Realtime 將 max_hold_seconds 限制為 10–900 秒。如果對方 返回，智慧體會繼續通話，且不會變更通話的結束原因。如果超過限制， 平台會以 end_reason: "ai_hangup" 結束通話。

search_knowledge_base#

搜尋附加至智慧體的文件並傳回相關段落。附加知識庫或個別知識文件以啟用此工具， 然後告訴模型哪些回答必須來自這些來源：

Search the knowledge base before answering policy questions. If the first
search is inconclusive, try once more with different key terms.

如果搜尋失敗，結果會傳回給智慧體。請參閱知識 庫了解控制台與 API 設定。

play_sound#

在同一回合的任何語音之後，播放智慧體設定的通知音效。在控制台中，將 進階 → 工具音效 設為 提示音、叮聲、 或 嗶聲，然後部署智慧體。無 會移除此工具。

使用 Agents API 時，將 play_sound_asset 設為 "chime"、"ding" 或 "beep"，然後部署。設為 "" 可停用 此工具。

After confirming that an appointment was saved, say "You're all set" and play
the notification sound.

播放失敗會傳回給智慧體，但不會結束通話。

send_email#

將純文字電子郵件寄給智慧體擁有者設定的唯一收件者。 模型會提供主旨與內文。它永遠不會看到收件者參數，也無法選擇或變更地址。

在控制台中，啟用 進階 → 寄送電子郵件，儲存收件者地址， 然後部署智慧體。使用 Agents API 時，設定 send_email_enabled: true 與非空白的 send_email_recipient，然後部署。 在提示中定義觸發條件與必要內容：

When the caller asks to leave a message, collect their name, callback number,
and message. Read the details back for confirmation, then email them.

每通通話最多可嘗試寄送三封電子郵件。每個主旨最多 300 個字元，每封內文最多 20,000 個字元。缺少設定、內容無效、每通通話限制與寄送失敗， 都會傳回給智慧體。 即使寄送失敗，仍會消耗三次嘗試中的一次。

在廣泛部署前，先使用由你掌控的收件者地址進行測試。Browser Talk 與 模擬會寄送真實電子郵件；沒有試跑模式。

calculate#

精確計算算術運算式並傳回結果，讓智慧體不必在腦中加總價格。此功能預設為關閉。在控制台中，啟用 進階 → 計算機，然後部署智慧體。使用 Agents API 時，先暫存 calculator_enabled: true，然後部署。

模型會寫出運算式，例如 2*23.5 + 16.5 + 4，並將結果讀給來電者。運算式可使用數字、+、-、*、/ 和括號。單次呼叫最多可包含 10 個以 ; 分隔的運算式，例如小計與加上運費的總計，全部合計最多 500 個字元。結果會四捨五入至小數點後 10 位。此數學運算採用精確十進位算術，因此 0.1 + 0.2 會傳回 0.3。除以零及運算式中的其他任何問題，都會以錯誤形式傳回給智慧體，以便修正。它在 ThunderPhone 上執行並立即回應，不會有填充語句或打字聲。

適用於報價訂單總額、費用或找零的智慧體。無需修改提示詞。

相容性說明#

進階 → 不可中斷揭露事項 設定與舊版 speak_uninterruptible_enabled 欄位會保留以維持相容性，但啟用它們不會產生任何效果。 請保持此設定為關閉；任何提示都無法啟用此工具。

如需在通話開場時進行必要告知，請使用 同意公告。它會在一般對話開始前逐字播放， 且無法被中斷。請參閱通話錄音同意法規。

測試及監控內建工具#

使用瀏覽器 Talk 或模擬來檢查提示、知識搜尋、音效與電子郵件。這些環境無法重現電話 網路行為。請在撥出電話中測試按鍵導覽與保留功能，並使用符合資格的已匯入 VoIP 號碼， 在真實通話中測試完整的暖轉接。Realtime 支援範圍有限，如上表所示。

通話、定價與 Webhook#

內建動作不收取每次使用的工具費用。一般通話與供應商費用 仍然適用；請參閱定價。其通話與結果可能會顯示 在已完成的逐字稿中，但不會產生 telephony.tool 或 web.tool。 這些事件專供使用者定義函式使用。只有成功完成的 掛斷或轉接會變更通話的 end_reason；其他失敗會回傳給智慧體。通話 紀錄請參閱完成 Webhook。