> 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

- **環境変数API**：エージェントが実行時に`{{system_env__<label>}}`テンプレートを通じて参照できる、ワークスペースレベルの設定を管理するための新しい[環境変数](/docs/ja/eleven-agents/integrate/environment-variables)エンドポイント。文字列、シークレット、認証接続の変数タイプと、環境ごとの値のオーバーライドをサポートします。エンドポイントには[作成](/docs/ja/api-reference/environment-variables/create)、[一覧取得](/docs/ja/api-reference/environment-variables/list)、[取得](/docs/ja/api-reference/environment-variables/get)、[更新](/docs/ja/api-reference/environment-variables/update)があります。

- **認証接続の管理**：エージェントツールやインテグレーションで使用する認証情報を管理するための、新しいワークスペースレベルの認証接続API。OAuth2クライアント認証情報、JWT、基本認証、Bearerトークン、カスタムヘッダー、インテグレーション管理のOAuth2認可コードフローなど、複数の認証方式をサポートします。作成、一覧取得、削除操作を利用できます。

- **ナレッジベースURLの更新**：URL由来のナレッジベースドキュメントのコンテンツを再取得して更新するための新しい[更新](/docs/ja/api-reference/knowledge-base/refresh)エンドポイント（`POST /v1/convai/knowledge-base/{documentation_id}/refresh`）。ナレッジベースドキュメントでは、`enable_auto_sync`、`auto_remove`、`auto_sync_info`フィールドによる自動同期設定もサポートされるようになりました。

- **フィードバック付きガードレール再試行**：カスタムおよびコンテンツガードレールで、`EndCallTriggerAction`と`RetryTriggerAction`オプションを使った設定可能な[トリガーアクション](/docs/ja/eleven-agents/best-practices/guardrails)をサポートするようになりました。再試行に設定すると、エージェントはシステムフィードバックを追加して、最大3回まで応答を再生成します。状況に応じた再試行ガイダンスには、`{{trigger_reason}}`と`{{agent_message}}`のプレースホルダーを使用できます。

- **会話履歴システム変数**：実行時に遅延評価されたJSONシリアライズ済みの会話履歴を提供する、新しい`system__conversation_history`動的変数を追加しました。会話全体のコンテキストをツール、Webhook、またはサブエージェントへの引き継ぎに渡す際に便利です。

- **Webhookツールのコンテンツタイプ**：サーバーツールでWebhook本文パラメーターの設定可能な[コンテンツタイプ](/docs/ja/eleven-agents/customization/tools/server-tools)をサポートし、`application/json`と`application/x-www-form-urlencoded`形式から選択できるようになりました。URLエンコード形式は、レガシーシステム、OAuthトークンエンドポイント、決済処理サービスとのインテグレーションに便利です。

- **WhatsApp送信メッセージ**：WhatsAppインテグレーションを更新し、ダッシュボードに新しい[送信メッセージダイアログ](/docs/ja/eleven-agents/whatsapp)を追加しました。エージェントはWhatsAppチャネルを通じて通話に加え、送信メッセージも送れるようになりました。

- **エージェントおよびリソース一覧のフィルター**：[エージェント一覧](/docs/ja/api-reference/agents/list)、[ナレッジベースドキュメント一覧](/docs/ja/api-reference/knowledge-base/list)、[ツール一覧](/docs/ja/api-reference/tools/list)エンドポイントで、`created_by_user_id`クエリパラメーター（現在のユーザーには`@me`を使用）をサポートするようになりました。従来の`show_only_owned_agents`および`show_only_owned_documents`パラメーターは非推奨です。

- **ワークフロー条件式**：ワークフロー式スキーマに新しい`conditional_operator` ASTノードを追加し、エージェントワークフロー定義内での分岐ロジックを可能にしました。

### 音楽

