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 返回

音色

• 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

• 智能体平台请求和响应设置新增可选且可为 null 的 analysis_items 字段，类型为 AgentAnalysisItems，用于引用式评估和数据收集配置
• 流程引用新增 trigger（字符串）、referenced_tool_ids（字符串数组）、referenced_kb_ids（字符串数组）、referenced_procedure_ids（字符串数组）和 referenced_dynamic_variables（字符串数组）
• KnowledgeBaseRagToolResultModel 新增 chunks（KnowledgeBaseRagChunkModel[]）

Studio

• ProjectCreationMetaResponseModel.status 新增 draft
• ProjectCreationMetaResponseModel.type 现在引用共享的 ProjectCreationMetaType 枚举

工作区

• WebhookUsageType 新增 Flows