Changelog

September 14, 2026

ElevenAgents

  • 通話キューイングと保留音声：同時実行数の上限に達したエージェント向けに、通話キューイングを追加しました。キューに入った発信者には保留音声が流れ、接続が許可されるかタイムアウトするまで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 - エージェントの保留音声をアップロードおよび削除するメソッドを追加しました。通話キューイング、プロシージャ参照、下書きブランチ作成、RAGクエリ制限、テストバージョンのメタデータ、gemini-3.8-flash、music_v2_5の型を再生成しました。

Python SDK

  • v2.68.0 - エージェントの保留音声をアップロードおよび削除する同期・非同期メソッドを追加しました。通話キューイング、プロシージャ、下書きブランチ作成、RAGクエリ制限、テストバージョンのメタデータ、gemini-3.8-flash、music_v2_5のクライアントと型を再生成しました。compose_detailedラッパーは、生成されたすべての音楽モデルIDと、プロンプトベースおよびチャンクベースの両方の構成プランを受け付けるようになりました。

iOS SDK

  • v3.3.1 - エージェントメッセージをevent_idではなくresponse_idで照合するようになり、ツール呼び出し前後の複数レスポンスを保持し、ストリーミングされた部分や修正が誤ったメッセージに紐づくのを防ぎます。

ElevenLabs CLI

  • v1.3.0 - 生成されたAPIコマンドにオプションの--intentメタデータを追加しました。CLIがサポートしていないワークフローを報告するためのelevenlabs feedback missing-capabilityを追加しました。

パッケージ

  • @elevenlabs/convai-widget-core@0.18.2 と @elevenlabs/convai-widget-embed@0.18.2 - ツールおよびプロシージャ呼び出し後にエージェントの返信が重複する問題を修正しました。ストリーミングされたテキスト返信でMarkdown形式が維持され、音声会話で未発話のストリーミングチャット部分が表示されなくなりました。embedパッケージでは、user_activityイベントを1秒に1回までに制限し、セッション終了時にその制限を解除します。

API

新しいエンドポイント

ElevenAgents

  • エージェント保留音声をアップロード - 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（整数）が必須です。
  • エージェント保留音声を削除 - DELETE /v1/convai/agents/{agent_id}/hold-audio
    • カスタムクリップを削除し、キューに入った発信者にはデフォルトの保留音が流れるようにします。
    • 必須のagent_id（文字列）を返します。

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

ElevenAgents

  • エージェントを作成、エージェントを取得、エージェントを更新
    • enabled（ブール値、デフォルトfalse）とwait_timeout_seconds（整数、1～1,800、デフォルト180）を持つ、オプションのplatform_settings.queueing_config（AgentQueueingConfig）を追加しました。
    • キュー設定のレスポンスには、読み取り専用でnull許容のhold_audio（AgentHoldAudioConfig）が含まれます。エージェントレスポンスにはオプションのdefault_hold_audio_url（文字列）も含まれます。
  • 会話を取得 - GET /v1/convai/conversations/{conversation_id}
    • メタデータにオプションでnull許容のqueue_wait_secs（数値）を追加しました。キュー時間はcall_duration_secsおよび課金時間に含まれません。
  • エージェントブランチを作成 - POST /v1/convai/agents/{agent_id}/branches
    • オプションのinclude_draft（ブール値、デフォルトfalse）を追加しました。trueの場合、ブランチ先端から作成されたブランチには、呼び出し元の下書きプロシージャセットが含まれます。
  • プロシージャを一覧表示と、プロシージャの作成、取得、下書きエンドポイント
    • 一覧項目にオプションのreferenced_tool_ids、referenced_kb_ids、referenced_procedure_ids、referenced_dynamic_variables（文字列配列）を追加しました。
    • エージェントおよびマージプレビューレスポンスに、プロシージャIDをキーとするマップであるオプションのproceduresを追加しました。
  • テスト呼び出しを一覧表示 - GET /v1/convai/test-invocations
    • テストとフォルダーを名前でフィルタリングするための、オプションでnull許容のsearch（文字列）を追加しました。
  • エージェントでテストを実行とテスト呼び出しを取得
    • テストスイート呼び出しと単体テスト実行のレスポンスに、オプションで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アカウントを取得 - GET /v1/convai/whatsapp-accounts/{phone_number_id}
    • オプションのaccount_type（WhatsAppAccountType、デフォルトcloud_api）を追加しました。値はcloud_apiとcoexistenceです。
  • 想定LLM使用量を計算 - POST /v1/convai/agent/{agent_id}/llm-usage/calculate
    • LLMUsageCalculatorLLMResponseModelに必須のprice_per_message（数値）を追加しました。

音楽

  • MusicModelIDに、POST /v1/music/video-to-music、POST /v1/music/plan、音楽を作曲、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機能ステータスを追加しました。