- **音楽マーケットプレイス**：AI生成音楽のライセンスを扱うマーケットプレイスに関する新しい[音楽マーケットプレイス](/docs/ja/overview/capabilities/music/marketplace)ドキュメントを追加しました。利用タイプ、クリエイターへの支払い、ライセンスの詳細を含みます。

### SDKリリース

#### Python SDK

- [v2.40.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.40.0) - ElevenAgentsの会話で`environment`パラメーターをサポートし、環境固有のエージェント接続を可能にしました。環境変数、認証接続、ナレッジベース更新、ガードレールトリガーアクションを含む最新のAPIスキーマに合わせてFernを再生成しました。

#### JavaScript SDK

- [v2.40.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.40.0) - ElevenAgentsのリアルタイム会話向けに`multimodal_message` WebSocketイベントタイプを追加しました。環境変数、認証接続、ナレッジベース更新、ガードレールトリガーアクションを含む最新のAPIスキーマに合わせてFernを再生成しました。

#### iOS SDK

- [v3.1.1](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.1.1) - 環境固有のエージェント接続向けに`environment`パラメーターを追加しました。プラットフォーム要件をv2に引き上げ、visionOSのビルドエラーを修正しました。

#### パッケージ

- [@elevenlabs/types@0.6.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/types@0.6.1) - ElevenAgentsのリアルタイム会話向けに`multimodal_message` WebSocketイベントタイプを追加しました。
- [@elevenlabs/client@0.15.2](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@0.15.2) - `multimodal_message` WebSocketイベントのサポートを追加しました。
- [@elevenlabs/react@0.14.3](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@0.14.3) - `multimodal_message` WebSocketイベントのサポートを追加しました。
- [@elevenlabs/convai-widget-core@0.10.4](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.10.4), [@elevenlabs/convai-widget-core@0.10.5](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-core@0.10.5) - `@elevenlabs/client@0.15.2`に更新しました。
- [@elevenlabs/convai-widget-embed@0.10.4](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.10.4), [@elevenlabs/convai-widget-embed@0.10.5](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/convai-widget-embed@0.10.5) - `@elevenlabs/client@0.15.2`に更新しました。

#### パッケージv1.0.0リリース候補版

ElevenAgentsクライアントSDKのv1.0.0初のリリース候補版が利用可能になりました。これはAPIの使用感を改善し、レンダリングパフォーマンスを高める細分化されたReactフックを追加し、React Native SDKとReact SDKを統一する破壊的変更を含むメジャーリリースです。

リリース候補版を試すには：

```bash
npm install @elevenlabs/client@next @elevenlabs/react@next @elevenlabs/react-native@next
```

