> 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

- **新しいウィジェット設定オプション**：エージェントダッシュボードのElevenAgents会話ウィジェットで、複数の新しい設定を利用できるようになりました。

  - **折りたたみ可能なウィジェット**（`widget.dismissible`）：会話中にユーザーがウィジェットを最小化または閉じられるようにします。
  - **アクションインジケーター**（`widget.show_agent_status`）：エージェントがツールを使用中の場合に視覚的なインジケーターを表示します。作業中、完了、エラーの状態を区別して表示します。この設定を有効にすると、`agent_tool_request`と`agent_tool_response`がエージェントのクライアントイベントに自動追加されます。
  - **会話IDの表示**（`widget.show_conversation_id`）：通話終了後に会話IDをユーザーに表示します。新規および既存のエージェントでは、デフォルトで`true`です。
  - **オーディオタグの表示設定**（`widget.strip_audio_tags`）：会話の文字起こしからオーディオタグを非表示にします。新規および既存のエージェントでは、デフォルトで`true`です。
  - **構文ハイライトテーマ**（`widget.syntax_highlight_theme`）：文字起こし内のコードブロックのハイライトを設定します。`null`（自動）、`light`、または`dark`を指定できます。

- **フォルダー対応のエージェントテスト**：[エージェントテストの一覧](/docs/ja/api-reference/tests/list)エンドポイントが、テストをフォルダーに整理できるようになりました。フィルタリングした一覧表示用に、`parent_folder_id`、`include_folders`、`sort_mode`クエリパラメーターを追加しました。テスト作成・更新エンドポイントでは、テストをフォルダーに割り当てるための`parent_folder_id`を受け付け、テストのサマリーにはエンティティタイプ、親フォルダーのパス、子要素数が含まれるようになりました。

- **ワークフローの`say`ノード**：エージェントワークフローに新しい`say`ノードタイプ（`WorkflowSayNodeModel`）を追加しました。このノードは、`conversation_config`、`additional_prompt`、ツールおよびナレッジベースのオーバーライドをサポートします。ノードのメッセージペイロードは、`literal`（`text`による静的テキスト）と`prompt`（`prompt`によるLLM生成）の2つのバリアントを持つ判別共用体を使用します。

- **SMBツール設定**：必須の判別付き`params`オブジェクトを含む`SMBToolConfig`スキーマを正式化しました。対応する操作タイプは`create`、`list`、`search`、`update`、`delete`で、クライアント、スタッフ、サービス、商品、アセットなどのSMBエンティティカテゴリに適用できます。

- **エージェントの要約言語**：会話後の要約に使用する言語を指定するため、エージェント設定に`summary_language`フィールドを追加しました。

- **Twilio通話録音**：[Twilio発信通話](/docs/ja/api-reference/twilio/outbound-call)リクエスト本文に、発信通話の録音を有効にする任意の`call_recording_enabled`フィールドを追加しました。

- **WhatsAppメッセージングフラグ**：指定した電話番号でメッセージングを有効にするかどうかを制御するため、WhatsAppアカウントモデルと更新リクエストに`enable_messaging`フラグを追加しました。

### 発音辞書

- **すべてのルールを一度に設定**：新しい[ルールを設定](/docs/ja/api-reference/pronunciation-dictionaries/rules/set)エンドポイント（`POST /v1/pronunciation-dictionaries/{pronunciation_dictionary_id}/set-rules`）では、個別のルールを段階的に追加・削除する代わりに、1回の呼び出しで発音辞書内の既存ルールをすべて置き換えられます。

- **ルール照合オプション**：発音辞書のルール定義に`case_sensitive`（boolean）と`word_boundaries`（boolean）フィールドを追加し、ルールによるテキスト照合をより細かく制御できるようにしました。

### 音楽

- **オーディオをアップロード**：新しい[音楽をアップロード](/docs/ja/api-reference/music/upload)エンドポイント（`POST /v1/music/upload`）は、オーディオファイルを含む`multipart/form-data`リクエストを受け付けます。アップロードしたオーディオから構成プランを任意で抽出し、`song_id`を含む`MusicUploadResponse`を返します。

