Changelog

February 16, 2026

ElevenAgents

  • 对话用户端点：新增 获取对话用户 端点（GET /v1/convai/users），用于列出曾与智能体对话的用户。支持分页，并可按智能体、时间范围和其他条件筛选。
  • 智能体版本控制：可通过 获取智能体 端点新增的 version_id 和 branch_id 查询参数，按版本获取特定智能体配置。更新智能体 端点现在也支持 branch_id 参数，以便针对特定分支更新。
  • 搜索文档工具：新增 search_documentation，作为 RAG（检索增强生成）的内置系统工具。可使用 MultiSourceConfigJson、SourceConfigJson 和 SourceRetrievalConfig schema 配置多源检索。支持通过 MergingStrategy 枚举配置合并策略。
  • MCP 工具支持：新增 mcp 工具类型，与 webhook、客户端和系统工具并列。可在智能体工具定义中使用新的 MCPToolConfig schema 配置 MCP 工具。
  • 内容护栏：在 GuardrailsV1 中新增内容审核护栏，可为不同内容类别配置阈值：色情、暴力、骚扰、自残、脏话、宗教/政治以及医疗/法律内容。使用新的 ContentGuardrail 和 ContentConfig schema。
  • 表现力模式：在智能体配置 schema 中新增 expressive_mode 字段（布尔值），可自动提示智能体充分利用新的 v3 对话模型。
  • 拨号后数字：电话号码转接现已支持 post_dial_digits，可在接通后发送 DTMF 音。可配置为静态值或动态变量。
  • 智能体测试类型：智能体测试现支持 3 种独立测试类型，并配有专用 schema：llm（响应评估）、tool（工具调用验证）和 simulation（完整对话模拟）。模拟测试包含 simulation_scenario 和 simulation_max_turns 配置字段。

发音词典

  • API 响应中的规则：获取发音词典 端点现在会返回包含完整规则详情的 rules 数组。响应使用新的 GetPronunciationDictionaryWithRulesResponseModel schema，并使用 PronunciationDictionaryAliasRuleResponseModel 和 PronunciationDictionaryPhonemeRuleResponseModel 表示规则类型。

知识库

  • 删除文件夹：删除知识库文档 端点现除文档外还支持删除文件夹。删除文件夹时，设置 force=true 可递归删除其中所有文档和子文件夹。

SDK 发布

Python SDK

  • v2.36.0 - 新增对话用户端点、智能体版本控制、搜索文档工具、MCP 工具支持、内容护栏和智能体测试类型

JavaScript SDK

  • v2.36.0 - 为 speechToText.convert() 新增重载 convert 签名，可根据请求参数改进类型推断（无需手动缩小类型，即可访问 .text、.transcripts 或 webhook 字段）；同时新增对话用户端点、智能体版本控制、搜索文档工具、MCP 工具支持、内容护栏和智能体测试类型

Widget 软件包

  • @elevenlabs/convai-widget-core@0.9.0 - 新增智能体工具使用状态显示，以及用于长时间运行工具调用的新状态徽章；修复情感标签移除问题，并修复签名 URL 嵌入 widget 的评分和反馈提交问题
  • @elevenlabs/convai-widget-embed@0.9.0 - 新增智能体工具使用状态显示，以及用于长时间运行工具调用的新状态徽章；修复情感标签移除问题

API

新增端点

更新的端点

ElevenAgents

  • 获取智能体
    • 新增 version_id 查询参数（字符串，可选），用于获取特定智能体版本
    • 新增 branch_id 查询参数（字符串，可选），用于从特定分支获取
  • 更新智能体
    • 新增 branch_id 查询参数（字符串，可选），用于针对特定分支更新
  • 创建智能体
    • 在系统工具中新增支持多源 RAG 配置的 search_documentation
    • 在工具判别器中新增 mcp 工具类型
    • 在 GuardrailsV1 中新增用于内容审核护栏的 content 字段
    • 在智能体配置中新增 expressive_mode 字段（布尔值）
  • 创建智能体测试、更新智能体测试、获取智能体测试
    • 改为带有 type 字段（llm、tool、simulation）的判别联合 schema
    • 为模拟测试新增 simulation_scenario 和 simulation_max_turns 字段

发音词典

  • 获取发音词典
    • 响应 schema 改为包含 rules 数组的 GetPronunciationDictionaryWithRulesResponseModel

知识库

Schema 变更

新增 Schema

  • GetPronunciationDictionaryWithRulesResponseModel - 包含嵌入式规则数组的响应模型
  • PronunciationDictionaryAliasRuleResponseModel - 包含 string_to_replace 和 alias 的别名规则
  • PronunciationDictionaryPhonemeRuleResponseModel - 包含 string_to_replace、phoneme 和 alphabet 的音素规则
  • MultiSourceConfigJson - 多源 RAG 配置
  • SourceConfigJson - RAG 的单个来源配置
  • SourceRetrievalConfig - RAG 来源的检索配置
  • MergingStrategy - RAG 结果合并策略枚举
  • MCPToolConfig - MCP 工具配置
  • ContentGuardrail-Input、ContentGuardrail-Output - 内容审核护栏配置
  • ContentConfig - 内容类别阈值配置
  • TestType - 值为 llm、tool、simulation 的枚举
  • CreateAgentTestResponseModel - 测试创建响应
  • LLMResponseTest*、ToolCallTest*、SimulationTest* - 按类型划分的测试 schema，替代旧版 Create/Get/UpdateUnitTest* 模型

修改的 Schema

  • GuardrailsV1-Input、GuardrailsV1-Output - 新增用于内容护栏的 content 字段
  • AgentConfig - 新增 expressive_mode 字段（布尔值）
  • PhoneNumberTransferConfig - 新增 post_dial_digits 字段（字符串或动态变量）
  • DistributionTerritories - 放宽项目限制，允许任意地区字符串