ThunderPhone v3 現已上線。自助開通,價格低至每分鐘 2¢。查看公告

Using the dashboard

內置工具

提示 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 以查看通話記錄。