config.system_tools は、end_call、send_dtmf、transfer_to_number、skip_turn、voicemail_detection をサポートしています。
プレイグラウンドの Tools ページからシステムツールを追加します。
null になります。PATCH リクエストの config.system_tools では：
- ツールを省略すると、現在の設定が変更されません。
nullを送信すると、ツールが無効になります。- 設定オブジェクトを送信すると、ツールの設定を有効化または更新できます。
end_call、send_dtmf、skip_turn、voicemail_detection では、{} を送ると、無効なツールはデフォルト設定で有効になり、有効なツールは現在の設定が維持されます。transfer_to_number を有効にするには、転送先のリスト（transfers）を指定します。
すべてのシステムツールについて、当社のシステムに最適化されたデフォルトの説明をそのまま使うことを推奨します。ただし、より細かく制御したい場合は、description を設定して、エージェントがどのように・いつツールを呼び出すかを指示できます。null に設定すると、組み込みの説明が使用されます。
pre_tool_speech は、行動する前にエージェントが話すかどうかを制御します。auto はエージェントに任せ、force は先に話すよう求め、off は求めません。
End call
会話が完了したとき、または発信者が電話を切るよう求めたときに、エージェントが通話を終了できるようにします。Skip turn
発信者が少し待ってほしいと求めたときに、エージェントの応答をスキップします。wait_timeout_secs を設定すると、声かけのタイムアウトを一時的に延長できます。ユーザーの発話または DTMF によって元のタイミングに戻ります。
Voicemail detection
エージェントが留守番電話を検出して通話を終了できるようにします。message を設定すると、電話を切る前に音声メッセージを残します。このメッセージは、pre_tool_speech が off の場合でも中断されずに再生されます。通話の end_reason は voicemail_detected になります。
Send DTMF
電話メニューの操作中に、エージェントが12# のような 1 つ以上のキーパッドトーンを送信できるようにします。サポートされるトーンは 0 から 9、*、# です。
Transfer to number
電話を設定済みの宛先に転送します。各宛先には、+14155550123 のような E.164 形式の電話番号、sip:user@host のような SIP URI、または {{transfer_number}} のような動的変数を指定します。モデルがいつその宛先を使うべきかを示す条件を追加します。
宛先は、エージェント ID を使って Update agent で設定します：
transfer_number のような動的変数は、アウトバウンド通話リクエストまたは Webhook の代入（assignment）で供給します。電話の宛先として使用する変数には、転送の実行時に有効な E.164 番号が含まれている必要があります。条件とツールの説明も動的変数をサポートします。
プレイグラウンドでは、Tools を開いて Transfer call の横にある Add をクリックし、各ルールの Destination で Phone number、SIP URI、または Dynamic variable を選択します。
type を "sip_uri" に設定し、sip:user@host または sips:user@host の形式で sip_uri を指定します。スキームは小文字にし、user と host の両方を含めてください。
sip_uri には、{{sip_uri}} のような単一の動的変数を指定することもできます。この場合、転送の実行時に変数の値が完全な SIP URI になっている必要があります。sip:{{user}}@host のように URI の内部で変数を使うことはサポートされていません。プレイグラウンドでは、ルールの Destination で Dynamic variable を選択し、Destination type を SIP URI に設定します。
プレイグラウンドの転送ルール。
転送は、Cartesia の番号、Twilio からインポートした番号、SIP トランク経由の番号を含む電話通話で機能します。SIP URI の宛先には SIP トランキングが必要です。
プレイグラウンドのプレビューおよび WebSocket セッションでは、ツールは通話を転送する代わりにエラーを返します。