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を指定できます。
  • フォルダー対応のエージェントテスト:エージェントテストの一覧エンドポイントが、テストをフォルダーに整理できるようになりました。フィルタリングした一覧表示用に、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発信通話リクエスト本文に、発信通話の録音を有効にする任意のcall_recording_enabledフィールドを追加しました。

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

発音辞書

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

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

音楽

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

  • 発音名のサポート:音楽を生成、詳細な音楽生成、音楽をストリーミングエンドポイントにuse_phonetic_namesパラメーターを追加しました。

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

オーディオネイティブ

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

音声

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

SDKリリース

JavaScript SDK

  • v2.37.0 - 音楽生成レスポンスでsong_idを返すサポートを追加しました。Fernの再生成による最新のAPIスキーマ変更を反映しました。

Python SDK

  • v2.37.0 - 新しい音楽生成パラメーターと、音楽生成レスポンスでのsong_id表示をサポートしました。Fernの再生成による最新のAPIスキーマ変更を反映しました。

パッケージ

  • @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 - 文字起こしおよびストリーミングコールバックにevent_idを伝播しました。ツールステータスの追跡をインライン文字起こしエントリにリファクタリングしました。
  • @elevenlabs/types@0.6.0 - 文字起こしおよびストリーミングコールバックにevent_idを伝播しました。

API

新しいエンドポイント

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

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

ElevenAgents

  • エージェントテストの一覧

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

    • テストをフォルダーに割り当てるparent_folder_idフィールド(string、任意)を追加
  • エージェントを作成、エージェントを更新、エージェントを取得

    • 会話後の要約言語用に、エージェント設定へ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発信通話

    • 発信Twilio通話の録音を有効にするcall_recording_enabledフィールド(boolean、任意)を追加
  • WhatsAppアカウントを更新

    • アカウントのメッセージングを有効または無効にするenable_messagingフィールド(boolean、任意)を追加
  • Webhookを更新

    • Webhookペイロードスキーマをカスタマイズするschema_overridesフィールド(object、任意)を追加

発音辞書

音楽

音声

スキーマの変更

新しいスキーマ

  • 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 - フォルダーメタデータフィールドを追加:エンティティタイプ、親パス、子要素数