> 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 - **通話キューイングと保留音声**：同時実行数の上限に達したエージェント向けに、[通話キューイング](/docs/ja/eleven-agents/guides/call-queueing)を追加しました。キューに入った発信者には保留音声が流れ、接続が許可されるかタイムアウトするまで`queue_status`イベントを受け取ります。新しいAPIメソッドでカスタム保留音声をアップロードまたは削除できます。 - **テストバージョンのメタデータ**：エージェントのテスト結果で、実行対象となったエージェントバージョンと、下書きの変更が含まれていたかどうかを確認できるようになりました。呼び出しサマリーでは、部分的な再送信が異なるバージョンに対して実行された場合も表示されます。 - **モデルとアカウントのメタデータ**：エージェントのLLM設定で`gemini-3.8-flash`を受け付けるようになりました。WhatsAppアカウントのレスポンスでは、アカウントがCloud APIを使用しているか、共存サインアップフローを使用しているかを確認できます。 ### 音楽 - **Music v2.5 APIのサポート**：音楽エンドポイントとSDKで`music_v2_5`を受け付けるようになりました。構成プラン生成チャンクでは最大6,132文字、1行200文字で最大30行までサポートします。 ### SDKリリース #### JavaScript SDK - [v2.68.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.68.0) - エージェントの保留音声をアップロードおよび削除するメソッドを追加しました。通話キューイング、プロシージャ参照、下書きブランチ作成、RAGクエリ制限、テストバージョンのメタデータ、`gemini-3.8-flash`、`music_v2_5`の型を再生成しました。 #### Python SDK - [v2.68.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.68.0) - エージェントの保留音声をアップロードおよび削除する同期・非同期メソッドを追加しました。通話キューイング、プロシージャ、下書きブランチ作成、RAGクエリ制限、テストバージョンのメタデータ、`gemini-3.8-flash`、`music_v2_5`のクライアントと型を再生成しました。`compose_detailed`ラッパーは、生成されたすべての音楽モデルIDと、プロンプトベースおよびチャンクベースの両方の構成プランを受け付けるようになりました。 #### iOS SDK - [v3.3.1](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.3.1) - エージェントメッセージを`event_id`ではなく`response_id`で照合するようになり、ツール呼び出し前後の複数レスポンスを保持し、ストリーミングされた部分や修正が誤ったメッセージに紐づくのを防ぎます。 #### ElevenLabs CLI - [v1.3.0](https://github.com/elevenlabs/cli/releases/tag/v1.3.0) - 生成されたAPIコマンドにオプションの`--intent`メタデータを追加しました。CLIがサポートしていないワークフローを報告するための`elevenlabs feedback missing-capability`を追加しました。 #### パッケージ - [@elevenlabs/convai-widget-core@0.18.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.2) と [@elevenlabs/convai-widget-embed@0.18.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.2) - ツールおよびプロシージャ呼び出し後にエージェントの返信が重複する問題を修正しました。ストリーミングされたテキスト返信でMarkdown形式が維持され、音声会話で未発話のストリーミングチャット部分が表示されなくなりました。embedパッケージでは、`user_activity`イベントを1秒に1回までに制限し、セッション終了時にその制限を解除します。 ### API ## 新しいエンドポイント ### ElevenAgents - [エージェント保留音声をアップロード](/docs/ja/api-reference/agents/hold-audio/create) - `POST /v1/convai/agents/{agent_id}/hold-audio` - 必須の`hold_audio_file`（バイナリ）をmultipartフォームデータとして受け付けます。ファイルはMP3またはWAV形式で、最大40MB、180秒までです。 - 必須の`agent_id`（文字列）と`hold_audio`（`AgentHoldAudioConfig`）を返します。保留音声オブジェクトには`audio_path`、`audio_url`、`original_filename`（文字列）、`duration_secs`（数値）、`size_bytes`（整数）が必須です。 - [エージェント保留音声を削除](/docs/ja/api-reference/agents/hold-audio/delete) - `DELETE /v1/convai/agents/{agent_id}/hold-audio` - カスタムクリップを削除し、キューに入った発信者にはデフォルトの保留音が流れるようにします。 - 必須の`agent_id`（文字列）を返します。 ## 更新されたエンドポイント ### ElevenAgents - [エージェントを作成](/docs/ja/api-reference/agents/create)、[エージェントを取得](/docs/ja/api-reference/agents/get)、[エージェントを更新](/docs/ja/api-reference/agents/update) - `enabled`（ブール値、デフォルト`false`）と`wait_timeout_seconds`（整数、1～1,800、デフォルト`180`）を持つ、オプションの`platform_settings.queueing_config`（`AgentQueueingConfig`）を追加しました。 - キュー設定のレスポンスには、読み取り専用でnull許容の`hold_audio`（`AgentHoldAudioConfig`）が含まれます。エージェントレスポンスにはオプションの`default_hold_audio_url`（文字列）も含まれます。 - [会話を取得](/docs/ja/api-reference/conversations/get) - `GET /v1/convai/conversations/{conversation_id}` - メタデータにオプションでnull許容の`queue_wait_secs`（数値）を追加しました。キュー時間は`call_duration_secs`および課金時間に含まれません。 - [エージェントブランチを作成](/docs/ja/api-reference/agents/branches/create) - `POST /v1/convai/agents/{agent_id}/branches` - オプションの`include_draft`（ブール値、デフォルト`false`）を追加しました。`true`の場合、ブランチ先端から作成されたブランチには、呼び出し元の下書きプロシージャセットが含まれます。 - [プロシージャを一覧表示](/docs/ja/api-reference/agents/procedures/list)と、プロシージャの作成、取得、下書きエンドポイント - 一覧項目にオプションの`referenced_tool_ids`、`referenced_kb_ids`、`referenced_procedure_ids`、`referenced_dynamic_variables`（文字列配列）を追加しました。 - エージェントおよびマージプレビューレスポンスに、プロシージャIDをキーとするマップであるオプションの`procedures`を追加しました。 - [テスト呼び出しを一覧表示](/docs/ja/api-reference/tests/test-invocations/list) - `GET /v1/convai/test-invocations` - テストとフォルダーを名前でフィルタリングするための、オプションでnull許容の`search`（文字列）を追加しました。 - [エージェントでテストを実行](/docs/ja/api-reference/tests/run-tests)と[テスト呼び出しを取得](/docs/ja/api-reference/tests/test-invocations/get) - テストスイート呼び出しと単体テスト実行のレスポンスに、オプションでnull許容の`version_id`（文字列）と、オプションの`ran_against_draft`（ブール値、デフォルト`false`）を追加しました。 - 呼び出しサマリーにも、オプションの`runs_diverged_from_version`（ブール値、デフォルト`false`）を追加しました。 - `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query` - リクエスト本文に、クエリ固有の上書き設定として、オプションでnull許容の`max_documents_length`（整数、1～50,000）および`max_retrieved_rag_chunks_count`（整数、1～20）を追加しました。 - [WhatsAppアカウントを取得](/docs/ja/api-reference/whats-app/accounts/get) - `GET /v1/convai/whatsapp-accounts/{phone_number_id}` - オプションの`account_type`（`WhatsAppAccountType`、デフォルト`cloud_api`）を追加しました。値は`cloud_api`と`coexistence`です。 - [想定LLM使用量を計算](/docs/ja/api-reference/agents/calculate) - `POST /v1/convai/agent/{agent_id}/llm-usage/calculate` - `LLMUsageCalculatorLLMResponseModel`に必須の`price_per_message`（数値）を追加しました。 ### 音楽 - `MusicModelID`に、`POST /v1/music/video-to-music`、`POST /v1/music/plan`、[音楽を作曲](/docs/ja/api-reference/music/compose)、`POST /v1/music/detailed`、`POST /v1/music/detailed/stream`、`POST /v1/music/stream`、`POST /v1/music/upload`、`POST /v1/music/finetunes`向けの`music_v2_5`を追加しました。 - `GenerationChunk.text`の`maxLength`を、`POST /v1/music/plan`、`POST /v1/music`、`POST /v1/music/detailed`、`POST /v1/music/detailed/stream`、`POST /v1/music/stream`、`POST /v1/music/upload`で6,000文字から6,132文字に増やしました。セクション名には1～100文字を使用でき、チャンクには1行200文字で最大30行を含められます。 ## スキーマの変更 ### ElevenAgents - リアルタイムサーバーイベントに`queue_status`を追加しました。必須の`queue_status_event.status`は`waiting`、`admitted`、`timed_out`を受け付けます。`timed_out`はWebSocketクローズコード`4300`に先行します。保留音声は引き続き通常の`audio`イベントとして届きます。 - `LLM`列挙型に、会話開始時のオーバーライドを含む`gemini-3.8-flash`を追加しました。 - 会話システムツール結果のユニオンに、`start_procedure_success`、`start_procedure_error`、`end_procedure_success`、`end_procedure_error`を追加しました。 - `FeaturesUsageCommonModel`に、オプションの`freeform_procedure`および`structured_procedure`機能ステータスを追加しました。