Changelog

新しいエンドポイント

ElevenAgents

• 会話トリアージチケット用の9つのエンドポイントを追加しました：
  • 会話チケットを作成 - POST /v1/convai/triage-tickets。リクエストにはconversation_id（文字列）が必要で、qa_comment（null許容の文字列、1～10,000文字）と最大200件のターンコメントを受け付けます。
  • チケットを一覧表示 - GET /v1/convai/agents/{agent_id}/triage-tickets。カーソルページネーションに対応しています。
  • 手動チケットを作成 - POST /v1/convai/agents/{agent_id}/triage-tickets。リクエストにはqa_comment（文字列、1～10,000文字）が必要です。
  • 割り当て可能なユーザーを一覧表示 - GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users。レスポンスには、サービスアカウント以外のワークスペースメンバーと、各メンバーがエージェントにアクセスできるかどうかが含まれます。
  • チケットを取得 - GET /v1/convai/triage-tickets/{agentqa_ticket_id}。
  • チケットを更新 - PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}。リクエストでは、任意のstatusとnull許容のassignee_user_idを受け付けます。
  • チケットを削除 - DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}。
  • コメントを追加 - POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments。リクエストにはcomment（文字列、1～10,000文字）が必要です。
  • ターンコメントを追加 - POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments。リクエストには、0始まりのturn_index（整数）とcomment（文字列、1～10,000文字）が必要です。

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

ElevenAgents

• 署名付きURLを取得 - GET /v1/convai/conversation/get-signed-url
  • 任意のdebug_events_request（ブール値、デフォルトはfalse）を追加しました。デバッグイベントには、エージェントへの編集者アクセスが必要です。
• WebRTCトークンを取得 - GET /v1/convai/conversation/token
  • 任意のdebug_events_request（ブール値、デフォルトはfalse）を追加しました。従来のGET /v1/convai/conversation/get_signed_urlルートも同じパラメーターを受け付けます。
• 会話を一覧表示 - GET /v1/convai/conversations
  • 指定したプロシージャのいずれかが実行された会話に一致させる、任意のtriggered_procedure_ids（null許容の文字列配列、最大50件）を追加しました。
  • 実行されなかったツール呼び出しを含めるための、任意のinclude_invalid_tool_calls（ブール値、デフォルトはfalse）を追加しました。
  • 通話開始時刻用の、任意のsort_direction（ascまたはdesc、デフォルトはdesc）を追加しました。
• 会話メッセージをテキスト検索 - GET /v1/convai/conversations/messages/text-search
  • 任意のtriggered_procedure_ids（null許容の文字列配列、最大50件）を追加しました。
  • 任意のinclude_invalid_tool_calls（ブール値、デフォルトはfalse）を追加しました。
• エージェント会話トピックを取得 - GET /v1/convai/agents/{agent_id}/topics
  • 任意のinclude_evaluation_criteria（ブール値、デフォルトはtrue）を追加しました。
  • sort_byにfrustrationを追加しました。
  • トピックレスポンスにnull許容のsuccess_rate（数値）を追加し、全体レスポンスにaggregated_run_count（整数、デフォルトは0）を追加しました。
  • from_unix_secsはUTC日の開始時刻に切り捨てられます。範囲を指定すると、完了した日次ディスカバリー実行を集計します。両方の境界を省略した場合は、最新の実行を返します。
• プロシージャを一覧表示（GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures）およびプロシージャを取得（GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}）
  • 特定のエージェントバージョンからプロシージャを取得するための、任意のnull許容agent_version_id（文字列）を追加しました。
• テストを作成およびテストを更新
  • レスポンス、シミュレーション、ツール呼び出しのユニットテストスキーマに、任意のnull許容environment（文字列）を追加しました。この値は環境固有のURL、ヘッダー、認証接続を選択し、デフォルトはproductionです。
• URLドキュメントを作成、クロールジョブを作成、フォルダーを作成
  • 自動同期用に、任意のnull許容minimum_frequency_days（整数、1～180）を追加しました。デフォルトは7で、より厳しい親フォルダーの頻度が優先されます。

音楽

• 音楽Finetuneを一覧表示 - GET /v1/music/finetunes
  • 最大page_sizeを100から150に増やしました。デフォルトは50のままです。

スキーマの変更

ElevenAgents

• エージェント更新リクエストに、任意のnull許容procedures（object<string, ProcedureVersionRef>）を追加しました。各値にはprocedure_idとversion_id（文字列）が必要です。空のオブジェクトを指定すると、すべてのプロシージャを削除します。
• 会話開始設定にenable_procedure_ids_from_client（ブール値、デフォルトはfalse）を追加しました。開始データには任意のnull許容procedure_ids（文字列配列）を追加しました。空の配列を指定すると、開始エージェントのすべてのプロシージャを無効にします。
• ClientEventにcontext_usageを追加しました。
• ソフトタイムアウトのオーバーライドに、任意のnull許容additional_soft_timeout_messages（文字列配列）を追加しました。
• 分析およびスキーマオーバーライドモデルの定数値がnullを受け付けるようになりました。
• ウィジェット設定のmic_muting_enabledとtranscript_enabledのデフォルトをfalseからtrueに変更しました。以前の動作を維持するには、明示的にfalseに設定してください。

ワークスペース

• ユーザーを取得のレスポンスから、UserResponseModelのxi_api_keyを削除しました。
• ResourceMetadataResponseModel.role_to_group_idsでは、キーをadmin、editor、commenter、viewerに限定せず、カスタムロールIDをキーとして受け付けるようになりました。
• ダイレクトパブリッシングのレスポンスに、任意のnull許容restricted_to_user_email_domains（文字列配列）を追加しました。
• 保留中のサブスクリプション切り替えレスポンスのnext_tierにgoを追加しました。