2026 年 2 月 23 日

ElevenAgents

MCP 服务器的 OAuth 和高级身份验证：MCP 服务器现支持工作区身份验证连接，可使用 OAuth2 Client Credentials、Basic Auth、Bearer Auth、JWT 和自定义请求头身份验证。创建或编辑 MCP 服务器时选择身份验证连接，即可自动处理令牌刷新和身份验证请求头。详见 MCP 服务器文档。
LLM 信息端点：新增端点，用于列出可用 LLM，包括弃用状态、功能和上下文限制。客户端可通过编程方式发现哪些模型可用，以及哪些模型正在弃用。详见列出可用 LLM。
对话历史记录脱敏：新增支持，可在存储前从对话转录文本、音频和分析结果中移除敏感信息。可通过智能体隐私配置中新的 conversation_history_redaction 设置，配置需脱敏的特定实体类型（例如姓名、电子邮件地址等）。详见文档页面。
增强型护栏：为智能体新增 2 种护栏类型：
- focus：帮助对话保持主题
- prompt_injection：检测并防止提示词注入尝试
- 注意：已移除 alignment 护栏
对话搜索端点：新增 2 个用于搜索对话消息的端点：
- 文本搜索 - 对转录消息进行全文和模糊搜索
- 智能搜索 - 使用嵌入进行语义搜索
对话中的文件上传：新增端点，可在对话中上传和管理文件：
- 上传文件 - 将文件上传至对话
- 删除文件 - 移除已上传文件
新嵌入模型：知识库 RAG 索引现支持 qwen3_embedding_4b 嵌入模型。

工作区

图像和视频生成权限：工作区管理员现在可以控制图像和视频生成功能的访问权限。通过此新权限，可限制哪些工作区成员能使用这些功能。可在工作区设置的成员权限中配置。

音乐

工作区共享：现在可在工作区内共享歌曲。工作区资源共享端点已新增 songs 资源类型。

SDK 发布

JavaScript SDK

v2.36.0 - 为语音转文本封装器新增重载 convert 方法签名，提升类型安全性和易用性。更新 SDK 以包含最新 API schema 变更，包括 LLM 列表端点、对话搜索和 MCP 身份验证连接支持。

Python SDK

v2.36.1 - 新增缺失的音乐生成参数，包括 seed、loudness、quality 和 guidance_scale，确保与 API 的完整功能一致性。
v2.36.0 - 将软件包引用从“Conversational AI”重命名为“ElevenAgents”，以反映产品更名。更新 SDK 以包含最新 API schema 变更，包括 LLM 列表端点、对话搜索和 MCP 身份验证连接支持。

软件包

@elevenlabs/convai-widget-core@0.9.0 - 更新 widget 核心，包含最新功能和改进
@elevenlabs/convai-widget-embed@0.9.0 - 更新可嵌入 widget，包含最新功能和改进
@elevenlabs/react-native@0.5.10 - React Native SDK 更新
@elevenlabs/types@0.5.0 - 更新 TypeScript 类型软件包

API

查看 API 变更

新增端点

文本搜索对话消息 - GET /v1/convai/conversations/messages/text-search - 对对话转录消息进行全文或模糊搜索
智能搜索对话消息 - GET /v1/convai/conversations/messages/smart-search - 使用嵌入对对话消息进行语义搜索
列出可用 LLM - GET /v1/convai/llm/list - 获取可用 LLM，包括弃用信息、功能和上下文限制
上传文件至对话 - POST /v1/convai/conversations/{conversation_id}/files - 将文件上传至对话上下文
删除对话文件 - DELETE /v1/convai/conversations/{conversation_id}/files/{file_id} - 从对话中移除已上传文件

已移除端点

以下旧版语音生成端点已移除：

GET /v1/voice-generation/generate-voice/parameters - 语音生成参数
POST /v1/voice-generation/generate-voice - 生成随机声音
POST /v1/voice-generation/create-voice - 创建之前生成的声音

请改用声音设计和声音 Remix 端点。

更新的端点

ElevenAgents

创建智能体、更新智能体、获取智能体
- 新增用于智能体训练配置的 coaching_settings 字段
- 在 platform_settings.privacy 中新增 conversation_history_redaction，可配置实体类型
- 在 platform_settings.guardrails 中新增护栏：focus 和 prompt_injection
- 从 platform_settings.guardrails 中移除 alignment 护栏
- 在 RAG 配置中将 qwen3_embedding_4b 新增为嵌入模型选项
- 更新数值字段说明，以更清晰地说明范围和默认值
创建 MCP 服务器、更新 MCP 服务器、获取 MCP 服务器
- 新增 auth_connection 字段（可选），以启用 OAuth 和高级身份验证方法
- 为保持向后兼容性，在 PATCH 端点中新增 secret_token 字段
- 同时提供时，身份验证连接优先于 secret_token
创建 MCP 工具配置、更新 MCP 工具配置、获取 MCP 工具配置
- 新增 input_overrides 字段，可使用常量、动态变量或 LLM 生成的值覆盖工具输入参数
创建 RAG 索引、删除 RAG 索引
- 将 qwen3_embedding_4b 新增至 embedding_model 枚举
获取对话
- 弃用 search 查询参数（请改用新的专用搜索端点）
获取对话详情
- 新增 hiding_reason 字段，指示对话可能被隐藏的原因
- 扩展对话转录条目，以支持使用新 ChatSourceMedium 类型（音频、文本、图像、文件）的 file_input 元数据
模拟对话、流式模拟对话
- 更新所有嵌套配置字段，改进说明和验证范围
获取智能体分支、更新智能体分支
- 更新 current_live_percentage 字段说明，使其更清晰
获取 ElevenAgents 设置、更新 ElevenAgents 设置
- 改进 rag_retention_period_days 字段说明

工作区

更新 webhook
- 新增 retry_enabled 字段（布尔值，可选），为临时故障（5xx、429、超时）启用自动重试
获取工作区资源、共享工作区资源、取消共享工作区资源
- 在 resource_type 枚举中新增 songs，支持音乐工作区共享
获取用户
- 新增必填 seat_type 字段，枚举值为：workspace_admin、workspace_member、workspace_lite_member

音乐

生成音乐、详细生成音乐、流式生成音乐
- 明确 seed 参数说明：用于初始化音乐生成的随机种子。使用相同种子和相同参数有助于获得更一致的结果，但不保证完全可复现，输出可能会随系统更新而变化。不能与 prompt 参数一起使用。

文本转语音

创建声音预览、设计声音、Remix 声音
- 更新 loudness 参数说明：控制生成声音的音量级别。-1 最安静，1 最响，0 大致对应 -24 LUFS
- 更新 guidance_scale 参数说明：控制 AI 遵循提示词的程度。较低数值给予 AI 更多创作自由，较高数值则使其更严格地遵循提示词。数值过高可能使声音听起来不自然或机械。较长、更详细的提示词在较低引导尺度下效果更好。
- 更新声音预览创建的 quality 参数说明

音色

获取音色、获取音色设置、获取默认音色设置、编辑音色设置
- 更新 style 参数说明：确定声音的风格夸张程度。尝试放大原说话者的风格。会消耗额外计算资源，若设置为非 0 值，可能增加延迟。
- 更新 speed 参数说明：调整声音速度。1.0 为默认值，小于 1.0 会放慢语速，大于 1.0 会加快语速。