> 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.

### ElevenAgents

- **WhatsAppのブランチと環境のオーバーライド**：[アウトバウンドWhatsAppメッセージ](/docs/ja/api-reference/whats-app/outbound-message)と[アウトバウンド通話](/docs/ja/api-reference/whats-app/outbound-call)で、`conversation_initiation_client_data`に渡された`branch_id`と`environment`が反映されるようになりました。オーバーライドは送信前に検証されます。不明なブランチまたは環境はエラーで拒否されます。また、会話中は設定が維持されるため、顧客からの返信は指定された[ブランチ](/docs/ja/eleven-agents/operate/versioning)と[環境](/docs/ja/eleven-agents/integrate/environment-variables)で再開されます。例については[WhatsAppガイド](/docs/ja/eleven-agents/whatsapp)をご覧ください。
- **プロシージャAPI**：[プロシージャ](/docs/ja/eleven-agents/customization/procedures)を管理するための、ブランチスコープの公開操作を8つ追加しました。プロシージャの作成、一覧表示、取得、削除、ドラフト変更の作成、取得、破棄、さらにプロシージャのドラフトをエージェントワークフローにコンパイルできます。プロシージャの作成では、`name`、`content`、`type`、`trigger`を指定できます。`trigger`を空にするとサブプロシージャが作成され、`trigger`を省略するか`null`にすると、プロシージャの内容から導出されます。
- **ナレッジベースのクロールジョブ**：クロールジョブを作成、一覧表示、確認、キャンセルするAPIを追加しました。作成リクエストには`url`（文字列）が必要で、クロール深度、ページ上限、URLパターン、サイトマップURL、フォルダー配置、自動同期、利用できないドキュメントの削除に対応しています。
- **ナレッジベースの一括管理**：1～20個の一意のドキュメントIDまたはフォルダーIDに対する[一括依存関係チェック](/docs/ja/api-reference/knowledge-base/dependent-agents-multiple)と[一括削除](/docs/ja/api-reference/knowledge-base/bulk-delete)を追加しました。依存関係チェックではページネーションと`dependent_type`に対応し、削除ではIDごとに個別の成功または失敗が返されます。`force: true`を設定すると、依存関係も削除され、空でないフォルダーも再帰的に削除されます。
- **バッチ通話結果のエクスポート**：[バッチ通話結果をエクスポート](/docs/ja/api-reference/batch-calling/export)を追加しました。終了済みバッチの受信者と会話結果をCSVでダウンロードできます。
- **会話フィルターと分析データ**：[会話を一覧表示](/docs/ja/api-reference/conversations/list)と[会話メッセージをテキスト検索](/docs/ja/api-reference/conversations/messages/text-search)に、任意の`visited_agent_ids`および`visited_agent_branch_ids`配列フィルターを追加しました。各フィルターは最大50件です。一覧リクエストでは`data_collection_ids`と`evaluation_criteria_ids`も受け付け、対応する結果を各会話の要約に含めることができます。要約には任意の`data_collection_results`、`evaluation_criteria_results`、`tag_ids`も追加されます。
- **参照による分析設定**：エージェントプラットフォーム設定に、評価およびデータ収集項目を参照で関連付ける、`AgentAnalysisItems`型の任意かつnull許容の`analysis_items`フィールドを追加しました。`null`はエージェントが引き続き従来のインラインフィールドを使用していることを示し、空の値は関連付けられた項目がない移行済みエージェントを示します。
- **プロシージャ依存関係メタデータ**：プロシージャ参照に`trigger`（文字列）と、`referenced_tool_ids`、`referenced_kb_ids`、`referenced_procedure_ids`、`referenced_dynamic_variables`の配列を追加しました。
- **WebRTCトークンレスポンス**：[WebRTCトークンを取得](/docs/ja/api-reference/conversations/get-webrtc-token)のレスポンスでは、`token`に加えて`conversation_id`（文字列）が必須になりました。これは、レスポンス形状を検証またはデシリアライズするクライアントにとって破壊的なスキーマ変更です。
- **ナレッジベースRAG結果**：`KnowledgeBaseRagToolResultModel`に、RAG-result-in-tool-resultモード用の`chunks`（`KnowledgeBaseRagChunkModel[]`）を追加しました。