新しいAPIへのコードベース移行をAIコーディングアシスタントが自動で支援する[`elevenlabs:sdk-migration`](https://github.com/elevenlabs/packages/blob/main/.agents/skills/elevenlabs%3Asdk-migration/SKILL.md)スキルを利用できます。Claude Code、Cursor、またはWindsurfのプロジェクトに追加すると、ガイド付きの移行サポートを受けられます。

v1.0.0の主な変更点：

- **`@elevenlabs/client`**：`Conversation`はクラスではなく、名前空間オブジェクトおよび`TextConversation | VoiceConversation`の型エイリアスになりました。`Input`クラスと`Output`クラスは`InputController`および`OutputController`インターフェースに置き換えられ、会話インスタンスには新しい便利なメソッド（`setMicMuted()`、`setVolume()`、`getInputByteFrequencyData()`、`getOutputByteFrequencyData()`）が追加されました。`changeInputDevice()`と`changeOutputDevice()`は`void`を返すようになりました。
- **`@elevenlabs/react`**：`useConversation`に`ConversationProvider`の親要素が必要になりました。細かい再レンダリングのための新しい細分化フック：`useConversationControls()`、`useConversationStatus()`、`useConversationInput()`、`useConversationMode()`、`useConversationFeedback()`。Reactコンポーネントから完全な型安全性を保ってクライアントツールを動的に登録できる、新しい`useConversationClientTool()`フックも追加しました。
- **`@elevenlabs/react-native`**：`ElevenLabsProvider`と`useConversation`を、`ConversationProvider`および`@elevenlabs/react`と同じ細分化フックに置き換える完全なAPI書き換えを行いました。WebRTCポリフィルとネイティブAudioSession設定は、インポート時に自動適用されます。

完全なリリースノートと移行ガイド：

- [@elevenlabs/client@1.0.0-rc.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/client@1.0.0-rc.1)
- [@elevenlabs/react@1.0.0-rc.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react@1.0.0-rc.1)
- [@elevenlabs/react-native@1.0.0-rc.1](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/react-native@1.0.0-rc.1)
- [@elevenlabs/types@0.7.0-rc.0](https://github.com/elevenlabs/packages/releases/tag/@elevenlabs/types@0.7.0-rc.0)

### API

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

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

### ElevenAgents

- [環境変数を作成](/docs/ja/api-reference/environment-variables/create) - `POST /v1/convai/environment-variables` - 文字列、シークレット、または認証接続タイプの新しい環境変数を作成
- [環境変数を一覧取得](/docs/ja/api-reference/environment-variables/list) - `GET /v1/convai/environment-variables` - ワークスペース内のすべての環境変数を一覧取得
- [環境変数を取得](/docs/ja/api-reference/environment-variables/get) - `GET /v1/convai/environment-variables/{env_var_id}` - 特定の環境変数を取得
- [環境変数を更新](/docs/ja/api-reference/environment-variables/update) - `PATCH /v1/convai/environment-variables/{env_var_id}` - `null`による環境ごとの値の削除を含め、環境変数を更新
- [URLドキュメントのコンテンツを更新](/docs/ja/api-reference/knowledge-base/refresh) - `POST /v1/convai/knowledge-base/{documentation_id}/refresh` - URL由来のナレッジベースドキュメントのコンテンツを再取得

### ワークスペース

- `POST /v1/workspace/auth-connections` - OAuth2、JWT、基本認証、Bearer、カスタムヘッダー、インテグレーション管理の認証方式をサポートするワークスペース認証接続を作成
- `GET /v1/workspace/auth-connections` - 依存関係情報（ツール、MCPサーバー、インテグレーション接続）を含むすべてのワークスペース認証接続を一覧取得
- `DELETE /v1/workspace/auth-connections/{auth_connection_id}` - ワークスペース認証接続を削除

### スピーチtoテキスト

- `GET /v1/speech-to-text/evaluation/eval-criteria` - 評価基準を一覧取得
- `POST /v1/speech-to-text/evaluation/eval-criteria` - 評価基準を作成
- `GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}` - 特定の評価基準を取得
- `PATCH /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}` - 評価基準を更新
- `DELETE /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}` - 評価基準を削除
- `POST /v1/speech-to-text/evaluation/evaluations` - 評価を実行
- `GET /v1/speech-to-text/evaluation/evaluations` - 評価を一覧取得
- `GET /v1/speech-to-text/evaluation/evaluations/{evaluation_id}` - 特定の評価を取得
- `GET /v1/speech-to-text/evaluation/human-agents` - 人間のエージェントを一覧取得
- `GET /v1/speech-to-text/evaluation/human-agents/{agent_id}` - 人間のエージェントを取得
- `DELETE /v1/speech-to-text/evaluation/human-agents/{agent_id}` - 人間のエージェントを削除
- `GET /v1/speech-to-text/evaluation/analytics` - 評価分析を取得
- `GET /v1/speech-to-text/evaluation/eval-criteria/{criterion_id}/analytics` - 特定の基準の分析を取得
- `GET /v1/speech-to-text/evaluation/human-agents/{agent_id}/analytics` - 特定の人間のエージェントの分析を取得

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

### ElevenAgents

- [署名付きURLを取得](/docs/ja/api-reference/conversations/get-signed-url)、[会話トークンを取得](/docs/ja/api-reference/conversations/get-webrtc-token)

  - 環境固有の解決のために`environment`クエリパラメーター（文字列、任意）を追加

- [エージェント一覧](/docs/ja/api-reference/agents/list)

  - `created_by_user_id`クエリパラメーター（文字列、任意、`@me`をサポート）を追加
  - `show_only_owned_agents`を非推奨とし、`created_by_user_id`を推奨

- [ナレッジベースドキュメント一覧](/docs/ja/api-reference/knowledge-base/list)

  - `created_by_user_id`クエリパラメーター（文字列、任意、`@me`をサポート）を追加
  - `show_only_owned_documents`を非推奨とし、`created_by_user_id`を推奨

- [ツール一覧](/docs/ja/api-reference/tools/list)

  - `created_by_user_id`クエリパラメーター（文字列、任意、`@me`をサポート）を追加
  - `show_only_owned_documents`を非推奨とし、`created_by_user_id`を推奨

- [ナレッジベースチャンクを取得](/docs/ja/api-reference/knowledge-base/get-chunk)

  - チャンク取得時の埋め込みモデルを指定するための`embedding_model`クエリパラメーター（文字列、任意）を追加

- [エージェントを作成](/docs/ja/api-reference/agents/create)、[エージェントを更新](/docs/ja/api-reference/agents/update)、[下書きを作成](/docs/ja/api-reference/agents/drafts/create)

  - `EndCallTriggerAction`および`RetryTriggerAction`スキーマを含む`guardrail_trigger_action`のサポートを追加
  - ワークフロー式定義に`conditional_operator` ASTノードを追加
  - エージェントスキーマで、ツール設定内の環境変数を参照するための`ConvAIEnvVarLocator`および`EnvironmentAuthConnectionLocator`をサポート

- [SIPトランク発信通話](/docs/ja/api-reference/sip-trunk/outbound-call)

  - 新しい環境関連フィールドに対応するようリクエストスキーマを更新

- [会話をシミュレート](/docs/ja/api-reference/agents/simulate-conversation)、[会話ストリームをシミュレート](/docs/ja/api-reference/agents/simulate-conversation-stream)

  - リクエストスキーマに`simulation_environment`フィールドを追加

## スキーマの変更

### 新しいスキーマ

- `ConvAIEnvironmentVariable`、`ConvAIEnvironmentVariableCreate`、`ConvAIEnvironmentVariableUpdate` - 文字列、シークレット、認証接続タイプをサポートする環境変数モデル
- `ConvAIEnvVarLocator`、`EnvironmentAuthConnectionLocator` - ツールおよびMCPサーバー設定で環境変数を参照するためのロケーター
- `EndCallTriggerAction`、`RetryTriggerAction` - 通話終了およびフィードバック付き再試行の動作に対応するガードレールトリガーアクションスキーマ
- `ConditionalOperator` - エージェントワークフローの条件式用の新しいASTノード
- `AuthConnectionCreateRequest`、`AuthConnectionResponse`、`AuthConnectionDependencies` - OAuth2、JWT、基本認証、Bearer、カスタムヘッダー、WhatsApp、インテグレーション管理の認証方式をサポートするワークスペース認証接続管理スキーマ
- `SpeechToTextEvaluation*` - スピーチtoテキストの評価基準、評価、人間のエージェント、分析のためのスキーマ群

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

- `MCPServerConfig`、`MCPServerConfigOutput` - サーバー設定における`ConvAIEnvVarLocator`参照のサポートを追加
- `CustomGuardrailConfig` - 通話終了または再試行動作を設定するための`trigger_action`フィールドを追加
- `Contributor` - 任意の`bio`（文字列）および`profile_id`（文字列）フィールドを追加
- `ASTLLMNode` - `value_schema`フィールドを追加。`prompt`フィールドは非推奨となり、`value_schema`を推奨
- `TelephonyDirection` - 複数の会話およびテレフォニーモデルから参照される共有列挙型にリファクタリング

</Accordion>