> 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)ページを、すべてのワークスペースで利用できるようになりました。エージェントとやり取りしたすべてのユーザー、その会話履歴、連絡先情報を統合ビューで確認できます。

- **SIP受信ヘッダーを動的変数として利用**：受信SIPトランキング通話のカスタムSIP `X-`ヘッダーが、ElevenAgentsの会話で動的変数として自動的に公開されるようになりました。発信者から渡される任意のカスタムSIPヘッダー（例：`X-Contact-ID`、`X-Campaign-ID`）は、エージェントプロンプト内で`{{sip_contact_id}}`、`{{sip_campaign_id}}`などとして使用できます。これらの変数は、会話履歴の「Phone Call」タブでも確認できます。`X-Call-ID`や`X-Caller-ID`などの予約済みヘッダーは、引き続き`system__call_sid`および`system__caller_id`にマッピングされ、上書きされません。

- **ツール実行結果による会話のフィルタリング**：[会話一覧](/docs/ja/api-reference/conversations/list)および[会話のテキスト検索](/docs/ja/api-reference/conversations/messages/text-search)エンドポイントで、`tool_names_successful`および`tool_names_errored`クエリパラメーター（文字列の配列）を受け付けるようになりました。通話中に成功したツールまたはエラーを返したツールに基づいて、会話をフィルタリングできます。

- **ユーザー一覧の改善**：[ユーザー一覧](/docs/ja/api-reference/users/list)エンドポイントで、`last_contact_unix_secs`（デフォルト）または`conversation_count`を受け付ける`sort_by`クエリパラメーターと、エージェントブランチでユーザーをフィルタリングする`branch_id`クエリパラメーターをサポートしました。

- **ツールの強制削除**：[ツールを削除](/docs/ja/api-reference/tools/delete)エンドポイントで、`force`クエリパラメーター（ブール値、デフォルトは`false`）を受け付けるようになりました。`true`に設定すると、エージェントで使用中のツールも削除され、依存しているすべてのエージェントとブランチから自動的に削除されます。

- **会話埋め込みの保持期間**：[ElevenAgents設定](/docs/ja/api-reference/workspace/get)のレスポンスに、会話埋め込みを保持する期間を制御する`conversation_embedding_retention_days`が追加されました（最大365日）。`null`の場合は、システムのデフォルトである30日間が使用されます。

- **コンテンツしきい値ガードレール**：コンテンツモデレーション用に、`is_enabled`フラグと`threshold`値で設定可能なしきい値ベースのガードレールを提供する`ContentThresholdGuardrail`スキーマを追加しました。

### ワークスペース

- **すべてのワークスペースグループを取得**：新しい[GET /v1/workspace/groups](/docs/ja/api-reference/workspace/groups/list)エンドポイントは、各グループの名前、ID、メンバー、権限、使用上限、文字数を含む、ワークスペース内のすべてのグループを返します。

- **ワークスペースへの一括招待でのシートタイプ指定**：[複数ユーザーを招待](/docs/ja/api-reference/workspace/invites/create-batch)エンドポイントで、任意の`seat_type`フィールドを受け付けるようになりました。一括操作で招待するすべてのユーザーのシートタイプ（例：`workspace_member`、`workspace_admin`）を指定できます。

- **モバイルSSOの信頼性向上**：ユーザーがログアウト後に再度サインインしようとすると、モバイルでのSSOログインが「Authenticating...」の画面で停止する不具合を修正しました。また、SAMLまたはOIDCプロバイダー経由でサインインするモバイルSSOユーザーのワークスペース切り替えも修正しました。

### 音楽

- **セクションの長さ制御**：[音楽を詳細に生成](/docs/ja/api-reference/music/compose-detailed)エンドポイントで、`respect_sections_durations`（ブール値）をサポートしました。モデルが構成プラン内の各セクションに指定された長さに従うかどうかを制御できます。

### ElevenCreative Studio

- **チャプターのビジュアルコンテンツ表示**：チャプターレスポンスモデルに、チャプターにビジュアルコンテンツが含まれているかを示す`has_visual_content`ブールフィールドが追加されました。

- **テキストのシャドウとアウトラインスタイル**：ElevenCreative Studioのテキストスタイルで、新しい`StudioTextStyleShadowModel`および`StudioTextStyleOutlineModel`スキーマを通じて`text_shadow`と`text_outline`オプションをサポートしました。ElevenCreative Studioプロジェクト内で、より豊かなテキストのビジュアルカスタマイズが可能になります。

- **メディア生成クリップタスクタイプ**：`PendingClipTask.type`列挙型に`media_generation`値が追加され、メディア生成ワークフローをカバーするようクリップタスクの分類を拡張しました。

### SDKリリース

#### Python SDK

- [v2.39.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.39.0) - ElevenAgentsのリアルタイム会話における`multimodal_message` WebSocketイベントタイプのサポートを追加しました。
- [v2.39.1](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.39.1) - 最新のAPIスキーマに合わせてFernを再生成しました。

#### JavaScript SDK

- [v2.39.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.39.0) - 最新のAPIスキーマに合わせてFernを再生成しました。

