Changelog

June 8, 2026

文本转语音

  • v1 模型移除：eleven_monolingual_v1 和 eleven_multilingual_v1 模型已弃用，将于 2026 年 7 月 9 日移除。请在移除前迁移至 eleven_multilingual_v2 或其他当前模型。替代建议请参阅已弃用模型。

语音转文本

  • Scribe v1 移除：scribe_v1 模型已弃用，将于 2026 年 7 月 9 日移除。请在移除前迁移至 scribe_v2 或 scribe_v2_realtime。替代建议请参阅已弃用模型。

ElevenAgents

  • 轮次模型配置：TurnConfig 和 TurnConfigWorkflowOverride 新增可选 turn_model（turn_v2 或 turn_v3，默认 turn_v3），可为每个智能体或 workflow 节点选择轮次检测模型版本。
  • 软超时填充消息：SoftTimeoutConfig 和 SoftTimeoutConfigWorkflowOverride 新增可选 additional_soft_timeout_messages（字符串数组，最多 7 条）和 max_soft_timeouts_per_generation（整数，1–8，默认 1）。主 message 用于首次超时；后续超时使用额外消息或内置填充内容。
  • ASR 提供商默认值：默认 ASRConversationalConfig.provider 值从 elevenlabs 改为 scribe_realtime。elevenlabs 值仍保留在枚举中，但已弃用。
  • 对话产品字段：获取对话详情响应新增可选 conversation_product（字符串，默认 agent），用于标识处理该对话的产品。
  • 知识库外部同步：知识库文件和文件夹响应模型新增可选 external_sync_info（通过 ExternalFileSyncInfo / ExternalFolderSyncInfo 提供的 Google Drive 同步元数据）及可选 is_frozen（布尔值），用于指示同步内容是否可编辑。
  • 工具 schema 省略覆盖：ConvAI 工具 JSON schema 属性新增可选 is_omitted（布尔值）和 OmitSchemaOverride，其中 source: omit，允许在工具负载中明确省略字段。
  • 流程护栏：流程版本 schema 新增可选 guardrails。

工作区

  • URL 密钥认证连接：工作区认证连接的创建、列表和响应联合类型新增 url_secret（UrlSecretAuthResponse），作为从 URL 获取密钥的工具所支持的认证连接类型。
  • 智能体 QA 评估 webhook：WebhookUsageType 新增 Agent QA Evaluations，作为智能体质量保证事件推送的 webhook 用途类别。

文本转对话

ElevenCreative Studio

  • Safesearch 成人内容元数据：获取项目的 publishing_read 响应在 DirectPublishingReadResponseModel 中新增可选 safesearch_adult（可为空的布尔值），用于直接发布内容分类。

SDK 发布

JavaScript SDK

  • v2.52.0 - 基于最新 OpenAPI schema 重新生成，包含轮次配置中的 turn_model 和软超时填充字段、知识库外部同步类型、用于工具 schema 的 OmitSchemaOverride、UrlSecretAuthResponse、对话响应中的 conversation_product、文本转对话 enable_logging 支持，以及更新后的 AsrProvider 默认值。
  • v2.51.0 - 新增工作区 API 密钥撤销客户端、ConversationSentimentAnalysis 和 SystemEvaluationCriteria 类型、用于 HTTP 工具认证的 CustomLlmAuthConnection、流程工具配置类型、ResourceAccessInfoAccessSource，以及针对 workflow_node_entered_id 和 topic_ids 的对话列表/搜索筛选条件。

Python SDK

  • v2.52.0 - 基于最新 OpenAPI schema 重新生成，包含轮次模型和软超时配置更新、知识库外部同步模型、工具 schema 省略覆盖、URL 密钥认证连接、对话 conversation_product、文本转对话 enable_logging 支持，以及更新后的 ASR 提供商默认值。
  • v2.51.0 - 基于最新 OpenAPI schema 重新生成，包含工作区 API 密钥撤销、对话情感和系统评估类型、流程工具配置模型，以及更新后的对话筛选参数。

软件包

API

已更新端点

ElevenAgents

  • 获取对话详情 - GET /v1/convai/conversations/{conversation_id}
    • 响应新增可选 conversation_product（字符串，默认 agent）
  • 获取知识库文档 - GET /v1/convai/knowledge-base/{documentation_id}
    • 响应在文件模型中新增可选 external_sync_info 和 is_frozen

文本转对话

Schema 变更

ElevenAgents

  • TurnConfig 和 TurnConfigWorkflowOverride
    • 新增可选 turn_model 枚举（turn_v2、turn_v3，默认 turn_v3）
  • SoftTimeoutConfig 和 SoftTimeoutConfigWorkflowOverride
    • 新增可选 additional_soft_timeout_messages（字符串数组，最多 7 条）
    • 新增可选 max_soft_timeouts_per_generation（整数，1–8，默认 1）
  • ASRConversationalConfig
    • 默认 provider 从 elevenlabs 改为 scribe_realtime
    • elevenlabs 提供商值已弃用
  • 流程版本 schema
    • 新增可选 guardrails
  • 知识库文件和文件夹响应模型
    • 新增可选 external_sync_info 和 is_frozen
  • 工具 JSON schema 属性
    • 新增可选 is_omitted 和 OmitSchemaOverride（source: omit）

工作区

  • 认证连接联合类型
    • 新增 url_secret（UrlSecretAuthResponse）
  • WebhookUsageType 枚举
    • 新增 Agent QA Evaluations

ElevenCreative Studio

  • DirectPublishingReadResponseModel
    • 新增可选 safesearch_adult（可为空的布尔值）