> 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 - **`agent_response_complete` WebSocketイベント**：エージェントの応答が完全に配信された時点で、ちょうど1回だけ新しい[`agent_response_complete`クライアントイベント](/docs/ja/eleven-agents/customization/events/client-events)が発火します。これは、すべてのLLM生成、ツール呼び出しチェーン、オーディオ再生が完了した後です。このイベント以降、ユーザーが新しい入力を提供するか、ターンタイムアウトによって新しいターンが開始されない限り、エージェントは追加の出力を生成しません。このイベントにより、クライアントはメッセージのバッチ処理、ウェイクワードの有効化、ターン後のUI更新に向けて、ターンの終了を確実に検出できます。`ClientEvent`列挙型に新しい`AGENT_RESPONSE_COMPLETE`値を追加し、対応する`AgentResponseCompleteClientEvent`レスポンスモデルも追加しました。 - **ツール実行前の発話モード**：MCPサーバー設定およびツールごとのオーバーライドに、新しい`pre_tool_speech`フィールド（`PreToolSpeechMode`列挙型、デフォルトは`auto`）を追加しました。これにより、非推奨となった`force_pre_tool_speech`ブール値を置き換えます。値：`auto`は直近のツールレイテンシーに基づいてツール呼び出し前にエージェントが発話するかを決定し、`force`は常にエージェントに発話を求め、`off`は完全に無効化します。 - **ツールディスパッチが実行モードを尊重**：ワークフローツールのディスパッチノードが、ネストされた各ツールの`execution_mode`を正しく尊重するようになりました。ディスパッチノード内のいずれかのツールが`POST_TOOL_SPEECH`を使用している場合、ワークフローは現在のターンのオーディオが完全に公開されるまで待機してからディスパッチを実行します。 - **MCPレスポンスタイムアウト**：MCPサーバー設定およびツールごとのオーバーライドに、各MCPツール呼び出しの完了を待機する最大時間を制御する`response_timeout_secs`フィールド（整数、デフォルト`30`、最小`5`、最大`120`）を追加しました。 - **エージェント信頼コンテキスト**：エージェントプラットフォーム設定に`trust_context`フィールド（`AgentTrustContext`列挙型：`unknown`｜`low`｜`high`、デフォルト`unknown`）を追加しました。`low`は、出力を検証しツールアクセスを制限すべき、信頼できない外部参加者に対応するエージェント向けです。`high`は、完全なツールアクセスが適切なオーナーに対応するエージェント向けです。`unknown`は、この機能より前に作成されたエージェントを対象とします。 - **ソース帰属の切り替え**：会話設定に`source_attribution`ブール値（デフォルト`false`）を追加しました。有効にすると、ナレッジベースのコンテンツが存在する場合、LLMは使用したソースを報告するよう指示されます。 - **テスト共有モードフィルター**：[テスト一覧](/docs/ja/api-reference/tests/list)エンドポイントが、`sharing_mode`クエリパラメーター（`all`｜`shared_with_me`、デフォルト`all`）を受け付けるようになりました。これにより、現在のユーザーと共有されていて、そのユーザー自身が作成していないテストとフォルダーだけに絞り込めます。 - **ツールアイコンと実行メタデータ**：`Tool`スキーマに`icons`（`Icon`の配列）および`execution`（`ToolExecution`）フィールドを追加しました。`Icon`にはUI表示用の`src`、`mimeType`、`sizes`が含まれ、`ToolExecution.taskSupport`（`forbidden`｜`optional`｜`required`）はツールがタスクにどのように参加するかを宣言します。 - **プロシージャコンパイラーのデフォルト**：`ProcedureCompilerMode`のデフォルトを`deterministic`から`append`に変更し、`llm`値を削除しました。明示的に`deterministic`を設定している既存のエージェントには影響ありません。 - **RAGおよびナレッジベースの帰属メタデータ**：`ConversationHistoryTranscriptCommonModel`および`ConversationHistoryTranscriptResponseModel`に`used_static_kb_document_ids`（文字列配列）を、`RagRetrievalInfo`に`used_chunk_ids`を追加しました。これにより、各トランスクリプトターンに寄与したナレッジベースドキュメントとRAGチャンクを正確に確認できます。 - **動的変数のリファクタリング**：`dynamic_variables`と`dynamic_variable_placeholders`が、統合された`DynamicVariableValueType-Input`／`DynamicVariableValueType-Output`スキーマ（従来の`DynamicVariableContainerValueType-*`スキーマを置き換え）を参照するようになり、ネストされた値とリスト値をより幅広くサポートします。`DynamicVariableAssignment`には、文字列への強制変換ではなく型付きの値を保持するための`preserve_native_type`フィールドを追加しました。 ### オーディオ分離 - **履歴エンドポイント**：オーディオ分離の履歴を公開する新しいエンドポイントを2つ追加しました。 - [オーディオ分離履歴の一覧](/docs/ja/api-reference/audio-isolation/list)（`GET /v1/audio-isolation/history`）は、すべてのオーディオ分離生成のページネーション付きリストを返します。`page_size`、`page`、`search`クエリパラメーターをサポートします。 - [オーディオ分離履歴アイテムの削除](/docs/ja/api-reference/audio-isolation/delete)（`DELETE /v1/audio-isolation/history/{history_item_id}`）は、特定のアイテムと関連するメディアファイルを削除します。 ### スピーチtoテキスト - **リアルタイムのキータームと逐語モード**：[ScribeリアルタイムWebSocket](/docs/ja/api-reference/speech-to-text/v-1-speech-to-text-realtime)が、モデルを特定の用語に寄せるための`keyterms`パラメーター（文字列配列、最大50件、各20文字まで）と、トランスクリプトからフィラーワード、言い直し、非流暢表現を除去する`no_verbatim`ブール値を受け付けるようになりました。両パラメーターは`session_started`イベントでエコーバックされます。[JavaScript SDK](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.45.0)、[Python SDK](https://github.com/elevenlabs/elevenlabs-python)、および[`@elevenlabs/client`](https://github.com/elevenlabs/packages/tree/main/packages/client)ブラウザー／NodeクライアントSDKで利用できます。 ### SDKリリース #### Python SDK - [v2.45.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.45.0) - 2026年4月27日のAPIスキーマ向けFern再生成。オーディオ分離履歴エンドポイント、ツール実行、MCPの`pre_tool_speech`と`response_timeout_secs`、および`agent_response_complete`クライアントイベントを含みます。READMEのノートブックインストールヒントの修正も含まれます。 - [v2.44.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.44.0) - 2026年4月21日のAPIスキーマ向けFern再生成。`trust_context`フィールド、`pre_tool_speech`モード、アセット文字起こしサポート、MCPレスポンスタイムアウト設定を取り込みました。 #### JavaScript SDK - [v2.45.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.45.0) - Scribeリアルタイムクライアントに、`keyterms`（文字列配列、最大50個のキーターム、各20文字まで）および`noVerbatim`（ブール値）オプションを追加しました。`keyterms`は文字起こしを誘導するため、WebSocket URL上の繰り返しクエリパラメーターとして送信され、`noVerbatim`はフィラーワードと非流暢表現を除去します。両フィールドは、`session_started`エコー用の型付き`Config`インターフェースにも追加されています。2026年4月27日のFern再生成（[#376](https://github.com/elevenlabs/elevenlabs-js/pull/376)）も含まれます。 - [v2.44.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.44.0) - 2026年4月21日のAPIスキーマ向けFern再生成。`trust_context`フィールド、`pre_tool_speech`モード、MCPレスポンスタイムアウト設定を取り込みました。 #### Swift SDK - [v3.1.4](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.1.4) - エージェント切断後もローカルマイクが公開を続ける問題（無音タイムアウトまたは`end_call`ツール）を修正しました。`onAgentDisconnected`はLiveKitルームを切断して会話状態を破棄するようになり、`onDisconnect`は`.agent`理由で発火します。`ConnectionManaging.onAgentDisconnected`は`async`になりました。未使用の`ConversationConnectionManager`ラッパーを削除しました。 #### パッケージ - [@elevenlabs/client@1.3.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@1.3.1) - エージェントのツール呼び出し音がユーザーの発話として解釈され、ツール実行中にエージェントを中断してしまう問題を修正しました。 - [@elevenlabs/client@1.3.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@1.3.0) - [会話ファイルアップロード](/docs/ja/api-reference/conversations/upload-file)エンドポイントのサポートを追加し、クライアントSDKから進行中の会話に直接ファイルを添付できるようにしました。 - [@elevenlabs/react@1.2.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@1.2.1), [@elevenlabs/react@1.2.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@1.2.0) - `@elevenlabs/client@1.3.1`／`@elevenlabs/client@1.3.0`に更新し、ツール呼び出し音の修正と会話ファイルアップロードのサポートを取り込みました。 - [@elevenlabs/react-native@1.1.3](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react-native@1.1.3), [@elevenlabs/react-native@1.1.2](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react-native@1.1.2) - 同じ修正のため、最新の`@elevenlabs/client`に更新しました。 - [@elevenlabs/convai-widget-core@0.11.6](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.11.6), [@elevenlabs/convai-widget-embed@0.11.6](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.11.6) - ツール呼び出し音の修正のため、`@elevenlabs/client@1.3.1`に更新しました。 - [@elevenlabs/convai-widget-core@0.11.5](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.11.5), [@elevenlabs/convai-widget-embed@0.11.5](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.11.5) - 会話ファイルアップロードのサポートのため、`@elevenlabs/client@1.3.0`に更新しました。 ### API ## 新しいエンドポイント - [オーディオ分離履歴の一覧](/docs/ja/api-reference/audio-isolation/list) - `GET /v1/audio-isolation/history` - [オーディオ分離履歴アイテムの削除](/docs/ja/api-reference/audio-isolation/delete) - `DELETE /v1/audio-isolation/history/{history_item_id}` - [ツール実行の取得](/docs/ja/api-reference/tools/get-executions) - `GET /v1/convai/tools/{tool_id}/executions`は、オプションの`cursor`、`page_size`、`is_error`、`agent_id`、`branch_id`、`start_time`、`end_time`フィルターを使用して、特定のツールのページネーション付きツール実行を返します ## 更新されたエンドポイント ### ElevenAgents - [エージェントを作成](/docs/ja/api-reference/agents/create)、[エージェントを取得](/docs/ja/api-reference/agents/get)、[エージェントを更新](/docs/ja/api-reference/agents/update) - `AgentPlatformSettingsRequestModel`に`trust_context`フィールド（`AgentTrustContext`列挙型：`unknown`｜`low`｜`high`、デフォルト`unknown`）を追加 - `ConversationConfig`に`source_attribution`フィールド（ブール値、デフォルト`false`）を追加 - [MCPサーバー設定を更新](/docs/ja/api-reference/mcp/update)、[MCPサーバーを作成](/docs/ja/api-reference/mcp/create) - `pre_tool_speech`フィールド（`PreToolSpeechMode`列挙型：`auto`｜`force`｜`off`、デフォルト`auto`）を追加 - `response_timeout_secs`フィールド（整数、デフォルト`30`、最小`5`、最大`120`）を追加 - [設定オーバーライドを作成](/docs/ja/api-reference/mcp/tool-configuration/create)、[設定オーバーライドを更新](/docs/ja/api-reference/mcp/tool-configuration/update) - `pre_tool_speech`フィールド（`PreToolSpeechMode`列挙型、null許容、任意）を追加 - `response_timeout_secs`フィールド（整数、null許容、任意）を追加 - `MCPToolConfigOverride-Input`／`MCPToolConfigOverride-Output`に`response_mocks`フィールドを追加 - `force_pre_tool_speech`を非推奨としてマーク。代わりに`pre_tool_speech`を使用してください - [テスト一覧](/docs/ja/api-reference/tests/list) - オプションの`sharing_mode`クエリパラメーター（`TestSharingMode`列挙型：`all`｜`shared_with_me`、デフォルト`all`）を追加 - [会話をシミュレート](/docs/ja/api-reference/agents/simulate-conversation)、[会話シミュレーションをストリーミング](/docs/ja/api-reference/agents/simulate-conversation-stream) - `dynamic_variables`および`dynamic_variable_placeholders`ペイロードをリファクタリングし、ネスト値とリスト値をより幅広くサポートする統合`DynamicVariableValueType-Input`／`DynamicVariableValueType-Output`スキーマを参照するよう変更 - `Tool`スキーマ - UI表示用に`icons`フィールド（`Icon`の配列、null許容）を追加 - `taskSupport`（`forbidden`｜`optional`｜`required`）を含む`execution`フィールド（`ToolExecution`、null許容）を追加 - `ClientEvent`列挙型 - 新しい`AgentResponseCompleteClientEvent`レスポンスモデルとともに`agent_response_complete`値を追加 - `ProcedureCompilerMode`列挙型 - デフォルトを`deterministic`から`append`に変更 - `llm`値を削除 - `ConversationHistoryTranscriptCommonModel`、`ConversationHistoryTranscriptResponseModel` - `used_static_kb_document_ids`フィールド（文字列配列）を追加 - `RagRetrievalInfo` - `used_chunk_ids`フィールド（文字列配列）を追加 - `DynamicVariableAssignment` - 文字列への強制変換ではなく型付きの値を保持するための`preserve_native_type`フィールド（ブール値）を追加 - ワークフローノード - 関連するワークフローノードスキーマに`auto_advance_after_first_response`フィールドを追加 - ツール設定ドキュメント - 想定されるレスポンス形式を文書化するための`response_body_schema`フィールドを追加 ### ワークスペース - `GetUserSubscriptionResponseModel` - `max_credit_limit_extension`フィールドを追加 - [プロダクト別のワークスペース使用量を期間ごとに取得](/docs/ja/api-reference/workspace/usage/get-usage-by-product-over-time) - リクエスト検証を厳格化：`start_time`と`end_time`の最小値を`2020-01-01`に引き上げ、両フィールドに説明を追加しました。エンドポイントの概要は`Get Workspace Usage`に改名されました。 ### その他 - 新しい共有`Currency`列挙型を追加。値は`eur`、`inr`、`usd`で、複数のスキーマにあるインライン通貨文字列を置き換えます。 - 新しい`AssetTranscription`および`AssetTranscriptionData`スキーマにより、アセットモデルに文字起こしサポートを拡張しました。 - 新しい`PendingBlocksMetadataModel`および`PendingExternalAudiosMetadataModel`により、保留中タスクに関するより豊富なメタデータを提供します。 - ソース関連の列挙型に新しい`InVPC`値を追加しました。 - 文字起こしの`keyterms`に、仕様上の明示的な長さ制限が追加されました。 - 新しい`MemoryEntrySearchResult`、`ConversationSource`、`ManualSource`スキーマを追加しました。