config.system_tools は現在、end_call、send_dtmf、transfer_to_number の 3 つのツールをサポートしています。
プレイグラウンドの Tools ページからシステムツールを有効にします。
null になります。PATCH リクエストの config.system_tools では：
- ツールを省略すると、現在の設定が変更されません。
nullを送信すると、ツールが無効になります。- 設定オブジェクトを送信すると、ツールの設定を有効化または更新できます。
end_call と send_dtmf では、{} を送るとツールがデフォルト設定で有効になります。現在の設定を変更せずに残すという意味にはなりません。ツールの説明は当社のシステムに最適化されたデフォルトのままにすることを一般的に推奨しますが、より細かく制御したい場合は、description を設定して、モデルがどのように・いつツールを呼び出すべきかを指示できます。たとえば、通話を終了する前に明示的な別れのあいさつを必須にしたり、留守番電話につながったときにエージェントが電話を切らないようにしたりできます。null に設定すると、組み込みの説明が使用されます。
pre_tool_speech は、行動する前にエージェントが話すかどうかを制御します。auto はエージェントに任せ、force は先に話すよう求めます。
End call
会話が完了したとき、または発信者が電話を切るよう求めたときに、エージェントが通話を終了できるようにします。Send DTMF
電話メニューの操作中に、エージェントが12# のような 1 つ以上のキーパッドトーンを送信できるようにします。サポートされるトーンは 0 から 9、*、# です。
Transfer to number
電話を設定済みの宛先に転送します。各宛先には、+14155550123 のような E.164 形式の電話番号、sip:user@host のような SIP URI、または {{transfer_number}} のような動的変数を指定します。モデルがいつその宛先を使うべきかを示す条件を追加します。
宛先は、エージェント ID を使って Update agent で設定します：
PATCH /v1/agents/{agent_id}
transfer_number のような動的変数は、アウトバウンド通話リクエストまたは Webhook の代入（assignment）で供給します。電話の宛先として使用する変数には、転送の実行時に有効な E.164 番号が含まれている必要があります。条件とツールの説明も動的変数をサポートします。
プレイグラウンドでは、Tools を開いて Transfer call を有効にし、各ルールの 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 に設定します。
転送には、Twilio または SIP トランク経由の電話通話が必要です。SIP URI の宛先には SIP トランキングが必要です。
プレイグラウンドおよび v1 WebSocket の通話では、ツールは通話を転送する代わりにエラーを返します。