Changelog

March 23, 2026

ElevenAgents

  • 環境変数API：エージェントが実行時に{{system_env__<label>}}テンプレートを通じて参照できる、ワークスペースレベルの設定を管理するための新しい環境変数エンドポイント。文字列、シークレット、認証接続の変数タイプと、環境ごとの値のオーバーライドをサポートします。エンドポイントには作成、一覧取得、取得、更新があります。

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

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

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

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

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

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

  • エージェントおよびリソース一覧のフィルター：エージェント一覧、ナレッジベースドキュメント一覧、ツール一覧エンドポイントで、created_by_user_idクエリパラメーター（現在のユーザーには@meを使用）をサポートするようになりました。従来のshow_only_owned_agentsおよびshow_only_owned_documentsパラメーターは非推奨です。

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

音楽

  • 音楽マーケットプレイス：AI生成音楽のライセンスを扱うマーケットプレイスに関する新しい音楽マーケットプレイスドキュメントを追加しました。利用タイプ、クリエイターへの支払い、ライセンスの詳細を含みます。

SDKリリース

Python SDK

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

JavaScript SDK

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

iOS SDK

  • v3.1.1 - 環境固有のエージェント接続向けにenvironmentパラメーターを追加しました。プラットフォーム要件をv2に引き上げ、visionOSのビルドエラーを修正しました。

パッケージ

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

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

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

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

新しいAPIへのコードベース移行をAIコーディングアシスタントが自動で支援するelevenlabs:sdk-migrationスキルを利用できます。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設定は、インポート時に自動適用されます。

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

API

新しいエンドポイント

ElevenAgents

  • 環境変数を作成 - POST /v1/convai/environment-variables - 文字列、シークレット、または認証接続タイプの新しい環境変数を作成
  • 環境変数を一覧取得 - GET /v1/convai/environment-variables - ワークスペース内のすべての環境変数を一覧取得
  • 環境変数を取得 - GET /v1/convai/environment-variables/{env_var_id} - 特定の環境変数を取得
  • 環境変数を更新 - PATCH /v1/convai/environment-variables/{env_var_id} - nullによる環境ごとの値の削除を含め、環境変数を更新
  • URLドキュメントのコンテンツを更新 - 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

スキーマの変更

新しいスキーマ

  • 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 - 複数の会話およびテレフォニーモデルから参照される共有列挙型にリファクタリング