Changelog

January 26, 2026

智能体平台

  • 智能体分支和部署：新增完整的智能体版本控制系统，团队可创建分支、独立迭代智能体配置，并在准备就绪后合并变更。新增端点包括用于创建分支的 POST /v1/convai/agents/{agent_id}/branches、用于合并的 POST /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge，以及用于创建部署的 POST /v1/convai/agents/{agent_id}/deployments。也可通过新的草稿端点创建和删除草稿。详见 分支 和 部署 文档。
  • WhatsApp 账户管理：新增 WhatsApp Business 账户的 PATCH 和 DELETE 端点，可更新和移除智能体上已连接的 WhatsApp 账户。
  • 对话智能体名称：获取对话 端点现会在响应中返回 agent_name，方便识别处理该对话的智能体。
  • 错误类型跟踪：在对话事件模型中新增 error_type 字段，改进调试和错误分类。

知识库

  • 文件夹管理：新增支持将知识库文档整理到文件夹中。新增端点包括用于创建文件夹的 创建文件夹、用于移动单个文档的 移动文档，以及用于一次移动多个文档的 批量移动。

工具

  • 增强工具列表：获取工具 端点现支持通过新增查询参数进行筛选和分页，包括 search、page_size、types、sort_by、sort_direction 和 cursor。响应现包含用于分页的 next_cursor 和 has_more 字段。

音乐

  • 歌曲元数据增强：在歌曲元数据中新增 bpm 和 time_signature 字段，提供更丰富的音频分析信息。

ElevenCreative Studio

  • 字幕样式模板：在项目模型中新增 caption_style_template_overrides 字段，可按模板自定义字幕样式。
  • 视频配音项目类型：在项目创建类型枚举中新增 dub_video。
  • 发布元数据：在发布和项目元数据中新增 last_updated_from_project_unix 时间戳。

工作区

  • 席位类型管理：引入新的 SeatType 枚举以及 seat_type 和 workspace_seat_type 字段，弃用原有的 workspace_permission 和 workspace_role 字段。
  • 工作区分析权限：在 PermissionType 枚举中新增 workspace_analytics_full_read，实现精细化分析访问控制。

SDK 发布

Python SDK

  • v2.32.0 - 新增智能体分支、部署和草稿端点，知识库文件夹管理，支持筛选和分页的增强工具列表，以及席位类型管理

JavaScript SDK

  • v2.33.0 - 新增智能体分支、部署和草稿端点，知识库文件夹管理，支持筛选和分页的增强工具列表，以及席位类型管理

API

新增端点

  • 列出智能体分支 - GET /v1/convai/agents/{agent_id}/branches - 列出智能体的所有分支
  • 创建智能体分支 - POST /v1/convai/agents/{agent_id}/branches - 为智能体创建新分支
  • 获取智能体分支 - GET /v1/convai/agents/{agent_id}/branches/{branch_id} - 获取特定分支
  • 更新智能体分支 - PATCH /v1/convai/agents/{agent_id}/branches/{branch_id} - 更新分支配置
  • 合并智能体分支 - POST /v1/convai/agents/{agent_id}/branches/{source_branch_id}/merge - 将分支合并到目标分支
  • 创建部署 - POST /v1/convai/agents/{agent_id}/deployments - 创建或更新智能体部署
  • 创建草稿 - POST /v1/convai/agents/{agent_id}/drafts - 创建智能体草稿
  • 删除草稿 - DELETE /v1/convai/agents/{agent_id}/drafts - 删除智能体草稿
  • 创建文件夹 - POST /v1/convai/knowledge-base/folder - 创建用于归类文档的文件夹
  • 移动文档 - POST /v1/convai/knowledge-base/{document_id}/move - 将文档移动到文件夹
  • 批量移动 - POST /v1/convai/knowledge-base/bulk-move - 将多个文档移动到文件夹

更新的端点

智能体平台

  • 获取工具
    • 新增 search 查询参数（字符串，可选），可按名称前缀筛选工具
    • 新增 page_size 查询参数（整数，可选，最大值 100，默认值 30）
    • 新增 show_only_owned_documents 查询参数（布尔值，可选，默认值 false）
    • 新增 types 查询参数（数组，可选），可按工具类型筛选
    • 新增 sort_by 查询参数（枚举，可选），用于排序结果
    • 新增 sort_direction 查询参数（枚举，可选），用于指定排序顺序
    • 新增 cursor 查询参数（字符串，可选），用于分页
    • 响应现包含 next_cursor（字符串）和 has_more（布尔值，必填）字段
  • 创建智能体
    • 请求架构已更新，支持分支
  • 获取对话
    • 在响应模型中新增 agent_name（字符串，可选）
  • 创建智能体草稿
    • 将 tags 字段设为可选，并从必填字段中移除

发音词典

  • 添加规则
    • 更新说明，明确具有重复 string_to_replace 值的规则将被替换

工作区

ElevenCreative Studio

  • 创建项目
    • 新增 create_publishing_read（布尔值，可选）字段
    • 在项目类型枚举中新增 dub_video
  • 获取项目、更新项目
    • 新增 caption_style_template_overrides（对象，可选），用于自定义字幕样式

架构变更

新增架构

  • AgentBranch、AgentBranchInput、AgentBranchOutput - 智能体分支配置
  • AgentDeployment、AgentDeploymentInput - 智能体部署配置
  • AgentVersion - 智能体版本信息
  • BranchProtectionStatus - 分支保护设置
  • SeatType - 工作区席位类型的枚举
  • ToolSortBy - 工具排序选项的枚举
  • ToolTypeFilter - 按类型筛选工具的枚举
  • CaptionStyleModel - 字幕样式配置

修改的架构

  • ToolsResponseModel - 新增用于分页的 next_cursor 和 has_more 字段
  • SongMetadata - 新增 bpm（数字）和 time_signature（字符串）字段
  • GetConversationResponseModel - 新增 agent_name 字段
  • PermissionType - 新增 workspace_analytics_full_read 枚举值
  • ProjectCreationType - 新增 dub_video 枚举值
  • 多个事件模型 - 新增用于错误分类的 error_type 字段