Changelog

ElevenAgents

• 用户页面现已正式推出：按用户标识符分组展示对话的列出用户页面现已向所有工作区开放。你可以在统一视图中查看所有与智能体互动过的用户、其对话记录和联系信息。

• 将 SIP 入站标头用作动态变量：来自入站 SIP 中继通话的自定义 SIP X- 标头现会自动在 ElevenAgents 对话中作为动态变量公开。调用方传递的任意自定义 SIP 标头（例如 X-Contact-ID、X-Campaign-ID）均可在智能体提示词中通过 {{sip_contact_id}}、{{sip_campaign_id}} 等使用。这些变量也会显示在“电话通话”标签页的对话记录中。X-Call-ID 和 X-Caller-ID 等保留标头仍会映射到 system__call_sid 和 system__caller_id，不会被覆盖。

• 按工具结果筛选对话：列出对话和文本搜索对话端点现接受 tool_names_successful 和 tool_names_errored 查询参数（字符串数组），可根据通话期间成功执行或返回错误的工具筛选对话。

• 用户列表改进：列出用户端点现支持 sort_by 查询参数，可接受 last_contact_unix_secs（默认）或 conversation_count；还支持 branch_id 查询参数，可按智能体分支筛选用户。

• 强制删除工具：删除工具端点现接受 force 查询参数（布尔值，默认 false）。设为 true 后，即使工具正被智能体使用也会被删除，并自动从所有依赖它的智能体和分支中移除。

• 对话嵌入保留期：ElevenAgents 设置响应现包含 conversation_embedding_retention_days，用于控制对话嵌入的保留时长（最长 365 天）。值为 null 时，将使用系统默认的 30 天。

• 内容阈值护栏：新增 ContentThresholdGuardrail 架构，提供可配置的阈值型护栏，包含用于内容审核的 is_enabled 标志和 threshold 值。

工作区

• 获取所有工作区群组：新增 GET /v1/workspace/groups端点，返回工作区内所有群组，包括每个群组的名称、ID、成员、权限、使用限额和字符数。

• 批量邀请工作区用户时指定席位类型：批量邀请用户端点现接受可选的 seat_type 字段，可在批量操作中为所有受邀用户指定席位类型（例如 workspace_member、workspace_admin）。

• 移动端 SSO 可靠性改进：修复了一项回归问题：用户退出后再次尝试登录时，移动端 SSO 登录会卡在“正在验证…”。还修复了通过 SAML 或 OIDC 提供商登录的移动端 SSO 用户切换工作区的问题。

音乐

• 段落时长控制：详细生成音乐端点现支持 respect_sections_durations（布尔值），用于控制模型是否遵循创作方案中为每个段落指定的时长。

ElevenCreative Studio

• 章节视觉内容指示器：章节响应模型现包含 has_visual_content 布尔字段，用于指示章节是否包含视觉内容。

• 文字阴影和描边样式：ElevenCreative Studio 文字样式现通过新的 StudioTextStyleShadowModel 和 StudioTextStyleOutlineModel 架构支持 text_shadow 和 text_outline 选项，可在 ElevenCreative Studio 项目中实现更丰富的文字视觉自定义。

• 媒体生成剪辑任务类型：PendingClipTask.type 枚举现包含 media_generation 值，扩展了剪辑任务分类以涵盖媒体生成 workflow。

SDK 发布

Python SDK

• v2.39.0 - 在 ElevenAgents 实时对话中新增对 multimodal_message WebSocket 事件类型的支持。
• v2.39.1 - 重新生成 Fern，以匹配最新 API 架构。

JavaScript SDK

• v2.39.0 - 重新生成 Fern，以匹配最新 API 架构。

iOS SDK

• v3.1.0 - 对 ElevenAgents Swift SDK 进行了多项改进：
  • 服务器错误现会通过 onError 回调显示，使错误处理更一致。
  • 新增基于事件的智能体状态管理，便于更清晰地观察状态。
  • 现支持软件静音和语音检测，可更精细地控制音频。
  • 改进代码库，全面采用 Swift Concurrency。
  • 修复 iOS 发布构建在启动时发生的崩溃问题。
  • 更新品牌标识，以反映 ElevenAgents 的品牌更新。

软件包

• @elevenlabs/client@0.15.1 - 当无法从系统获取所需采样率时，新增对输出音频的重采样，提高跨设备兼容性。
• @elevenlabs/react@0.14.2 - 更新为依赖 @elevenlabs/client@0.15.1。
• @elevenlabs/convai-widget-core@0.10.3 - 更新为依赖 @elevenlabs/client@0.15.1。

API