> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

import { YoutubeEmbed } from "../../../components/YoutubeEmbed";

### ElevenLabs CLI

[ElevenLabs CLI v1.0.0](https://github.com/elevenlabs/cli/releases/tag/v1.0.0)が利用可能になりました。すべてのElevenLabs API操作をサブコマンドとして実行でき、JSON、テーブル、YAML、CSVでの出力、自動ページネーション、シェル補完を利用できます。

CLIでは、ElevenAgents向けのローカル設定ワークフローも提供します。エージェント、ツール、テストの設定をファイルとして保存し、pushコマンドとpullコマンドで同期できます。ブランチの管理、テストの実行、ElevenLabs UIコンポーネントのインストール、データレジデンシーリージョンの選択も可能です。

<YoutubeEmbed id="MuORAEVtJIQ" />

<CardGroup cols={1}>
  <Card
    title="CLIドキュメント"
    icon="duotone book"
    href="/docs/ja/eleven-agents/operate/cli"
  >
    CLIをインストールし、認証して、エージェントをコードとして管理します。
  </Card>
</CardGroup>

### プロシージャ

プロシージャがElevenAgentsで正式リリースされました。プロシージャには、タスク固有の指示と、その指示を適用するタイミングを決めるトリガーが含まれます。会話中にエージェントは関連するプロシージャを読み込むため、すべての指示をシステムプロンプトに入れなくても、1つのエージェントで異なるタスクを処理できます。

エージェントが指示の表現や順序を会話に合わせて調整できる場合は、自由形式のプロシージャを使用します。手順を定義された順序で実行する必要がある場合は、構造化プロシージャを使用します。どちらのタイプも、同じエージェントでワークフローと併用できます。

<CardGroup cols={3}>
  <Card
    title="プロシージャの概要"
    icon="duotone book"
    href="/docs/ja/eleven-agents/customization/procedures"
  >
    プロシージャを使用する場面と、プロンプトやワークフローとの違いを確認します。
  </Card>
  <Card
    title="自由形式のプロシージャ"
    icon="duotone code"
    href="/docs/ja/eleven-agents/customization/procedures/free-form-procedures"
  >
    エージェントが会話に合わせて調整できる自然言語の指示を作成します。
  </Card>
  <Card
    title="構造化プロシージャ"
    icon="duotone list-check"
    href="/docs/ja/eleven-agents/customization/procedures/structured-procedures"
  >
    エージェントが一貫した順序で従う、型付きの手順を定義します。
  </Card>
</CardGroup>

### ElevenAgents

- **会話トリアージチケット**：エージェントのパフォーマンスに関するチケットの作成、手動フォローアップチケットの作成、チケットの一覧取得、ワークスペースメンバーの割り当て、ステータスと担当者の更新、チケットレベルまたはターンレベルのコメント追加を行うAPIを追加しました。
- **会話のオブザーバビリティ**：リアルタイムクライアントは、エージェントの各ターン完了後に`context_usage`イベントを受信できるようになりました。このイベントでは、モデル、プロンプトトークン数、モデルのコンテキスト上限を報告します。

### SDKリリース

#### JavaScript SDK

- [v2.65.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.65.0) - 会話トリアージチケットと軽量な会話要約のクライアントおよび型を追加しました。会話APIにプロシージャ、無効なツール呼び出し、ソートのフィルターを追加し、プロシージャAPIにエージェントバージョン選択を、トピックAPIに評価詳細の制御とフラストレーション順のソートを追加しました。また、ナレッジベースの更新頻度、テスト環境、アラートインテグレーションのフィールドと、リアルタイムの吹き替えメッセージ型も追加しました。

#### Python SDK

- [v2.65.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.65.0) - 会話トリアージチケットと軽量な会話要約のクライアントおよび型を追加しました。会話APIにプロシージャ、無効なツール呼び出し、ソートのフィルターを追加し、プロシージャAPIにエージェントバージョン選択を、トピックAPIに評価詳細の制御とフラストレーション順のソートを追加しました。また、ナレッジベースの更新頻度、テスト環境、アラートインテグレーションのフィールドを追加し、スピーチtoテキストの`keyterms`および吹き替えの`webhook_ids`で繰り返されるmultipartフィールドを保持します。

#### Swift SDK

- [v3.3.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.3.0) - 型付きクライアントエラー解析、`expects_response`処理、型安全なツール結果を追加しました。WebRTCの起動は、オーディオトラックのサブスクリプションを待つ代わりに、エージェントが参加した時点で準備完了となります。また、URL処理を強化し、未知イベントのノイズを抑制し、ソフトウェアミュート処理からリアルタイムスレッドの割り当てを削除しました。

#### パッケージ

- [@elevenlabs/client@1.19.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.19.1), [@elevenlabs/react@1.12.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.3), [@elevenlabs/react-native@1.2.21](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.21), [@elevenlabs/convai-widget-core@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.2)および[@elevenlabs/convai-widget-embed@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.2) - 厳格なコンテンツセキュリティポリシー下で、WebRTC出力キャプチャがセルフホストのAudioWorkletパスを使用するようになりました。Workletのキャッシュにはリクエストされたソースが含まれるため、以前のインラインURLがセルフホストのパスを置き換えることはありません。React Nativeのセットアップエラーは`@elevenlabs/react-native`を案内するようになりました。
- [@elevenlabs/client@1.20.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.20.0), [@elevenlabs/react@1.12.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.4), [@elevenlabs/react-native@1.2.22](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.22), [@elevenlabs/convai-widget-core@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.3)および[@elevenlabs/convai-widget-embed@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.3) - オプションの`webRtc.iceTransportPolicy`を追加しました。直接のUDPトラフィックをブロックするネットワークでWebRTC ICE候補をTURNリレーに制限するには、`relay`に設定します。
- [@elevenlabs/client@1.21.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.21.0), [@elevenlabs/react@1.13.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.13.0), [@elevenlabs/types@0.21.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.21.1), [@elevenlabs/react-native@1.2.23](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.23), [@elevenlabs/convai-widget-core@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.4)および[@elevenlabs/convai-widget-embed@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.4) - `onContextUsage`コールバックと`ContextUsageEvent`型を追加しました。Reactでは`useConversation`を通じてコールバックを公開します。React Nativeは、ブラウザーグローバルの検出ではなく、パッケージのexport条件を通じて解決されるようになりました。
- [@elevenlabs/client@1.22.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.22.0), [@elevenlabs/react@1.14.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.14.0), [@elevenlabs/types@0.22.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.22.0), [@elevenlabs/react-native@1.2.24](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.24), [@elevenlabs/convai-widget-core@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.17.0)および[@elevenlabs/convai-widget-embed@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.17.0) - 属性付きボタン応答を備えた最初のメッセージのリッチコンテンツ、`onExternalAgentDisconnected`、`onMCPToolApprovalRequest`を追加しました。WebRTCは選択した入力デバイスを使用し、マイク切り替え時にもミュート状態を保持し、開始データを送信できない場合はセットアップに失敗します。ウィジェットには、同時実行キューのステータス、折りたたまれたトリガーでの任意の言語選択、テキストと音声の両方をサポートするエージェント向けの最初のメッセージレンダリングを追加しました。

### API

<Accordion title="APIの変更を表示">

## 新しいエンドポイント

### ElevenAgents

- 会話トリアージチケット用の9つのエンドポイントを追加しました：
  - [会話チケットを作成](/docs/ja/api-reference/triage-tickets/create-agent-conversation-ticket-route) - `POST /v1/convai/triage-tickets`。リクエストには`conversation_id`（文字列）が必要で、`qa_comment`（null許容の文字列、1～10,000文字）と最大200件のターンコメントを受け付けます。
  - [チケットを一覧表示](/docs/ja/api-reference/triage-tickets/list-agent-conversation-tickets-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets`。カーソルページネーションに対応しています。
  - [手動チケットを作成](/docs/ja/api-reference/triage-tickets/create-manual-agent-ticket-route) - `POST /v1/convai/agents/{agent_id}/triage-tickets`。リクエストには`qa_comment`（文字列、1～10,000文字）が必要です。
  - [割り当て可能なユーザーを一覧表示](/docs/ja/api-reference/triage-tickets/get-assignable-users-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users`。レスポンスには、サービスアカウント以外のワークスペースメンバーと、各メンバーがエージェントにアクセスできるかどうかが含まれます。
  - [チケットを取得](/docs/ja/api-reference/triage-tickets/get-agent-conversation-ticket-route) - `GET /v1/convai/triage-tickets/{agentqa_ticket_id}`。
  - [チケットを更新](/docs/ja/api-reference/triage-tickets/update-agent-conversation-ticket-route) - `PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}`。リクエストでは、任意の`status`とnull許容の`assignee_user_id`を受け付けます。
  - [チケットを削除](/docs/ja/api-reference/triage-tickets/delete-agent-conversation-ticket-route) - `DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}`。
  - [コメントを追加](/docs/ja/api-reference/triage-tickets/add-ticket-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments`。リクエストには`comment`（文字列、1～10,000文字）が必要です。
  - [ターンコメントを追加](/docs/ja/api-reference/triage-tickets/add-turn-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments`。リクエストには、0始まりの`turn_index`（整数）と`comment`（文字列、1～10,000文字）が必要です。

## 更新されたエンドポイント

### ElevenAgents

- [署名付きURLを取得](/docs/ja/api-reference/conversations/get-signed-url) - `GET /v1/convai/conversation/get-signed-url`
  - 任意の`debug_events_request`（ブール値、デフォルトは`false`）を追加しました。デバッグイベントには、エージェントへの編集者アクセスが必要です。
- [WebRTCトークンを取得](/docs/ja/api-reference/conversations/get-webrtc-token) - `GET /v1/convai/conversation/token`
  - 任意の`debug_events_request`（ブール値、デフォルトは`false`）を追加しました。従来の`GET /v1/convai/conversation/get_signed_url`ルートも同じパラメーターを受け付けます。
- [会話を一覧表示](/docs/ja/api-reference/conversations/list) - `GET /v1/convai/conversations`
  - 指定したプロシージャのいずれかが実行された会話に一致させる、任意の`triggered_procedure_ids`（null許容の文字列配列、最大50件）を追加しました。
  - 実行されなかったツール呼び出しを含めるための、任意の`include_invalid_tool_calls`（ブール値、デフォルトは`false`）を追加しました。
  - 通話開始時刻用の、任意の`sort_direction`（`asc`または`desc`、デフォルトは`desc`）を追加しました。
- [会話メッセージをテキスト検索](/docs/ja/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
  - 任意の`triggered_procedure_ids`（null許容の文字列配列、最大50件）を追加しました。
  - 任意の`include_invalid_tool_calls`（ブール値、デフォルトは`false`）を追加しました。
- [エージェント会話トピックを取得](/docs/ja/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics`
  - 任意の`include_evaluation_criteria`（ブール値、デフォルトは`true`）を追加しました。
  - `sort_by`に`frustration`を追加しました。
  - トピックレスポンスにnull許容の`success_rate`（数値）を追加し、全体レスポンスに`aggregated_run_count`（整数、デフォルトは`0`）を追加しました。
  - `from_unix_secs`はUTC日の開始時刻に切り捨てられます。範囲を指定すると、完了した日次ディスカバリー実行を集計します。両方の境界を省略した場合は、最新の実行を返します。
- [プロシージャを一覧表示](/docs/ja/api-reference/agents/procedures/list)（`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`）および[プロシージャを取得](/docs/ja/api-reference/agents/procedures/get)（`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`）
  - 特定のエージェントバージョンからプロシージャを取得するための、任意のnull許容`agent_version_id`（文字列）を追加しました。
- [テストを作成](/docs/ja/api-reference/tests/create)および[テストを更新](/docs/ja/api-reference/tests/update)
  - レスポンス、シミュレーション、ツール呼び出しのユニットテストスキーマに、任意のnull許容`environment`（文字列）を追加しました。この値は環境固有のURL、ヘッダー、認証接続を選択し、デフォルトは`production`です。
- [URLドキュメントを作成](/docs/ja/api-reference/knowledge-base/create-from-url)、[クロールジョブを作成](/docs/ja/api-reference/knowledge-base/create-crawl-job)、[フォルダーを作成](/docs/ja/api-reference/knowledge-base/create-folder)
  - 自動同期用に、任意のnull許容`minimum_frequency_days`（整数、1～180）を追加しました。デフォルトは`7`で、より厳しい親フォルダーの頻度が優先されます。

### 音楽

- [音楽Finetuneを一覧表示](/docs/ja/api-reference/music/finetunes/list) - `GET /v1/music/finetunes`
  - 最大`page_size`を100から150に増やしました。デフォルトは50のままです。

## スキーマの変更

### ElevenAgents

- エージェント更新リクエストに、任意のnull許容`procedures`（`object<string, ProcedureVersionRef>`）を追加しました。各値には`procedure_id`と`version_id`（文字列）が必要です。空のオブジェクトを指定すると、すべてのプロシージャを削除します。
- 会話開始設定に`enable_procedure_ids_from_client`（ブール値、デフォルトは`false`）を追加しました。開始データには任意のnull許容`procedure_ids`（文字列配列）を追加しました。空の配列を指定すると、開始エージェントのすべてのプロシージャを無効にします。
- `ClientEvent`に`context_usage`を追加しました。
- ソフトタイムアウトのオーバーライドに、任意のnull許容`additional_soft_timeout_messages`（文字列配列）を追加しました。
- 分析およびスキーマオーバーライドモデルの定数値が`null`を受け付けるようになりました。
- ウィジェット設定の`mic_muting_enabled`と`transcript_enabled`のデフォルトを`false`から`true`に変更しました。以前の動作を維持するには、明示的に`false`に設定してください。

### ワークスペース

- [ユーザーを取得](/docs/ja/api-reference/user/get)のレスポンスから、`UserResponseModel`の`xi_api_key`を削除しました。
- `ResourceMetadataResponseModel.role_to_group_ids`では、キーを`admin`、`editor`、`commenter`、`viewer`に限定せず、カスタムロールIDをキーとして受け付けるようになりました。
- ダイレクトパブリッシングのレスポンスに、任意のnull許容`restricted_to_user_email_domains`（文字列配列）を追加しました。
- 保留中のサブスクリプション切り替えレスポンスの`next_tier`に`go`を追加しました。

</Accordion>