Changelog

January 5, 2026

智能体平台

  • Twilio／SIP Webhook 中的对话 ID：在为 Twilio、SIP 和 WhatsApp 集成获取对话发起客户端数据时，Webhook 负载现会包含 conversation_id。无需轮询 API 获取对话 ID，即可实现实时监控。
  • 智能体版本控制字段：智能体响应模型现包含 version_id、branch_id 和 main_branch_id 字段（可为空的字符串），用于跟踪智能体版本和分支。
  • 对话版本跟踪：对话模型新增 version_id 字段，用于标识每段对话所使用的智能体版本。
  • 批量通话增强：BatchCallRecipientStatus 枚举现包含 dispatched 状态，批量通话响应包含 total_calls_finished 字段，并优化了跟踪相关的默认值。

音色

  • 集合 ID：音色模型现包含 collection_ids 字段（字符串数组，可为空），用于表明音色所属的集合。
  • 音色类型筛选扩展：GET /v2/voices 端点现支持将 saved 作为 voice_type 筛选值，用于获取已添加到集合中的非默认音色。

SDK 发布

Python SDK

  • v2.28.0 - 更新 API 架构，加入智能体版本控制字段、音色集合 ID、批量通话增强和电话号码标签

JavaScript SDK

  • v2.29.0 - 更新 API 架构，加入智能体版本控制字段、音色集合 ID、批量通话增强和电话号码标签

API

更新的端点

音色

  • 获取所有音色 v2
    • 为 voice_type 查询参数新增 saved 选项，用于筛选已添加到集合的音色

智能体平台

  • 获取智能体、更新智能体
    • 新增 version_id（字符串，可为空），用于标识智能体版本
    • 新增 branch_id（字符串，可为空），用于标识智能体分支
    • 新增 main_branch_id（字符串，可为空），用于引用主分支
  • 获取对话
    • 新增 version_id（字符串，可为空），说明为“此对话所使用的智能体版本 ID”
  • 获取批量通话、提交批量通话
    • 在批量通话响应模型中新增 total_calls_finished（整数，默认 0）
    • 扩展 BatchCallRecipientStatus 枚举，加入 dispatched 状态
    • 将视频资源的 signed_url 设为可为空

电话号码

  • 更新电话号码
    • 新增可选 label 字段（字符串，可为空），用于标记电话号码