### Studio

- **プロジェクトのドラフトステータス**：`ProjectCreationMetaResponseModel.status`に`draft`を追加しました。プロジェクト作成タイプでは、既存の値が同じ共有`ProjectCreationMetaType`列挙型を使用するようになりました。

### Voices

- **音声アクセント**：共有ボイスライブラリで利用可能なアクセントを一覧表示する`GET /v1/voices/accents`を追加しました。結果は`language`と`model_id`でフィルタリングでき、各アクセントでは`accent`、`language`、`code`、人間が読める`name`が返されます。`accent`値は、共有音声をフィルタリングするために[共有音声を取得](/docs/ja/api-reference/voices/voice-library/get-shared)の`accent`クエリパラメーターに渡せます。

### Workspaces

- **Webhook使用状況レポート**：`WebhookUsageType`に`Flows`を追加しました。

### SDKリリース

#### JavaScript SDK

- [v2.60.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.60.0) - 共有ボイスライブラリの音声アクセントを一覧表示する`voices.accents.get`に加え、最新スキーマのElevenAgentsプロシージャ、ナレッジベースのクロールジョブ、一括管理API、参照による分析設定を追加しました。

#### Python SDK

- [v2.60.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.60.0) - 最新スキーマの音声アクセント、ElevenAgentsプロシージャ、ナレッジベースのクロールジョブ、一括管理APIを追加しました。また、ブロックしないように`AsyncConversation`の起動を修正し、プリミティブ値のリストを含むmultipartフィールドが繰り返しフォームフィールドとして送信されるよう修正しました。

#### パッケージ

- [@elevenlabs/client@1.15.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.15.2) - WebRTCトランスポートの`onAudioAlignment`を修正しました。音声再生をLiveKitトラックで維持しつつ、音声メッセージからアラインメントメタデータを転送します。
- [@elevenlabs/react@1.10.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.10.2)、[@elevenlabs/react-native@1.2.16](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.16)、[@elevenlabs/convai-widget-core@0.14.12](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.12)、[@elevenlabs/convai-widget-embed@0.14.12](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.12) - `@elevenlabs/client@1.15.2`のWebRTCアラインメント修正を含むよう依存関係を更新しました。

### API

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

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

### ElevenAgents

- `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`
  - プロシージャを作成し、`procedure_id`（文字列）を返します
  - 任意の`name`（文字列、最大200文字）、`content`（文字列）、`type`（`ProcedureType`、デフォルトは`free_form`）、`trigger`（null許容文字列）を受け付けます
- `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`
  - `procedure_id`、`version_id`、`name`、`type`、`trigger`、`has_draft`を含むブランチのプロシージャを一覧表示します
  - プロシージャの内容は含まれません。内容を読むには個別のプロシージャを取得してください
- `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`
  - 任意の`version_id`（文字列）を受け付けます。指定しない場合はブランチ先頭のバージョンを返します
  - `name`、`content`、`type`、`trigger`を返します
- `DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`
  - ブランチのドラフト作業セットからプロシージャを削除します
- `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft`
  - 現在のプロシージャドラフトを返します
- `PATCH /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft`
  - ドラフトを作成または更新します
  - `name`（文字列、最大200文字）、`content`（文字列、最大50,000文字）、`type`（`ProcedureType`）が必要です。任意の`trigger`（null許容文字列）を受け付けます
- `DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft`
  - ドラフトの変更を破棄し、プロシージャをコミット済みバージョンにリセットします
- `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/compile`
  - プロシージャのドラフトを`AgentWorkflowResponseModel`にコンパイルします
- [クロールジョブを作成](/docs/ja/api-reference/knowledge-base/create-crawl-job) - `POST /v1/convai/knowledge-base/crawl`
  - `url`（文字列）が必要です
  - 任意の`max_depth`（整数、1～5、デフォルトは`3`）、`max_pages`（整数、1～10,000、デフォルトは`1000`）、`pattern`（文字列）、`sitemap_urls`（文字列配列）、`parent_folder_id`（文字列）、`enable_auto_sync`（ブール値、デフォルトは`false`）、`auto_remove`（ブール値、デフォルトは`false`）を受け付けます