- **発音名のサポート**：[音楽を生成](/docs/ja/api-reference/music/compose)、[詳細な音楽生成](/docs/ja/api-reference/music/compose-detailed)、[音楽をストリーミング](/docs/ja/api-reference/music/stream)エンドポイントに`use_phonetic_names`パラメーターを追加しました。

- **レスポンス内の曲ID**：音楽生成レスポンスで`song_id`フィールドが返されるようになり、後続のAPI呼び出しで生成した曲を参照しやすくなりました。

### オーディオネイティブ

- **URLからプロジェクトコンテンツを更新**：新しい[コンテンツを更新](/docs/ja/api-reference/audio-native/update-content)エンドポイント（`POST /v1/audio-native/content`）では、URLを指定してAudioNativeプロジェクトを更新できます。エンドポイントはURLからコンテンツを抽出し、変換と自動公開のキューに追加します。

### 音声

- **音声のブックマーク**：音声更新リクエストに`bookmarked`フィールド、音声レスポンスオブジェクトに`is_bookmarked`フィールドを追加し、音声をブックマークして簡単にアクセスできるようにしました。

### SDKリリース

#### JavaScript SDK

- [v2.37.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.37.0) - 音楽生成レスポンスで`song_id`を返すサポートを追加しました。Fernの再生成による最新のAPIスキーマ変更を反映しました。

#### Python SDK

- [v2.37.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.37.0) - 新しい音楽生成パラメーターと、音楽生成レスポンスでの`song_id`表示をサポートしました。Fernの再生成による最新のAPIスキーマ変更を反映しました。

#### パッケージ

- [@elevenlabs/convai-widget-core@0.10.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.10.0) - 文字起こしおよびストリーミングコールバックに`event_id`を伝播しました。ツールステータスの追跡をMapベースから、`display-transcript`ユーティリティを使用するインライン文字起こしエントリにリファクタリングしました。切断メッセージでの会話IDの表示を制御する`show-conversation-id`設定オプション（boolean、デフォルトは`true`）を追加しました。
- [@elevenlabs/convai-widget-embed@0.10.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.10.0) - 文字起こしおよびストリーミングコールバックに`event_id`を伝播しました。ツールステータスの追跡をインライン文字起こしエントリにリファクタリングしました。
- [@elevenlabs/types@0.6.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/types@0.6.0) - 文字起こしおよびストリーミングコールバックに`event_id`を伝播しました。

### API

<Accordion title="APIの変更を表示">

## 新しいエンドポイント

- [発音辞書ルールを設定](/docs/ja/api-reference/pronunciation-dictionaries/rules/set) - `POST /v1/pronunciation-dictionaries/{pronunciation_dictionary_id}/set-rules` - 1回の呼び出しで発音辞書内のすべてのルールを置き換え
- [音楽をアップロード](/docs/ja/api-reference/music/upload) - `POST /v1/music/upload` - オーディオファイルをアップロードして曲を作成または参照し、必要に応じて構成プランを抽出
- [URLからAudio Nativeコンテンツを更新](/docs/ja/api-reference/audio-native/update-content) - `POST /v1/audio-native/content` - 指定したURLからコンテンツを抽出し、変換キューに追加してAudioNativeプロジェクトを更新

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

### ElevenAgents

- [エージェントテストの一覧](/docs/ja/api-reference/tests/list)

  - フォルダーでテストをフィルタリングする`parent_folder_id`クエリパラメーター（string、任意）を追加
  - 結果にフォルダーオブジェクトを含める`include_folders`クエリパラメーター（boolean、任意）を追加
  - 結果の並び順を制御する`sort_mode`クエリパラメーター（string、任意）を追加
  - レスポンスにフォルダーメタデータを追加：`UnitTestSummaryResponseModel`のエンティティタイプ、親パス、子要素数

- [エージェントテストを作成](/docs/ja/api-reference/tests/create)、[エージェントテストを更新](/docs/ja/api-reference/tests/update)

  - テストをフォルダーに割り当てる`parent_folder_id`フィールド（string、任意）を追加

