> 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 - **エージェントワークフローでのMCPツールのスコープ設定**：エージェントワークフローノードで、サブエージェントが呼び出せるMCPツールを制限できるようになりました。ノードでツール継承を無効にすると、明示的に選択したMCPツールのみがそのサブエージェントに読み込まれ、チームはワークフローの各ステップごとにツールへのアクセスを細かく制御できます。 - **会話でのファイルアップロード**：[エージェントを作成](/docs/ja/api-reference/agents/create)および[エージェントを更新](/docs/ja/api-reference/agents/update)エンドポイントで、`ConversationConfig`の`file_input`フィールドをサポートするようになりました。有効にすると、エンドユーザーはチャットで画像やPDFを添付できます（マルチモーダル入力に対応したLLMが必要です）。`enabled`（boolean）と`max_files_per_conversation`（integer）で設定できます。 - **会話分析を再実行**：新しい[会話分析を実行](/docs/ja/api-reference/conversations/analysis/run-analysis)エンドポイント（`POST /v1/convai/conversations/{conversation_id}/analysis/run`）は、新しい通話を行わずに、エージェントの現在の評価基準とデータ収集設定を使用して完了済みの会話を再評価します。 - **テスト用ツールレスポンスのモック**：エージェントシミュレーションテストとテストスイートの呼び出しで、テスト中のツール呼び出しの処理方法を制御する`tool_mock_config`フィールドをサポートするようになりました。`MockingStrategy`（`all`、`selected`、`none`）でモックするツールを選択し、`MockNoMatchBehavior`（`call_real_tool`、`raise_error`）で一致するモックがない場合のフォールバックを設定できます。 - **テキスト検索の並び順**：[会話をテキスト検索](/docs/ja/api-reference/conversations/messages/text-search)エンドポイントで、`search_score`（デフォルト）または`created_at`の値を持つ`sort_by`クエリパラメータを受け付けるようになりました。これにより、関連性または新しさで結果を並べ替えられます。 - **mTLS認証接続**：エージェント認証接続で、既存のオプションに加えて相互TLS（`mtls`）を`auth_type`としてサポートするようになりました。mTLS認証接続の作成と取得には、新しい`CreateMTLSAuthRequest`および`MTLSAuthResponse`スキーマを使用できます。 - **最大時間到達時のメッセージ**：エージェント設定に`max_conversation_duration_message`フィールドを追加しました。空でない文字列に設定すると、最大会話時間に達した際にエージェントがこのメッセージをユーザーに送信します。 - **会話開始時のブランチと環境**：会話開始クライアントデータ（`ConversationInitiationClientDataRequest`）および[バッチ通話を送信](/docs/ja/api-reference/batch-calling/create)リクエストボディに、任意の`branch_id`フィールドと`environment`フィールドを追加しました。これにより、特定のエージェントブランチと環境にルーティングできます。 ### 音楽 - **ビデオから音楽を生成**：新しい`POST /v1/music/video-to-music`エンドポイントは、1つ以上のビデオファイルからバックグラウンドミュージックを生成します。ビデオは順番に結合されます。任意の`description`（最大1,000文字）と`tags`（`upbeat`や`cinematic`など、最大10個のスタイルタグ）を指定して、生成されるトラックに影響を与えられます。 ### スピーチtoテキスト - **URLから文字起こし**：[音声をテキストに変換](/docs/ja/api-reference/speech-to-text/convert)エンドポイントで、ホストされたURLからオーディオまたはビデオを文字起こしするための`source_url`パラメータ（string、任意）を受け付けるようになりました。YouTube動画、TikTok動画、その他の動画ホスティングサービスに対応しています。ファイルを直接アップロードする代わりに使用できます。 ### ボイス - **共有ボイスリストの総数**：[共有ボイスを一覧表示](/docs/ja/api-reference/voices/voice-library/get-shared)レスポンスに`total_count`フィールドが含まれるようになり、ページネーションの実装や結果数の表示が容易になりました。 ### SDKリリース #### JavaScript SDK - [v2.41.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.41.0) - ElevenAgentsのリアルタイム会話で`multimodal_message`WebSocketイベントタイプのサポートを追加しました。最新のAPIスキーマ更新に対応するFern再生成を含みます。 - [v2.41.1](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.41.1) - 2026年4月1日のAPIスキーマに合わせたFern再生成。 #### Python SDK - [v2.41.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.41.0) - テキストのみの会話モードで`audio_interface`を任意にし、オーディオなしでセッションを開始した場合のランタイムエラーを解決しました。最新のAPIスキーマに対応するFern再生成を含みます。 #### パッケージ このリリースには、クライアント側Agent SDKの新しいv1.0.0が含まれます。`@elevenlabs/client`、`@elevenlabs/react`、`@elevenlabs/react-native`には大きな破壊的変更があります。アップグレード前に、以下の移行ガイドを確認してください。 アップグレードを支援するため、エージェントが代わりにアップグレードできるSkillをリリースしました。次のコマンドでインストールしてください。 ``` npx skills add elevenlabs/packages ``` v1リリースとその改善点については、[デベロッパーブログ](https://elevenlabs.io/blog/elevenagents-react-sdk-v1-0)で詳しくご覧いただけます。 - [@elevenlabs/client@1.0.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@1.0.0) — **破壊的変更：** - `Input`クラスと`Output`クラスはエクスポートされなくなりました。代わりに、`@elevenlabs/client`の`InputController`および`OutputController`インターフェースを使用してください。 - `Conversation`はクラスではなくなり、現在は名前空間オブジェクトおよび`TextConversation | VoiceConversation`の型エイリアスです。`instanceof Conversation`チェックとサブクラスをすべて削除してください。 - デフォルトの`connectionType`は会話モードから推論されるようになりました。音声会話ではデフォルトで`"webrtc"`、テキストのみの会話では`"websocket"`を使用します。音声で以前の動作を維持するには、`connectionType: "websocket"`を明示的に渡してください。 - `VoiceConversation.wakeLock`は非公開になりました。ウェイクロック管理を無効にするには、セッションオプションで`useWakeLock: false`を渡してください。 - `changeInputDevice()`および`changeOutputDevice()`は、`Promise`または`Promise`ではなく`Promise`を返すようになりました。 - `conversation.input.analyser.getByteFrequencyData(data)`を`conversation.getInputByteFrequencyData()`に置き換えてください。 - `conversation.input.setMuted(v)`を`conversation.setMicMuted(v)`に置き換えてください。 - `conversation.output.gain.gain.value = v`を`conversation.setVolume({ volume: v })`に置き換えてください。 - `getInputVolume()`、`getOutputVolume()`、`getInputByteFrequencyData()`、`getOutputByteFrequencyData()`は、アクティブな会話がない場合に例外をスローする代わりに、`0`または空の`Uint8Array`を返すようになりました。 - [@elevenlabs/react@1.0.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@1.0.0) — **破壊的変更：** - `useConversation`には`ConversationProvider`の祖先が必要になりました。コンポーネントツリーを``でラップし、オプションをプロバイダーまたはフックに移動してください。 - `DeviceFormatConfig`および`DeviceInputConfig`のエクスポートは削除されました。代わりに、`@elevenlabs/client`の`FormatConfig`および`InputDeviceConfig`を使用してください。 - レンダリングパフォーマンスを向上させるため、モノリシックな`useConversation`を新しい詳細なフックに置き換えました：`useConversationControls()`、`useConversationStatus()`、`useConversationInput()`、`useConversationMode()`、`useConversationFeedback()`、`useRawConversation()`。各フックは必要な状態のみを購読するため、不要な再レンダリングを防ぎます。 - エージェントが呼び出せるクライアントツールを登録するための新しい`useConversationClientTool(name, handler)`フックを追加しました。アンマウント時に自動でクリーンアップされます。 - `ConversationProvider`の`isMuted`および`onMutedChange`propsにより、制御可能なミュートサポートを追加しました。 - [@elevenlabs/react-native@1.0.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react-native@1.0.0) — **破壊的変更：** - 以前の`ElevenLabsProvider`および`useConversation`APIは削除され、`@elevenlabs/react`からの再エクスポートに置き換えられました。`ElevenLabsProvider`を`ConversationProvider`に、`useConversation`を詳細なフック（`useConversationControls`、`useConversationStatus`など）に置き換えてください。 - React Nativeでは、パッケージのインポート時にWebRTCグローバルをポリフィルし、ネイティブの`AudioSession`を設定して、プラットフォーム固有の音声セッション戦略を登録するようになりました。 - [@elevenlabs/types@0.8.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/types@0.8.0) - `Callbacks`インターフェースのすべてのキーを含む`CALLBACK_KEYS`ランタイム配列をエクスポートします。React SDKがコールバック構成に内部的に使用します。 - [@elevenlabs/client@0.16.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@0.16.0) - `guardrail_triggered`サーバー・クライアント間WebSocketイベントと、会話中にサーバーがガードレール違反を検出した際に発火する`onGuardrailTriggered`コールバックを追加しました。また、判別可能なユニオンの絞り込みを可能にする`TextConversation`および`VoiceConversation`の型判別子と、`textOnly`オプションに基づいて戻り値の型を絞り込む`startSession`オーバーロードも追加しました。 - [@elevenlabs/react-native@0.6.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react-native@0.6.0) - `@elevenlabs/client@0.16.0`と一貫して、`guardrail_triggered`WebSocketイベントと`onGuardrailTriggered`コールバックを追加しました。 - [@elevenlabs/client@1.1.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@1.1.0) - エージェント会話でツールレスポンスをモックするクライアント側サポートを追加し、実際のツールを呼び出さずにツール呼び出しの結果をシミュレートするテストシナリオを実現しました。 - [@elevenlabs/types@0.9.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/types@0.9.0) - エージェント会話におけるツールレスポンスモックの型定義を追加しました。 - [@elevenlabs/react@1.0.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@1.0.1) - `@elevenlabs/client@1.1.0`に依存するよう更新しました。 - [@elevenlabs/react-native@1.0.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react-native@1.0.1) - `@elevenlabs/client@1.1.0`および`@elevenlabs/react@1.0.1`に依存するよう更新しました。 ### API ## 新しいエンドポイント - [会話分析を実行](/docs/ja/api-reference/conversations/analysis/run-analysis) - `POST /v1/convai/conversations/{conversation_id}/analysis/run` - エージェントの現在の評価基準とデータ収集設定を使用して、完了済みの会話の分析を再実行します。 - `POST /v1/music/video-to-music` - multipartフォームデータとして提供された1つ以上のビデオファイルからバックグラウンドミュージックを生成します。 ## 更新されたエンドポイント ### ElevenAgents - [エージェントを作成](/docs/ja/api-reference/agents/create)、[エージェントを更新](/docs/ja/api-reference/agents/update) - `ConversationConfig`に`file_input`フィールド（`FileInputConfig`、任意）を追加し、LLMがマルチモーダル入力をサポートする場合に、チャット会話でのファイルアップロード（画像、PDF）を有効化 - エージェント設定に`max_conversation_duration_message`フィールド（string、任意）を追加。セッションの時間制限に達すると、エージェントがこのメッセージを送信します - [テストを作成](/docs/ja/api-reference/tests/create)、[テストを更新](/docs/ja/api-reference/tests/update) - `tool_mock_config`フィールド（object、任意）を追加。シミュレーション中のツールモック動作を制御するための、ツール名から`ToolResponseMockConfig`エントリへのマップ - [会話をテキスト検索](/docs/ja/api-reference/conversations/messages/text-search) - `sort_by`クエリパラメータ（string、任意）を追加。`search_score`（デフォルト）または`created_at`を受け付けます - [バッチ通話を送信](/docs/ja/api-reference/batch-calling/create) - 特定のエージェントブランチを対象にする`branch_id`フィールド（string、任意）を追加 - 対象環境を指定する`environment`フィールド（string、任意）を追加 - [Twilio発信通話](/docs/ja/api-reference/twilio/outbound-call)、[SIPトランク発信通話](/docs/ja/api-reference/sip-trunk/outbound-call) - 会話開始クライアントデータで、任意の`branch_id`フィールドと`environment`フィールドを受け付けるようになりました ### スピーチtoテキスト - [音声をテキストに変換](/docs/ja/api-reference/speech-to-text/convert) - `source_url`パラメータ（string、任意）を追加。ファイルアップロードの代わりに、オーディオまたはビデオファイル、YouTube動画、TikTok動画、その他のホストされたメディアのURLを受け付けます ### ボイス - [共有ボイスを一覧表示](/docs/ja/api-reference/voices/voice-library/get-shared) - レスポンスモデルに`total_count`フィールド（integer）を追加 ### 強制アラインメント - [強制アラインメントを作成](/docs/ja/api-reference/forced-alignment/create) - multipartフォームデータのリクエストボディから`enabled_spooled_file`パラメータを削除