> 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

- **会話ユーザーエンドポイント**：[会話ユーザーを取得](/docs/ja/api-reference/users/list)エンドポイント（`GET /v1/convai/users`）を追加しました。エージェントと会話したユーザーを一覧表示できます。ページネーション、エージェント、期間、そのほかの条件によるフィルタリングに対応しています。
- **エージェントのバージョン管理**：[エージェントを取得](/docs/ja/api-reference/agents/get)エンドポイントの新しい`version_id`および`branch_id`クエリパラメータを使用して、特定バージョンのエージェント設定を取得できるようになりました。[エージェントを更新](/docs/ja/api-reference/agents/update)エンドポイントでも、ブランチ固有の更新用に`branch_id`パラメータを受け付けるようになりました。
- **ドキュメント検索ツール**：RAG（検索拡張生成）用の新しい組み込みシステムツールとして`search_documentation`を追加しました。`MultiSourceConfigJson`、`SourceConfigJson`、`SourceRetrievalConfig`スキーマで複数ソースの検索を設定できます。`MergingStrategy`列挙型による設定可能なマージ戦略をサポートします。
- **MCPツールのサポート**：Webhook、クライアント、システムツールに加え、新しいツールタイプとして`mcp`を追加しました。エージェントのツール定義で、新しい`MCPToolConfig`スキーマを使用してMCPツールを設定できます。
- **コンテンツガードレール**：`GuardrailsV1`にコンテンツモデレーション用ガードレールを追加しました。性的コンテンツ、暴力、ハラスメント、自傷、冒とく、宗教／政治、医療／法律コンテンツの各カテゴリに対してしきい値を設定できます。新しい`ContentGuardrail`および`ContentConfig`スキーマを使用してください。
- **表現力モード**：新しいv3会話モデルの機能を最大限に活用するようエージェントに自動で促す`expressive_mode`フィールド（boolean）をエージェント設定スキーマに追加しました。
- **発信後の数字入力**：電話番号転送で、接続後にDTMFトーンを送信するための`post_dial_digits`をサポートしました。静的な値または動的変数として設定できます。
- **エージェントテストのタイプ**：エージェントテストで、専用スキーマを持つ3種類のテストをサポートしました：`llm`（応答評価）、`tool`（ツール呼び出し検証）、`simulation`（会話全体のシミュレーション）。シミュレーションテストには、`simulation_scenario`および`simulation_max_turns`設定フィールドがあります。

### 発音辞書

- **APIレスポンス内のルール**：[発音辞書を取得](/docs/ja/api-reference/pronunciation-dictionaries/get)エンドポイントが、完全なルール詳細を含む`rules`配列を返すようになりました。レスポンスでは、新しい`GetPronunciationDictionaryWithRulesResponseModel`スキーマと、ルールタイプ用の`PronunciationDictionaryAliasRuleResponseModel`および`PronunciationDictionaryPhonemeRuleResponseModel`を使用します。

### ナレッジベース

- **フォルダの削除**：[ナレッジベースドキュメントを削除](/docs/ja/api-reference/knowledge-base/delete)エンドポイントで、ドキュメントに加えてフォルダも削除できるようになりました。フォルダを削除する際は、`force=true`を設定すると、含まれるすべてのドキュメントとサブフォルダを再帰的に削除できます。

### SDKリリース

#### Python SDK

- [v2.36.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.36.0) - 会話ユーザーエンドポイント、エージェントのバージョン管理、ドキュメント検索ツール、MCPツールのサポート、コンテンツガードレール、エージェントテストのタイプを追加

#### JavaScript SDK

- [v2.36.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.36.0) - リクエストパラメータに応じた型推論を改善するため、`speechToText.convert()`にオーバーロードされた`convert`シグネチャを追加しました（手動で型を絞り込まなくても`.text`、`.transcripts`、Webhookフィールドにアクセス可能）。会話ユーザーエンドポイント、エージェントのバージョン管理、ドキュメント検索ツール、MCPツールのサポート、コンテンツガードレール、エージェントテストのタイプも追加しました。

#### ウィジェットパッケージ

