Changelog

October 7, 2025

智能体平台

  • Gemini 2.5 Flash Preview 模型：新增支持 gemini-2.5-flash-preview-09-2025 和 gemini-2.5-flash-lite-preview-09-2025 LLM 模型，可使用 Google Gemini 2.5 Flash 模型最新的 2025 年 9 月预览版本。
  • Claude Sonnet 4.5：新增支持 claude-sonnet-4-5 和 claude-sonnet-4-5@20250929 模型，可使用 2025 年 9 月 29 日发布的最新 Claude Sonnet 4.5 模型。
  • 测试调用列表：新增 GET /v1/convai/test-invocations 端点，支持通过分页列出所有测试调用。包括 agent_id 筛选器、page_size 参数（默认 30，最大 100）及用于分页的 cursor。响应包含测试运行次数、通过/失败统计和标题。
  • 智能体归档：在智能体平台设置中新增 archived 字段（布尔值，默认 false），可在不删除智能体的情况下将其归档，并将其排除在活跃智能体列表之外。
  • MCP Server 中断控制：在 MCP server 配置中新增 disable_interruptions 字段（布尔值，默认 false），可防止用户在工具执行期间中断，提高工具完成的可靠性。
  • 流式智能体响应：新增 agent_chat_response_part WebSocket 事件类型，可在流式对话期间实时接收部分智能体聊天响应。
  • 工作流边顺序：为所有工作流节点类型新增 edge_order 字段（字符串数组），可明确控制边的评估顺序，实现确定性的工作流执行。
  • 测试套件智能体跟踪：在测试调用响应中新增 agent_id 字段（字符串，可为空），用于将测试运行与特定智能体关联。

声音管理

  • 声音生成来源跟踪：在 History API 中新增 VoiceGeneration 来源类型，用于跟踪通过声音生成功能生成的音频。

电话通信

  • SIP 中继 TLS 验证：在 SIP 中继配置中新增 remote_domains 字段（字符串数组，可为空），用于指定 TLS 证书验证所使用的域名。

SDK 发布

JavaScript SDK

  • v2.18.0 - 已更新至 2025 年 10 月 8 日最新的 API 架构变更

Python SDK

  • v2.17.0 - 已更新最新 API 架构变更，以及 2025 年 10 月 6 日的 URL 生成功能修复

软件包

所有软件包均已更新至最新 API 架构变更：

MCP Server

  • v0.9.0 - 新增选项，可将 MCP server 结果作为资源项返回，以便更好地集成基于资源的工作流

API

新增端点

智能体平台

  • GET /v1/convai/test-invocations - 支持通过分页列出所有测试调用
    • 参数：
      • agent_id（必填，字符串）- 按智能体 ID 筛选
      • page_size（可选，整数，default=30，max=100）- 每页结果数
      • cursor（可选，字符串）- 来自上一响应的分页游标
    • 响应： 返回包含测试运行次数、通过/失败统计、标题和下一游标的分页列表

新增字段

智能体平台

  • 智能体设置：在 AgentPlatformSettingsRequestModel 和 AgentPlatformSettingsResponseModel 中新增 archived 字段（布尔值，默认 false），用于归档智能体
  • MCP Servers：在 MCP server 配置架构中新增 disable_interruptions 字段（布尔值，默认 false），用于防止工具执行期间的用户中断
  • 工作流：为所有工作流节点类型新增 edge_order 字段（字符串数组），用于明确边的评估顺序
  • 测试调用：在 GetTestSuiteInvocationResponseModel 中新增 agent_id 字段（字符串，可为空），用于智能体跟踪

电话通信

  • SIP 中继：在 GetPhoneNumberInboundSIPTrunkConfigResponseModel 和 InboundSIPTrunkConfigRequestModel 中新增 remote_domains 字段（字符串数组，可为空），用于 TLS 证书验证

WebSocket 事件

  • 在 ServerEventType 枚举中新增 agent_chat_response_part，用于流式传输部分智能体聊天响应

声音管理

  • 在语音历史来源类型中新增 VoiceGeneration

新增 LLM 模型

以下模型已添加至 LLM 枚举：

  • claude-sonnet-4-5 - 最新 Claude Sonnet 4.5
  • claude-sonnet-4-5@20250929 - Claude Sonnet 4.5 指定日期发布版本（2025 年 9 月 29 日）
  • gemini-2.5-flash-preview-09-2025 - Gemini 2.5 Flash 预览版（2025 年 9 月）
  • gemini-2.5-flash-lite-preview-09-2025 - Gemini 2.5 Flash Lite 预览版（2025 年 9 月）

其他变更

发音词典

  • 将 GET /v1/pronunciation-dictionaries/{dictionary_id}/{version_id}/download 中 version_id 的参数说明从“发音词典版本的 ID”更新为“发音词典版本 ID”
  • 移除了有关多个发音词典 UI 限制的文档说明（UI 现已完全支持多个词典）

对话历史

  • 将 ConversationHistoryTranscriptOtherToolsResultCommonModel 中的 type 字段设为可选（此前为必填）