內置工具

提示 ThunderPhone 智能體結束通話、轉駁來電者、操作按鍵、等候保留、搜尋知識庫、播放聲音及傳送電郵。

內置工具讓智能體無需連接你自己的 API，即可執行常見通話操作。大部分工具會自動提供；電郵、音效及知識搜尋則只會在你設定相關選項或來源後出現。在提示詞中告訴智能體何時使用各項操作。

end_call#

當提示詞指示模型這樣做時，結束目前通話。此工具預設可用，無需任何智能體設定。

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

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

一般由模型結束的通話會有 end_reason: "ai_hangup"。因時長或餘額而中止的通話，則可能使用更具體的結束原因。

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#

在同一語音回合內任何發言後，播放智能體已設定的通知聲音。在控制台中，將進階 → 工具聲音設為 Chime、Ding 或 Beep，然後部署智能體。None 會移除此工具。

使用 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 個字元。缺少設定、內容無效、 每次通話的上限及傳送失敗均會傳回給智能體。 即使傳送失敗，仍會用掉三次嘗試中的一次。

大規模部署前，請先使用受控收件人測試。瀏覽器 Talk 及 模擬會傳送真實電郵；不設模擬執行模式。

相容性說明#

進階 → 不可中斷聲明設定及舊版 speak_uninterruptible_enabled 欄位會保留以維持相容性，但啟用後不會產生任何效果。請保持此設定關閉；任何提示均無法啟用此工具。

如需在通話開始時提供強制聲明，請使用同意公告。此公告會在一般對話開始前逐字播放，且無法被中斷。請參閱通話錄音同意法例。

測試及監察內置工具#

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

通話、定價及 Webhook#

內置操作不設每次使用工具費用。一般通話及服務供應商費用 仍然適用；請參閱定價。其通話及結果可顯示於 已完成的逐字稿中，但不會發出 telephony.tool 或 web.tool。 該等事件適用於使用者自訂函式。只有已完成的 掛線或轉駁會更改通話的 end_reason；其他失敗情況會回傳至智能體。請參閱完成 Webhook 以查看通話記錄。