Changelog

新しいエンドポイント

ElevenAgents

• POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures
  • プロシージャを作成し、procedure_id（文字列）を返します
  • 任意のname（文字列、最大200文字）、content（文字列）、type（ProcedureType、デフォルトはfree_form）、trigger（null許容文字列）を受け付けます
• GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures
  • procedure_id、version_id、name、type、trigger、has_draftを含むブランチのプロシージャを一覧表示します
  • プロシージャの内容は含まれません。内容を読むには個別のプロシージャを取得してください
• GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}
  • 任意のversion_id（文字列）を受け付けます。指定しない場合はブランチ先頭のバージョンを返します
  • name、content、type、triggerを返します
• DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}
  • ブランチのドラフト作業セットからプロシージャを削除します
• GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
  • 現在のプロシージャドラフトを返します
• PATCH /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
  • ドラフトを作成または更新します
  • name（文字列、最大200文字）、content（文字列、最大50,000文字）、type（ProcedureType）が必要です。任意のtrigger（null許容文字列）を受け付けます
• DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft
  • ドラフトの変更を破棄し、プロシージャをコミット済みバージョンにリセットします
• POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/compile
  • プロシージャのドラフトをAgentWorkflowResponseModelにコンパイルします
• クロールジョブを作成 - POST /v1/convai/knowledge-base/crawl
  • url（文字列）が必要です
  • 任意のmax_depth（整数、1～5、デフォルトは3）、max_pages（整数、1～10,000、デフォルトは1000）、pattern（文字列）、sitemap_urls（文字列配列）、parent_folder_id（文字列）、enable_auto_sync（ブール値、デフォルトはfalse）、auto_remove（ブール値、デフォルトはfalse）を受け付けます
• クロールジョブを一覧表示 - GET /v1/convai/knowledge-base/crawl
  • 任意のinclude_job_ids（文字列配列）、page_size（整数、1～100、デフォルトは30）、cursor（文字列）を受け付けます
• クロールジョブを取得 - GET /v1/convai/knowledge-base/crawl/{crawl_job_id}
• クロールジョブをキャンセル - POST /v1/convai/knowledge-base/crawl/{crawl_job_id}/cancel
• 複数のドキュメントに依存するエージェントを取得 - POST /v1/convai/knowledge-base/dependent-agents
  • document_ids（1～20個の一意の文字列の配列）が必要です
  • 任意のdependent_type（KnowledgeBaseDependentType、デフォルトはall）、page_size（整数、1～100、デフォルトは30）、cursor（文字列）を受け付けます
• ナレッジベースドキュメントを一括削除 - POST /v1/convai/knowledge-base/bulk-delete
  • document_ids（1～20個の一意の文字列の配列）が必要です
  • 任意のforce（ブール値、デフォルトはfalse）を受け付けます
  • ドキュメントIDごとに成功または失敗の結果を返します
• バッチ通話結果をエクスポート - GET /v1/convai/batch-calling/{batch_id}/export
  • 終了済みバッチの受信者と会話結果をCSVで返します

Voices

• GET /v1/voices/accents
  • 共有ボイスライブラリで利用可能なアクセントを一覧表示します
  • 任意のlanguage（文字列）およびmodel_id（文字列）クエリパラメーターを受け付けます
  • 各アクセントはaccent、language、code、nameを返します

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

ElevenAgents

• 会話を一覧表示 - GET /v1/convai/conversations
  • 任意のvisited_agent_idsおよびvisited_agent_branch_ids文字列配列フィルターを追加しました。各フィルターは最大50件です
  • 各要約の分析結果を選択するため、任意のdata_collection_idsおよびevaluation_criteria_ids文字列配列を追加しました
  • レスポンスの要約に、任意のオブジェクトフィールドdata_collection_resultsとevaluation_criteria_results、および文字列配列tag_idsを追加しました
• 会話メッセージをテキスト検索 - GET /v1/convai/conversations/messages/text-search
  • 任意のvisited_agent_idsおよびvisited_agent_branch_ids文字列配列フィルターを追加しました。各フィルターは最大50件です
• WebRTCトークンを取得 - GET /v1/convai/conversation/token
  • レスポンスでconversation_id（文字列）が必須になりました
  • 破壊的変更：厳密なレスポンスバリデーターとデシリアライザーは、新しい必須フィールドを受け入れる必要があります

スキーマの変更

ElevenAgents

• エージェントプラットフォームのリクエストおよびレスポンス設定に、参照による評価およびデータ収集設定用の、AgentAnalysisItems型で任意かつnull許容のanalysis_itemsフィールドを追加しました
• プロシージャ参照にtrigger（文字列）、referenced_tool_ids（文字列配列）、referenced_kb_ids（文字列配列）、referenced_procedure_ids（文字列配列）、referenced_dynamic_variables（文字列配列）を追加しました
• KnowledgeBaseRagToolResultModelにchunks（KnowledgeBaseRagChunkModel[]）を追加しました

Studio

• ProjectCreationMetaResponseModel.statusにdraftを追加しました
• ProjectCreationMetaResponseModel.typeが共有ProjectCreationMetaType列挙型を参照するようになりました

Workspaces

• WebhookUsageTypeにFlowsを追加しました