Changelog

December 15, 2025

智能体平台

实时对话监控：企业版用户现可通过 /v1/convai/conversations/{id}/monitor 的 WebSocket 连接实时监控智能体对话。功能包括缓存的对话历史记录、选择性事件流和控制命令（结束通话、插话、切换人工接管、发送消息）。
Hinglish 语言支持：为智能体新增 hinglish_mode 配置选项。启用后，若智能体语言为印地语，回复将使用 Hinglish（印地语和英语混合）。
语音信箱消息中的动态变量：语音信箱检测消息现支持动态变量替换，可在检测到语音信箱时发送个性化消息。
本地化小组件条款与条件：现在可通过语言预设，按语言本地化聊天小组件的条款与条件。
小组件对话模式开关：小组件配置新增 conversation_mode_toggle_enabled 选项，用于控制是否可切换对话模式。
批量通话重试跟踪：批量通话状态响应新增 retry_count 字段，用于跟踪重试次数。

文本转语音

质量预设积分费用：质量预设说明现包含积分费用信息：high（+20%）、ultra（+50%）和 ultra_lossless（+100%）。

WhatsApp 集成

简化电话号码配置：批量通话和对话信息架构中，使用 whatsapp_phone_number_id 替代 whatsapp_business_account_id，简化 WhatsApp 集成。

SDK 发布

Python SDK

v2.27.0 - 修复 Scribe 音频格式参数处理，并更新 API 架构
v2.26.1 - 扩展本地部署智能体配置支持

JavaScript SDK

v2.28.0 - 修复 Scribe 音频格式参数处理，并更新 API 架构

软件包

@elevenlabs/react@0.12.3 - 本地化聊天条款与条件，并修复 Scribe 音频格式
@elevenlabs/client@0.12.2 - 本地化聊天条款与条件，并修复 Scribe 音频格式
@elevenlabs/react-native@0.5.6 - 新增 TTS 速度参数覆盖，并修复 useEffect 钩子中 startSession 的无限循环
@elevenlabs/react@0.12.2 - 修复 WebSocket 关闭代码和 useConversation 竞态条件，新增 shadow host 事件分发，并扩展语言支持
@elevenlabs/client@0.12.1 - 修复 WebSocket 关闭代码和 useConversation 竞态条件，新增 shadow host 事件分发，并扩展语言支持

Android SDK

v0.7.1 - 修复 agent_tool_request 事件处理，并更正 expects_response 默认值

API

查看 API 变更

新端点

获取知识库摘要 - 按 ID 批量获取文档摘要
批量计算 RAG 索引 - 批量创建或获取 RAG 索引

更新的端点

知识库

列出知识库文档
- 新增 parent_folder_id 查询参数（字符串），用于按父文件夹筛选
- 新增 ancestor_folder_id 查询参数（字符串），用于按祖先文件夹筛选
- 新增 folders_first 查询参数（布尔值），用于将文件夹排在文档之前
文档响应架构
- 新增 folder 文档类型
- 新增 folder_parent_id 字段（字符串，可选）
- 新增 folder_path 字段（字符串，可选）
- 新增 children_count 字段（整数，用于文件夹）
- 新增 GetKnowledgeBaseFolderResponseModel 架构
- 新增 GetKnowledgeBaseSummaryFolderResponseModel 架构
RAG 索引端点
- 为 RAGIndexStatus 枚举新增 cannot_index_folder 状态
- 为 RAG 索引操作新增批量请求／响应模型

智能体平台

创建智能体、更新智能体、获取智能体
- 在智能体配置中新增 hinglish_mode（布尔值，默认 false）
- 在 workflow 覆盖架构中新增 hinglish_mode（可为空的布尔值）
小组件配置端点
- 在小组件设置中新增 conversation_mode_toggle_enabled（布尔值，默认 false）
批量通话端点
- 在批量通话响应模型中新增 retry_count（整数，默认 0）
对话令牌模型
- 新增 token_requester_user_id（字符串，可为空），用于标识令牌请求者

WhatsApp 集成

提交批量通话
- 使用 whatsapp_phone_number_id 替代 whatsapp_business_account_id（字符串，可为空、可选）
对话信息架构
- 在 WhatsAppConversationInfo 中使用 whatsapp_phone_number_id 替代 whatsapp_business_account_id

文本转语音

所有包含质量预设的 TTS 端点
- 更新 quality_preset 说明，加入积分费用百分比

工作区

资源类型枚举
- 为 WorkspaceResourceType 枚举新增 convai_agent_drafts