> 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 - **テスト固有のツールモック**：エージェントシミュレーションとユニットテストで、ツールIDをキーとする`tool_mock_overrides`を定義し、1つのテストに限り共有モックを置き換えられるようになりました。`ToolResponseMockConfig`には任意の`is_error`（ブール値、デフォルトは`false`）も追加され、モックでツール失敗パスをテストできます。 - **翻訳されたワークフローメッセージ**：リテラルSayノードメッセージに、言語キーから`TranslatedString`オブジェクトへのマップである`text_translations`を追加しました。このフィールドは入力では任意、出力では必須のため、厳密なレスポンスバリデーターはこれを受け入れる必要があります。 - **会話バージョンフィルター**：[会話を一覧表示](/docs/ja/api-reference/conversations/list)と[会話メッセージをテキスト検索](/docs/ja/api-reference/conversations/messages/text-search)に、エージェントバージョンで結果をフィルタリングする任意の`version_id`クエリパラメーター（文字列）を追加しました。 - **ナレッジベースのシステムツール**：エージェント設定に、設定可能な`enabled_strategies`（`SearchStrategy[]`）を持つ`knowledge_base`システムツールを追加しました。エージェントのナレッジベースRAGクエリに、任意の`use_agent_defaults`（ブール値、デフォルトは`true`）を追加しました。`false`に設定すると、エージェントの埋め込みモデルを維持したまま中立的な取得設定を使用します。 - **エージェントの音声アクティビティ検出**：エージェントの作成、更新、レスポンス、ワークフローオーバーライドのスキーマに`vad`設定を追加しました。`VADConfig`は現在、`background_voice_detection`（ブール値、デフォルトは`false`）に対応しています。 - **WebSocketカスタムLLM**：`CustomLLMAPIType`に`websocket`を追加しました。 - **ファイルメモリ制御**：ウィジェットのファイル入力設定に`max_files_in_memory`（整数、1～30、デフォルトは`10`）を追加しました。上限を超えたファイルは要約され、メモリから解放されます。`max_files_per_conversation`は`-1`またはメモリ上限以上にする必要があります。 - **DTMF入力のマスキング**：`DTMFInputConfig`に任意の`redact_input`（ブール値、デフォルトは`false`）を追加しました。これにより、通話者がキーパッドで入力した数字が文字起こし、会話ログ、分析で置き換えられます。エージェントが繰り返した数字やツールに渡された数字は変更されません。 ### スピーチtoテキスト - **リアルタイムエンティティ検出**：Scribe v2 Realtimeに`entity_detection`クエリオプションを追加しました。`all`、1つのエンティティタイプまたはカテゴリー、あるいはタイプとカテゴリーの配列を受け付け、検出されたエンティティを`committed_transcript_entities`イベントで出力します。対応するカテゴリーについては[エンティティ検出ガイド](/docs/ja/eleven-api/guides/how-to/speech-to-text/batch/entity-detection)をご覧ください。 ### Voices - **データレジデンシー間の音声レプリケーション**：同じ統合請求グループ内のワークスペースにInstant Voice CloneまたはVoice Designの音声をコピーする`POST /v1/voices/{voice_id}/replicate-to-isolated-environment`を追加しました。リクエストには`target_workspace_id`（文字列）が必要で、`preserve_voice_id`（ブール値、デフォルトは`true`）を受け付けます。レスポンスでは対象の`voice_id`が返されます。 - **キャラクターメタデータ**：キャラクターレスポンスに`recommended_voice_ids`（文字列配列、デフォルトは`[]`）を追加し、メタデータにnull許容の`role`（`CharacterRole`）を追加しました。また、`CharacterAge`の`middle-aged`を`middle_aged`に置き換えました。 ### SDKリリース #### パッケージ - [@elevenlabs/client@1.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.16.0)、[@elevenlabs/react@1.11.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.11.0)、[@elevenlabs/types@0.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.18.0)、[@elevenlabs/react-native@1.2.17](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.17)、[@elevenlabs/convai-widget-core@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.0) - `start`、`delta`、`stop`タイプを持つストリーミングエージェント推論イベントを受け取る`onAgentReasoningResponsePart`を追加しました。 - [@elevenlabs/convai-widget-core@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.0)と[@elevenlabs/convai-widget-embed@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.15.0) - `show_resize_button`と`show-resize-button`埋め込み属性を追加しました。いずれかを`false`に設定すると、ウィジェットヘッダーの展開・折りたたみコントロールを非表示にできます。 - [@elevenlabs/client@1.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.17.0)、[@elevenlabs/react@1.12.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.0)、[@elevenlabs/types@0.19.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.19.0)、[@elevenlabs/react-native@1.2.18](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.18)、[@elevenlabs/convai-widget-core@0.15.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.1) - `Scribe.connect`と`useScribe`に`enableLogging`オプションを追加しました。`false`に設定すると、エンタープライズ向けゼロ保持セッションが開始されます。Scribeの`session_started`タイプは`enable_logging`を報告するようになり、未使用の`disable_logging`フィールドは削除されました。 #### MCPサーバー - [v0.12.1](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.12.1) - v0.11のツール更新と、44件のセキュリティアラートを解消する依存関係の更新が含まれます。 - [v0.11.0](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.11.0) - シミュレートされたユーザーの挙動、評価基準、文字起こし出力、合格／不合格分析を設定できる`simulate_conversation`を追加しました。`speech_to_text`ツールのデフォルトは`scribe_v2`になり、`voice_clone`はパス文字列ではなく音声ファイルの内容を送信するようになりました。 ### API ## 新しいエンドポイント ### Voices - `POST /v1/voices/{voice_id}/replicate-to-isolated-environment` - Instant Voice CloneまたはVoice Designの音声を、別のワークスペースの隔離環境にレプリケートします - `target_workspace_id`（文字列）が必要です - 任意の`preserve_voice_id`（ブール値、デフォルトは`true`）を受け付けます - 必須の`voice_id`（文字列）を返します ## 更新されたエンドポイント ### ElevenAgents - [会話を一覧表示](/docs/ja/api-reference/conversations/list) - `GET /v1/convai/conversations` - 任意の`version_id`（文字列）クエリパラメーターを追加しました - [会話メッセージをテキスト検索](/docs/ja/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search` - 任意の`version_id`（文字列）クエリパラメーターを追加しました - `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query` - 任意の`use_agent_defaults`（ブール値、デフォルトは`true`）リクエストフィールドを追加しました ## スキーマの変更 ### ElevenAgents - シミュレーションおよびユニットテストのペイロードに任意の`tool_mock_overrides`マップを追加しました。`ToolResponseMockConfig`には任意の`is_error`（ブール値、デフォルトは`false`）を追加しました - `SayNodeLiteralMessage`に`text_translations`（`TranslatedString`のマップ）を追加しました。このフィールドは入力では任意、出力では必須です - エージェント設定に`knowledge_base`（`KnowledgeBaseToolConfig`）と`vad`（`VADConfig`）を追加しました - `CustomLLMAPIType`に`websocket`を追加しました - `FileInputConfig`に`max_files_in_memory`（整数、1～30、デフォルトは`10`）を追加しました - `DTMFInputConfig`に任意の`redact_input`（ブール値、デフォルトは`false`）を追加しました - リアルタイムエージェント設定のデフォルトが`eleven_realtime_v1_mini`になりました ### Voices - キャラクターレスポンスに`recommended_voice_ids`（文字列配列、デフォルトは`[]`）を追加しました - キャラクターメタデータにnull許容の`role`（`CharacterRole`）を追加しました - 破壊的変更：`CharacterAge`の`middle-aged`を`middle_aged`に置き換えました。以前の値を送信しているクライアントは移行が必要です ### テキスト読み上げ - 破壊的変更：ElevenAgentsのテキスト読み上げ設定スキーマから`AudioFilterId`と`audio_filter`を削除しました