- [クロールジョブを一覧表示](/docs/ja/api-reference/knowledge-base/list-crawl-jobs) - `GET /v1/convai/knowledge-base/crawl`
  - 任意の`include_job_ids`（文字列配列）、`page_size`（整数、1～100、デフォルトは`30`）、`cursor`（文字列）を受け付けます
- [クロールジョブを取得](/docs/ja/api-reference/knowledge-base/get-crawl-job) - `GET /v1/convai/knowledge-base/crawl/{crawl_job_id}`
- [クロールジョブをキャンセル](/docs/ja/api-reference/knowledge-base/cancel-crawl-job) - `POST /v1/convai/knowledge-base/crawl/{crawl_job_id}/cancel`
- [複数のドキュメントに依存するエージェントを取得](/docs/ja/api-reference/knowledge-base/dependent-agents-multiple) - `POST /v1/convai/knowledge-base/dependent-agents`
  - `document_ids`（1～20個の一意の文字列の配列）が必要です
  - 任意の`dependent_type`（`KnowledgeBaseDependentType`、デフォルトは`all`）、`page_size`（整数、1～100、デフォルトは`30`）、`cursor`（文字列）を受け付けます
- [ナレッジベースドキュメントを一括削除](/docs/ja/api-reference/knowledge-base/bulk-delete) - `POST /v1/convai/knowledge-base/bulk-delete`
  - `document_ids`（1～20個の一意の文字列の配列）が必要です
  - 任意の`force`（ブール値、デフォルトは`false`）を受け付けます
  - ドキュメントIDごとに成功または失敗の結果を返します
- [バッチ通話結果をエクスポート](/docs/ja/api-reference/batch-calling/export) - `GET /v1/convai/batch-calling/{batch_id}/export`
  - 終了済みバッチの受信者と会話結果をCSVで返します

### Voices

- `GET /v1/voices/accents`
  - 共有ボイスライブラリで利用可能なアクセントを一覧表示します
  - 任意の`language`（文字列）および`model_id`（文字列）クエリパラメーターを受け付けます
  - 各アクセントは`accent`、`language`、`code`、`name`を返します

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

### ElevenAgents

- [会話を一覧表示](/docs/ja/api-reference/conversations/list) - `GET /v1/convai/conversations`
  - 任意の`visited_agent_ids`および`visited_agent_branch_ids`文字列配列フィルターを追加しました。各フィルターは最大50件です
  - 各要約の分析結果を選択するため、任意の`data_collection_ids`および`evaluation_criteria_ids`文字列配列を追加しました
  - レスポンスの要約に、任意のオブジェクトフィールド`data_collection_results`と`evaluation_criteria_results`、および文字列配列`tag_ids`を追加しました
- [会話メッセージをテキスト検索](/docs/ja/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
  - 任意の`visited_agent_ids`および`visited_agent_branch_ids`文字列配列フィルターを追加しました。各フィルターは最大50件です
- [WebRTCトークンを取得](/docs/ja/api-reference/conversations/get-webrtc-token) - `GET /v1/convai/conversation/token`
  - レスポンスで`conversation_id`（文字列）が必須になりました
  - 破壊的変更：厳密なレスポンスバリデーターとデシリアライザーは、新しい必須フィールドを受け入れる必要があります

## スキーマの変更

### ElevenAgents

- エージェントプラットフォームのリクエストおよびレスポンス設定に、参照による評価およびデータ収集設定用の、`AgentAnalysisItems`型で任意かつnull許容の`analysis_items`フィールドを追加しました
- プロシージャ参照に`trigger`（文字列）、`referenced_tool_ids`（文字列配列）、`referenced_kb_ids`（文字列配列）、`referenced_procedure_ids`（文字列配列）、`referenced_dynamic_variables`（文字列配列）を追加しました
- `KnowledgeBaseRagToolResultModel`に`chunks`（`KnowledgeBaseRagChunkModel[]`）を追加しました

### Studio

- `ProjectCreationMetaResponseModel.status`に`draft`を追加しました
- `ProjectCreationMetaResponseModel.type`が共有`ProjectCreationMetaType`列挙型を参照するようになりました

### Workspaces

- `WebhookUsageType`に`Flows`を追加しました

</Accordion>