- [@elevenlabs/convai-widget-core@0.9.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.9.0) - エージェントのツール使用状況表示と長時間実行されるツール呼び出し用の新しいステータスバッジを追加し、感情タグの除去、署名付きURLによるウィジェット埋め込みでの評価とフィードバック送信を修正
- [@elevenlabs/convai-widget-embed@0.9.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.9.0) - エージェントのツール使用状況表示と長時間実行されるツール呼び出し用の新しいステータスバッジを追加し、感情タグの除去を修正

### API

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

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

- [会話ユーザーを取得](/docs/ja/api-reference/users/list) - `GET /v1/convai/users` - エージェントと会話したユーザーを一覧表示

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

### ElevenAgents

- [エージェントを取得](/docs/ja/api-reference/agents/get)
  - 特定のエージェントバージョンを取得するための`version_id`クエリパラメータ（string、省略可）を追加
  - 特定のブランチから取得するための`branch_id`クエリパラメータ（string、省略可）を追加
- [エージェントを更新](/docs/ja/api-reference/agents/update)
  - ブランチ固有の更新用に`branch_id`クエリパラメータ（string、省略可）を追加
- [エージェントを作成](/docs/ja/api-reference/agents/create)
  - 複数ソースRAG設定を備えた`search_documentation`をシステムツールに追加
  - ツール判別子に`mcp`ツールタイプを追加
  - コンテンツモデレーション用ガードレールの`content`フィールドを`GuardrailsV1`に追加
  - エージェント設定に`expressive_mode`フィールド（boolean）を追加
- [エージェントテストを作成](/docs/ja/api-reference/tests/create)、[エージェントテストを更新](/docs/ja/api-reference/tests/update)、[エージェントテストを取得](/docs/ja/api-reference/tests/get)
  - `type`フィールド（`llm`、`tool`、`simulation`）を持つ判別共用体スキーマに変更
  - シミュレーションテスト用に`simulation_scenario`および`simulation_max_turns`フィールドを追加

### 発音辞書

- [発音辞書を取得](/docs/ja/api-reference/pronunciation-dictionaries/get)
  - レスポンススキーマを、`rules`配列を持つ`GetPronunciationDictionaryWithRulesResponseModel`に変更

### ナレッジベース

- [ナレッジベースドキュメントを削除](/docs/ja/api-reference/knowledge-base/delete)
  - 再帰的なフォルダ削除を含むよう`force`パラメータの説明を更新

## スキーマの変更

### 新しいスキーマ

- `GetPronunciationDictionaryWithRulesResponseModel` - ルール配列を埋め込んだレスポンスモデル
- `PronunciationDictionaryAliasRuleResponseModel` - `string_to_replace`および`alias`を持つエイリアスルール
- `PronunciationDictionaryPhonemeRuleResponseModel` - `string_to_replace`、`phoneme`、`alphabet`を持つ音素ルール
- `MultiSourceConfigJson` - 複数ソースRAG設定
- `SourceConfigJson` - RAG用の個別ソース設定
- `SourceRetrievalConfig` - RAGソースの検索設定
- `MergingStrategy` - RAG結果のマージ戦略用列挙型
- `MCPToolConfig` - MCPツールの設定
- `ContentGuardrail-Input`、`ContentGuardrail-Output` - コンテンツモデレーション用ガードレール設定
- `ContentConfig` - コンテンツカテゴリのしきい値設定
- `TestType` - `llm`、`tool`、`simulation`の値を持つ列挙型
- `CreateAgentTestResponseModel` - テスト作成時のレスポンス
- `LLMResponseTest*`、`ToolCallTest*`、`SimulationTest*` - 旧`Create/Get/UpdateUnitTest*`モデルに代わるタイプ別テストスキーマ

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

- `GuardrailsV1-Input`、`GuardrailsV1-Output` - コンテンツガードレール用の`content`フィールドを追加
- `AgentConfig` - `expressive_mode`フィールド（boolean）を追加
- `PhoneNumberTransferConfig` - `post_dial_digits`フィールド（文字列または動的変数）を追加
- `DistributionTerritories` - 任意の地域文字列を許可するためitems制約を緩和

</Accordion>