Open in
內置工具
提示 ThunderPhone 智能體結束通話、轉駁來電者、操作按鍵、等候接聽、搜尋知識、播放聲音、發送電郵及計算總額。
內置工具讓智能體無需連接你自己的 API,即可執行常見的通話操作。大部分工具會自動提供;電郵、音效、計算機及知識庫搜尋只會在你設定相關選項或來源後出現。請在提示詞中告訴智能體何時使用各項操作。
| 工具 | 用途 | 啟用方式 | 支援的通話 |
|---|---|---|---|
end_call | 結束已完成的對話 | 預設啟用;system_tool_settings 可將其停用 | 電話、瀏覽器 Talk、Widget、模擬及 Realtime |
transfer_call | 轉駁電話來電者 | 在提示詞中設定轉駁 | 一般電話通話;具備 call_events 的內嵌 Realtime 可使用盲轉。已儲存智能體的 Realtime 不包括此功能。 |
send_keypad_input | 在電話選單中按鍵 | 外撥通話預設啟用;system_tool_settings 可啟用或停用 | 電話通話;具備 call_events 的內嵌外撥 Realtime。已儲存智能體的 Realtime 不包括此功能。 |
no_response | 在自動選單播放或來電者自行思考時持續聆聽;要求智能體等候的來電者只會聽到「當然可以。」 | 隨時可用 | 所有通話類型 |
wait_on_hold | 靜默等候對方返回 | 外撥通話預設啟用;system_tool_settings 可啟用或停用 | 電話通話及外撥內嵌 Realtime 工作階段 |
search_knowledge_base | 根據已附加的資料來源回答 | 將知識附加至智能體 | 已附加知識的已儲存智能體通話 |
play_sound | 播放已設定的通知音效 | 進階 → 工具音效 | 已儲存智能體通話 |
send_email | 向一名固定收件人傳送電郵 | 進階 → 傳送電郵 | 已儲存智能體通話 |
calculate | 精確計算總額、費用及找續 | 進階 → 計算機 | 已儲存智能體通話 |
end_call
當提示指示模型這樣做時,結束目前通話。此功能預設啟用。對於不應自行掛線的智能體,例如在兩位自行結束通話的人士之間傳譯的傳譯員,可透過智能體的 system_tool_settings 欄位({"end_call": false})將其關閉。通話其後會在其中一方掛線時,或因靜音及時間限制而結束。
在提示詞中寫明條件及任何必要的告別語:
When the caller confirms they need nothing else, say goodbye and end the call.由模型結束的通話會顯示 end_reason: "ai_hangup",包括在通話時限警告後結束的通話。只有在先達到時限時,通話才會以 max_duration 結束;預付餘額用盡時會以 balance_exhausted 結束;通話達到智能體的硬性價格上限時則會以 price_cap_reached 結束(智能體會先作簡短道別)。
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,即要求來電者按鍵的自動選單。外撥通話預設啟用,來電通話預設停用;在智能體的 system_tool_settings
中設定 "send_keypad_input": true 或 false,即可變更所有通話的設定。
告訴模型可操作哪些選單,以及所需數值的來源。不要要求它猜測選單選項:
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
讓外撥智能體進入靜默保留狀態,直至真人返回為止。模型只會在對方明確表示正將智能體設為保留後才會使用此工具。此功能預設於外撥通話啟用;在智能體的 system_tool_settings 中設定 "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 及 模擬會傳送真實電郵;不設模擬執行模式。
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 以查看通話記錄。