#### iOS SDK

- [v3.1.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.1.0) - ElevenAgents Swift SDKを複数改善しました：
  - サーバーエラーが`onError`コールバックを通じて通知されるようになり、エラー処理の一貫性が向上しました。
  - よりクリーンな状態監視のため、イベントベースのエージェント状態管理を追加しました。
  - 音声検出に加えてソフトウェアミュートをサポートし、よりきめ細かなオーディオ制御が可能になりました。
  - コードベース全体でSwift Concurrencyを使用するよう改善しました。
  - iOSリリースビルドで起動中に発生するクラッシュを修正しました。
  - ElevenAgentsのリブランドを反映してブランド表記を更新しました。

#### パッケージ

- [@elevenlabs/client@0.15.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@0.15.1) - 必要なサンプルレートをシステムから取得できない場合に、出力オーディオのリサンプリングを追加しました。デバイス間の互換性が向上します。
- [@elevenlabs/react@0.14.2](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@0.14.2) - `@elevenlabs/client@0.15.1`に依存するよう更新しました。
- [@elevenlabs/convai-widget-core@0.10.3](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.10.3) - `@elevenlabs/client@0.15.1`に依存するよう更新しました。

### API

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

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

- [すべてのワークスペースグループを取得](/docs/ja/api-reference/workspace/groups/list) - `GET /v1/workspace/groups` - メンバー、権限、使用上限を含む、ワークスペース内のすべてのグループを返します。

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

### ElevenAgents

- [会話一覧](/docs/ja/api-reference/conversations/list)

  - 指定したツールの呼び出しが成功した会話をフィルタリングする`tool_names_successful`クエリパラメーター（文字列の配列、任意）を追加
  - 指定したツールがエラーを返した会話をフィルタリングする`tool_names_errored`クエリパラメーター（文字列の配列、任意）を追加

- [会話のテキスト検索](/docs/ja/api-reference/conversations/messages/text-search)

  - `tool_names_successful`クエリパラメーター（文字列の配列、任意）を追加
  - `tool_names_errored`クエリパラメーター（文字列の配列、任意）を追加

- [ユーザー一覧](/docs/ja/api-reference/users/list)

  - `last_contact_unix_secs`（デフォルト）または`conversation_count`を受け付ける`sort_by`クエリパラメーター（文字列、任意）を追加
  - エージェントブランチでユーザーをフィルタリングする`branch_id`クエリパラメーター（文字列、任意）を追加

- [ツールを削除](/docs/ja/api-reference/tools/delete)

  - エージェントへの依存関係にかかわらずツールを削除し、依存するすべてのエージェントとブランチから自動的に削除する`force`クエリパラメーター（ブール値、任意、デフォルトは`false`）を追加

- [ElevenAgents設定を取得](/docs/ja/api-reference/workspace/get)、[ElevenAgents設定を更新](/docs/ja/api-reference/workspace/update)

  - 会話埋め込みの保持期間を設定する`conversation_embedding_retention_days`フィールド（整数、任意、最大365）を追加

### ワークスペース

- [複数ユーザーを招待](/docs/ja/api-reference/workspace/invites/create-batch)

  - 招待するすべてのユーザーのシートタイプを指定する`seat_type`フィールド（文字列、任意）を追加

### 音楽

- [音楽を詳細に生成](/docs/ja/api-reference/music/compose-detailed)

  - モデルが構成プラン内のセクションごとの長さに従うかどうかを制御する`respect_sections_durations`フィールド（ブール値、任意）を追加

### ElevenCreative Studio

- [チャプターを取得](/docs/ja/api-reference/studio/get-chapter)、[チャプターを追加](/docs/ja/api-reference/studio/add-chapter)、[チャプターを更新](/docs/ja/api-reference/studio/update-chapter)

  - チャプターレスポンスモデルに`has_visual_content`フィールド（ブール値）を追加

## スキーマの変更

### 新しいスキーマ

- `ContentThresholdGuardrail` - `is_enabled`（ブール値）および`threshold`（数値、デフォルトは`0.3`）フィールドを持つ、しきい値ベースのコンテンツガードレール
- `AgentPromptChangeToolConfig` - 動的なエージェントプロンプト変更のためのシステムツール設定
- `StudioTextStyleShadowModel` - ElevenCreative Studio用のテキストシャドウスタイル
- `StudioTextStyleOutlineModel` - ElevenCreative Studio用のテキストアウトラインスタイル
- `UsersSortBy` - ユーザー一覧の並べ替えオプション用列挙型：`last_contact_unix_secs`、`conversation_count`
- `VideoAnalysis`、`VideoAnalysisResult`、`VideoKeyMoment`、`VideoSegment`、`VideoSubject`、`VideoTranscription`、`VideoTranscriptionWord` - クリップ処理用のビデオ分析結果スキーマ

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

- `ConversationHistorySIPTrunkingPhoneCallModel` - 受信SIPカスタムX-ヘッダー用の`sip_header_dynamic_variables`フィールドを追加
- `PendingClipTask` - `type`列挙型に`media_generation`を追加

</Accordion>