- システムツールは、通話の終了など、エージェント上で直接設定する Cartesia 組み込みのアクションです。
- Webhook ツールは、お客様のサーバー上で公開する HTTPS エンドポイントを呼び出します。HTTP リクエストは Cartesia が送信します。
- クライアントツールは、WebSocket API 経由で Cartesia に接続されたブラウザ、モバイルアプリ、またはサーバー内の関数を実行します。
ツールをエージェントにアタッチする
Webhook ツールとクライアントツールは共有リソースです。POST /v1/agents/tools で作成し、その ID を config.tools に追加します。1 つのエージェントは最大 32 個のツールを参照できます。
config.tools への更新は、リスト全体を置き換えます。参照されているツールは、すべての現行エージェント設定から削除されるまで削除できません。
システムツールは、config.system_tools で別途設定します。
プレイグラウンドの Tools ページから Webhook ツールまたはクライアントツールを追加します。
ツールを説明する
LLM は、ツールのname と description を使って、いつ呼び出すかを判断します。ツールが何をするか、いつ使うべきかを記述してください。
実行設定
Webhook ツールとクライアントツールは、以下の設定を使用します：結果
システムツールは Cartesia が実行し、その結果を処理します。 Webhook ツールでは、テキスト形式のボディを持つ成功した HTTPS レスポンスの場合、そのボディが結果として LLM に渡されます。Cartesia はボディを 4096 バイトに制限し、それより長い場合は[cut off: the response was longer than this tool returns] を追加します。エンドポイントが 2xx 以外のステータスを返した場合、タイムアウトした場合、または到達できなかった場合、LLM はエラー結果を受け取り、会話は継続します。
結果を返す必要があるクライアントツールでは、接続されたブラウザ、モバイルアプリ、またはサーバーが WebSocket 接続経由で client_tool_result メッセージを送信します。response_timeout_secs までに結果が届かない場合、Cartesia は LLM に Tool call timed out を渡します。結果が 4096 バイトを超える場合、Cartesia はそれを error_type が result_too_large のエラー結果に置き換えます。
システムツール
エージェント上で直接設定する組み込みアクション。
Webhook ツール
Cartesia がお客様のサーバーに送信する HTTP リクエスト。
クライアントツール
WebSocket API 経由で、接続されたブラウザ、モバイルアプリ、またはサーバーが実行する関数。