id フィールドにその ID（例：agent_Fo7pKNBUwLZxrTd6jvhpaE）が返されます。他のエンドポイントでは、この ID を agent_id と呼びます。エージェントを再作成するのではなく、新しい会話にはこの ID を再利用してください。ユーザーをエージェントに接続するブラウザ、モバイルアプリ、サーバーを再起動した後も、同じ ID を使い続けてください。
WebSocket での会話中は、接続されたブラウザ、モバイルアプリ、またはサーバーが、双方向のライブ接続を使って Cartesia と音声をストリーミングします。電話の場合は、代わりにテレフォニーがエージェントを電話網に接続します。
ボイスエージェントには 3 種類のツールを持たせることができます。詳細はツールを参照してください。システムツールは、通話の終了など、Cartesia が処理する組み込みアクションです。Webhook ツールは、Cartesia からお客様のサーバーへ Web 経由でリクエストを送信します。クライアントツールは、接続されたブラウザ、モバイルアプリ、またはサーバーが Cartesia の要求に応じて実行する関数です。
最初のエージェントを作成する
1
エージェントを作成する
プレイグラウンドで Create New をクリックし、Customer support などのテンプレートを選ぶか、Start from scratch を選択します。
2
指示を書く
System prompt と、エージェントが最初に話す内容である Introduction をそれぞれのフィールドに直接入力するか、Edit with AI をクリックして下書きの作成や修正を行います。
3
テストする
Preview をクリックすると、ブラウザでエージェントと会話し、公開前に変更内容をテストできます。
4
公開する
Publish をクリックし、一覧表示された変更点を確認します。電話通話と API セッションでは公開済みのバージョンが使用されます。
さらに詳しく
エージェント設定
指示、言語、音声、オーディオの挙動を設定します。
マネージド LLM
LLM と生成設定を選択します。
ツール
組み込みアクション、Webhook、クライアント関数を追加します。
バージョン
設定履歴を確認し、以前のバージョンを復元します。
オーディオ統合
アプリケーションから音声をストリーミングするか、電話番号を接続します。
評価
組み込みおよびカスタムのメトリクスで通話品質を測定します。