- [エージェントを作成](/docs/ja/api-reference/agents/create)、[エージェントを更新](/docs/ja/api-reference/agents/update)、[エージェントを取得](/docs/ja/api-reference/agents/get)

  - 会話後の要約言語用に、エージェント設定へ`summary_language`フィールド（string、任意）を追加
  - `widget.dismissible`（boolean）を追加 - ユーザーがウィジェットを折りたたむ、または閉じることを許可
  - `widget.show_agent_status`（boolean）を追加 - ウィジェットにツール使用状況インジケーターを表示
  - `widget.show_conversation_id`（boolean）を追加 - 通話終了後に会話IDを表示。デフォルトは`true`
  - `widget.strip_audio_tags`（boolean）を追加 - 文字起こしからオーディオタグを非表示。デフォルトは`true`
  - `widget.syntax_highlight_theme`（string、nullable）を追加 - コードブロックのハイライトテーマ（`null`、`light`、または`dark`）
  - `WorkflowSayNodeModel`スキーマを持つ新しいワークフローノードタイプ`say`を追加。`conversation_config`、`additional_prompt`、ツール／ナレッジベースのオーバーライドを含み、メッセージペイロードは`literal`および`prompt`の判別バリアントをサポート

- [Twilio発信通話](/docs/ja/api-reference/twilio/outbound-call)

  - 発信Twilio通話の録音を有効にする`call_recording_enabled`フィールド（boolean、任意）を追加

- [WhatsAppアカウントを更新](/docs/ja/api-reference/whats-app/accounts/update)

  - アカウントのメッセージングを有効または無効にする`enable_messaging`フィールド（boolean、任意）を追加

- [Webhookを更新](/docs/ja/api-reference/webhooks/update)
  - Webhookペイロードスキーマをカスタマイズする`schema_overrides`フィールド（object、任意）を追加

### 発音辞書

- [発音辞書にルールを追加](/docs/ja/api-reference/pronunciation-dictionaries/rules/add)、[発音辞書からルールを削除](/docs/ja/api-reference/pronunciation-dictionaries/rules/remove)
  - 大文字と小文字を区別する照合のため、ルール定義に`case_sensitive`フィールド（boolean）を追加
  - 単語境界を考慮した照合のため、ルール定義に`word_boundaries`フィールド（boolean）を追加

### 音楽

- [音楽を生成](/docs/ja/api-reference/music/compose)、[詳細な音楽生成](/docs/ja/api-reference/music/compose-detailed)、[音楽をストリーミング](/docs/ja/api-reference/music/stream)
  - 生成時の発音名処理を制御する`use_phonetic_names`パラメーター（boolean、任意）を追加
  - レスポンスに`song_id`フィールドを追加

### 音声

- [音声の一覧](/docs/ja/api-reference/voices/search)、[音声を取得](/docs/ja/api-reference/voices/get)

  - 音声レスポンスオブジェクトに`is_bookmarked`フィールド（boolean）を追加

## スキーマの変更

### 新しいスキーマ

- `WorkflowSayNodeModel` - 会話設定、プロンプト、ツールオーバーライドを備えたエージェント`say`操作用ワークフローノード
- `WorkflowSayNodeMessageLiteral` - `say`ノード用のリテラル（静的テキスト）メッセージペイロード
- `WorkflowSayNodeMessagePrompt` - `say`ノード用のプロンプトベース（LLM生成）メッセージペイロード
- `MusicUploadResponse` - `song_id`を含む音楽アップロード用レスポンスモデル
- `SMBToolConfigCreateClientParams`、`SMBToolConfigListClientsParams`、`SMBToolConfigSearchClientsParams`、`SMBToolConfigUpdateClientParams`、`SMBToolConfigDeleteClientParams` - SMBツール操作用の判別パラメータータイプ

### 変更されたスキーマ

- `AgentConfig` - `summary_language`フィールドを追加
- `WidgetConfigV2` - `dismissible`、`show_agent_status`、`show_conversation_id`、`strip_audio_tags`、`syntax_highlight_theme`フィールドを追加
- `SMBToolConfig` - `params`フィールドが必須となり、判別共用体を使用
- `PronunciationDictionaryRule` - `case_sensitive`および`word_boundaries`フィールドを追加
- `CustomGuardrailConfig` - `model`フィールドがデフォルト値付きの任意フィールドに変更
- `UnitTestSummaryResponseModel` - フォルダーメタデータフィールドを追加：エンティティタイプ、親パス、子要素数

</Accordion>