For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
LogoLogo
联系我们
博客帮助中心API 定价注册
概览ElevenCreativeElevenAgentsElevenAPIReception.aiAPI 参考文档Changelog帮助中心
登录
概览ElevenCreativeElevenAgentsElevenAPIReception.aiAPI 参考文档Changelog帮助中心
联系我们
博客帮助中心API 定价注册
在本页
  • 2026年9月28日
  • Eleven v4 和 Eleven v4 Turbo
  • 语音转文字
  • ElevenAgents
  • Flows
  • 文本转对话
  • SDK 发布
  • API
  • 新增端点
  • 更新的端点
  • 2026年9月23日
  • 图像和视频
  • 2026年9月21日
  • ElevenAgents
  • 图像和视频
  • 语音引擎
  • 文本转语音
  • SDK 发布
  • API
  • 新增端点
  • 更新的端点
  • 架构变更
  • 2026年9月14日
  • ElevenAgents
  • 音乐
  • SDK 发布
  • API
  • 新增端点
  • 更新的端点
  • 架构变更
  • 2026年9月11日
  • Scribe v2 Medical
  • 2026年9月7日
  • ElevenAgents
  • 工作区
  • SDK 发布
  • API
  • 新增端点
  • 已更新端点
  • Schema 变更
  • 2026年8月31日
  • ElevenAgents
  • 音乐
  • 配音
  • SDK 发布
  • API
  • 已更新端点
  • Schema 变更
  • 2026年8月24日
  • ElevenLabs CLI
  • 操作流程
  • ElevenAgents
  • SDK 版本发布
  • API
  • 新增端点
  • 更新的端点
  • Schema 变更
  • 2026年8月22日
  • MCP 服务器
  • 2026年8月17日
  • ElevenCreative
  • ElevenAgents
  • SDK 发布
  • API
  • 新增端点
  • 已更新端点
  • 架构变更

Changelog

September 28, 2026
September 28, 2026

September 23, 2026
September 23, 2026

September 21, 2026
September 21, 2026

September 14, 2026
September 14, 2026

September 11, 2026
September 11, 2026

September 7, 2026
September 7, 2026

August 31, 2026
August 31, 2026

August 24, 2026
August 24, 2026

August 22, 2026
August 22, 2026

August 17, 2026
August 17, 2026
较旧的帖子
下一个
使用以下工具构建完成
登录

Eleven v4 和 Eleven v4 Turbo

Eleven v4 和 Eleven v4 Turbo 现已推出。Eleven v4 可在超过 90 种语言中提供更高质量、更具表现力的语音,以及更出色的语音克隆。Eleven v4 Turbo 属于同一模型系列,适用于实时应用,中位推理延迟约为 100 ms。

内容创作和长音频可通过文本转对话 API 使用 eleven_v4。智能体和交互式应用可通过文本转对话 WebSocket 使用 eleven_v4_turbo。

Eleven v4 概览

对比两个模型版本、语音克隆行为、设置和支持的语言。

文本转对话 API

使用 Eleven v4 生成高质量对话。

实时流式传输

通过 WebSocket 连接流式传输 Eleven v4 Turbo 对话。

语音转文字

  • 转录编辑:批量和实时转录现可接受最长 2,000 个字符的自然语言编辑指令。批量响应会在 edited_transcript 中返回结果,实时会话则会发出 edited_transcript 事件。有关不兼容项、响应处理和定价,请参阅批量和实时指南。

ElevenAgents

  • 智能体模型:在支持的智能体 LLM 选项中新增 gpt-6-sol、gpt-6-luna、glm-52、deepseek-v41-flash、claude-opus-5 和 claude-opus-5-5。
  • 智能体测试用量:测试调用摘要可包含总积分和美元价格。单次测试运行可包含积分和计费明细。

Flows

  • 模板 API:新增用于列出和获取已发布 Flows 模板、启动模板运行及获取运行结果的端点。运行可指定已发布版本,并将最终结果发送至配置的 webhook。

文本转对话

  • 生成连续性:文本转对话请求可使用前文或后文以及请求 ID,以保持多次生成之间的连续性。
  • 专业音色模式:文本转对话请求可使用专业语音克隆的即时语音克隆版本,以降低延迟或提升表现力。

SDK 发布

JavaScript SDK

  • v2.70.0 - 新增批量和实时语音转文字转录编辑类型、测试调用摘要的 branchId 筛选和费用字段、知识库自动发现、文本转对话 usePvcAsIvc 以及 deepseek-v41-flash 智能体模型。

Python SDK

  • v2.70.0 - 新增批量和实时语音转文字转录编辑类型、测试调用摘要的 branch_id 筛选和费用字段、知识库自动发现、文本转对话 use_pvc_as_ivc 以及 deepseek-v41-flash 智能体模型。

ElevenLabs CLI

  • v1.4.0 - 修复使用明确 API 密钥的请求同时发送已存储 OAuth 凭据的问题,该问题会导致身份验证失败。为反馈命令组添加说明,并为生成的智能体技能添加报告缺失功能的说明。使用 Flows 模板端点和当前架构类型重新生成 API 客户端。

API

查看 API 变更

新增端点

Flows

  • 列出模板 - GET /v1/flows/templates - 列出已发布模板及其可运行版本。
  • 获取模板 - GET /v1/flows/templates/{template_id} - 获取模板及其可运行版本。
  • 创建模板运行 - POST /v1/flows/templates/{template_id}/runs - 使用输入值、可选版本和可选 webhook 启动模板运行。
  • 列出模板运行 - GET /v1/flows/templates/{template_id}/runs - 使用游标分页和可选版本筛选列出模板运行。
  • 获取模板运行 - GET /v1/flows/templates/{template_id}/runs/{run_id} - 获取模板运行及其输出状态。

更新的端点

语音转文字

  • 将语音转换为文字 - POST /v1/speech-to-text
    • 新增可选可空 transcript_edit(字符串),可接受最长 2,000 个字符的自然语言编辑指令。
    • 响应新增可选可空 edited_transcript。编辑成功时包含必填 kind: "transcript" 和 text 字段。编辑失败时包含必填 kind: "error"、error_type: "edit_failed" 和 message 字段。
  • 实时语音转文字接受 transcript_edit(字符串),并发出包含必填 text 和 edited_text 字段的 edited_transcript 事件。

ElevenAgents

  • 创建智能体、获取智能体和更新智能体
    • 在 LLM 枚举中新增 gpt-6-sol、gpt-6-luna、glm-52、deepseek-v41-flash、claude-opus-5 和 claude-opus-5-5。
    • 告警监控项新增可选可空 enabled(布尔值),用于控制监控项是否可发送通知。
  • 列出对话和文本搜索
    • data_collection_params 和 dynamic_variable_params 新增 neq 和 in 运算符。in 的值使用竖线分隔。
    • evaluation_params 接受 success、failure 或 unknown 作为结果值。
  • 智能搜索 - GET /v1/convai/conversations/messages/smart-search
    • 新增可选可空 branch_id(字符串)。
  • 列出测试调用 - GET /v1/convai/test-invocations
    • 新增可选可空 branch_id(字符串)。
    • 测试调用摘要新增可选可空 credits_used(整数)和 total_price(数字)。
  • 获取测试调用 - GET /v1/convai/test-invocations/{test_invocation_id}
    • 单次测试运行新增可选可空 credits_used(整数)和 charging(ConversationChargingCommonModel)。
  • 模拟对话和模拟对话流
    • 将可选 new_turns_limit 的默认值从 10,000 改为 100,并将最大值设为 100。
  • 创建爬取任务和获取爬取任务
    • 新增可选 auto_discover(布尔值,默认 false),用于在自动同步期间跟踪链接并添加新发现的页面。这需要 enable_auto_sync: true。
  • 刷新知识库文档 - POST /v1/convai/knowledge-base/{documentation_id}/refresh
    • AutoSyncInfo 新增可选 auto_discover(布尔值,默认 false),用于指示刷新时是否爬取并添加新发现的页面。
  • 列出 MCP 服务器工具 - GET /v1/convai/mcp-servers/{mcp_server_id}/tools
    • 响应新增可选 tool_approval_statuses(数组)。每项包含必填 tool_id(字符串)和 state(up_to_date、needs_review 或 not_approved),以及可选的审批策略和已批准定义字段。

文本转对话

  • 将文本转换为对话、流式转换文本为对话、转换并附带时间戳和流式转换并附带时间戳
    • 新增可选 use_pvc_as_ivc(布尔值,默认 false),用于使用专业语音克隆的即时语音克隆版本。
    • 新增可选可空 previous_text 和 future_text(字符串,最长 100 个字符),以及 previous_request_ids 和 next_request_ids(字符串数组,最多 3 个 ID),用于保持生成连续性。
    • 可选 settings 对象新增可空 similarity(数字,0–1,默认 0.75)。

文本转语音

  • 将文本转换为语音、流式转换文本为语音、转换并附带时间戳和流式转换并附带时间戳
    • 现有的 use_pvc_as_ivc 字段不再弃用。

Flows

  • 创建图像生成、创建视频生成和创建模板运行
    • Webhook 目标现在需要明确的 type 区分符(all 或 ids)。已移除之前的默认值。

声音设计

  • 从预览创建声音、创建声音预览、设计声音和混音声音
    • 当预览的生成已在进行时,新增 409 响应。收到此响应后请重试请求。

工作区

  • 创建服务账户 API 密钥 - POST /v1/service-accounts/{service_account_user_id}/api-keys
    • 为企业版服务账户 API 密钥新增可选可空 tts_concurrency_limit、music_concurrency_limit 和 dubbing_concurrency_limit(整数)。
  • 更新服务账户 API 密钥 - PATCH /v1/service-accounts/{service_account_user_id}/api-keys/{api_key_id}
    • 新增可选 tts_concurrency_limit、music_concurrency_limit 和 dubbing_concurrency_limit。每个字段可接受整数、clear、no_update 或 null,默认值为 no_update。

模型

  • 列出模型 - GET /v1/models
    • 弃用必填 max_characters_request_free_user 和 max_characters_request_subscribed_user。这些字段不会强制执行;请改用 maximum_text_length_per_request。

图像和视频

  • Sora 2 和 Sora 2 Pro 已停用:OpenAI 将于 2026 年 9 月 24 日停止 Sora API 服务。两个模型已从图像和视频模型选择器中移除,并将于该日期停止生成。现有生成内容仍可在历史记录中查看。使用 Sora 节点的 Flows 和模板需切换到其他视频模型,例如 Gemini Omni 1.1 Flash,才能再次运行。
  • Seedance 1.5 Pro 已弃用:ByteDance 将于 2026 年 11 月 11 日停止 Seedance 1.5 Pro 服务。该模型不再提供给新的生成任务,并将于该日期停止运行。请改用 Seedance 2.0 模型。

ElevenAgents

  • 并行工具调用:智能体提示词配置现包含 enable_parallel_tool_calls(布尔值,默认 true)。启用后,支持的模型可在一次轮次中执行多个工具。
  • 智能体模型:智能体 LLM 选项新增 gpt-6-astra。
  • 告警:智能体告警现支持 Slack 频道,以及 PagerDuty 和 webhook 通知器。
  • 电话号码搜索:新增基于游标分页的电话号码端点,可按提供商、外呼支持、已分配智能体和分支、标签及电话号码筛选。

图像和视频

  • GPT Image 2.5 模型:图像生成现支持 gpt-image-2.5-flare 和 gpt-image-2.5-sunburst。两个模型均最多支持 10 张参考图像,质量级别最高可选 max,支持 14 种固定宽高比及 auto,并可输出 1K、2K 或 4K。

语音引擎

  • 级联超时:语音引擎创建和更新请求现接受 cascade_timeout_seconds(数字,2–15,默认 4),用于控制 ElevenLabs 在重试前等待上游语音引擎的时长。

文本转语音

  • 多上下文轮次边界:现会在该轮次的每个缓冲字节后发送 is_final_audio_for_turn 标记,包括 MP3 和 Opus 输出。客户端无需切换到 PCM,即可将此标记用作精确的轮次边界。

SDK 发布

JavaScript SDK

  • v2.69.0 - 在实时文本转语音封装器中新增 transcriptEdit,编辑后的文本通过 edited_transcript 事件发送。修复带数据驻留后缀的 API 密钥的语音引擎 JWT 验证问题。新增 phoneNumbers.listV2 和 Flows 模板方法,可列出和获取模板,以及列出、创建和获取运行。重新生成了 GPT Image 2.5、Slack 智能体告警、并行工具调用、gpt-6-astra、服务账户 API 密钥并发限制、Music 零保留、对话筛选器和 MCP 工具审批状态的客户端和类型。

Python SDK

  • v2.69.0 - 在实时文本转语音封装器中新增 transcript_edit,编辑后的文本通过 edited_transcript 事件发送。修复带数据驻留后缀的 API 密钥的语音引擎 JWT 验证问题,并让 play 在 ffplay 失败时抛出错误。新增 phone_numbers.list_v2 和 Flows 模板方法,可列出和获取模板,以及列出、创建和获取运行。重新生成了 GPT Image 2.5、Slack 智能体告警、并行工具调用、gpt-6-astra、服务账户 API 密钥并发限制、Music 零保留、对话筛选器和 MCP 工具审批状态的客户端和类型。

ElevenLabs CLI

  • v1.3.2 - 新增可选 --intent 元数据,以收集 CLI 使用反馈。新增 elevenlabs feedback missing-capability,用于报告 CLI 不支持的工作流程。

API

查看 API 变更

新增端点

ElevenAgents

  • 列出电话号码页面 - GET /v1/convai/v2/phone-numbers
    • 新增可选 page_size(整数,1–1,000,默认 100)和 cursor(可为空的字符串)分页参数。
    • 新增可选 search、label、phone_number、provider、supports_outbound、agent_id、branch_id、sort_by 和 sort_direction 筛选器。sort_by 接受 label 或 phone_number;sort_direction 默认为 asc。
    • 响应包含必填 phone_numbers(数组)、可选且可为空的 next_cursor(字符串)和 has_more(布尔值,默认 false)。

更新的端点

ElevenAgents

  • 创建智能体、获取智能体 和 更新智能体
    • 提示词配置新增 enable_parallel_tool_calls(布尔值,默认 true)。工作流程覆盖项接受可为空的布尔值。
    • LLM 枚举新增 gpt-6-astra,包括对话发起覆盖项。
    • 告警集成通知器现使用 integration_type 选择 pagerduty 或 slack。Slack 通知器需要 connection_id 和 channel_id(字符串);channel_id 接受 1–64 个字符。
  • 列出对话和解析对话引用
    • data_collection_params 不再接受 missing 运算符。请使用空值来匹配未收集该字段的对话。
    • dynamic_variable_params 中的空值可匹配未设置该变量的对话。
  • 创建语音引擎、获取语音引擎 和 更新语音引擎
    • 新增 cascade_timeout_seconds(数字,2–15)。创建请求默认值为 4,更新请求接受可为空的值,响应要求包含该字段。

图像和视频

  • 创建图像生成 - POST /v1/flows/image
    • 为 gpt-image-2.5-flare 和 gpt-image-2.5-sunburst 新增请求变体。
    • 两种变体均需要 prompt 和 model_id,最多接受 10 个 images,并新增 resolution(1K、2K 或 4K,默认 1K)。
    • quality 接受 low、medium、high、xhigh 或 max,默认为 high。aspect_ratio 接受 auto 和 14 种固定比例,默认为 16:9。

配音

  • 创建配音项目 - POST /v1/dubbing/project
    • Multipart keyterms 接受重复字段或单个 JSON 数组。
    • Multipart webhook_ids 接受重复字段、单个 JSON 数组或逗号分隔字符串。
  • 获取工作区资源、共享工作区资源 和 取消共享工作区资源
    • WorkspaceResourceType 新增 dubbing_project。

知识库

  • 创建爬取任务 - POST /v1/convai/knowledge-base/crawl
    • 已弃用 max_depth(整数,默认 3)。该字段现无实际作用,且不再有最小或最大限制。
    • 爬取任务元数据不再要求 max_depth。

用户

  • 获取用户和获取订阅
    • 货币枚举新增 gbp。

架构变更

文本转语音

  • 多上下文 WebSocket audio 和 final 消息现将 is_final_audio_for_turn 定义为:在该轮次的所有缓冲字节均已发送后发生。

ElevenAgents

  • 通话排队和等待音频:为达到并发上限的智能体新增通话排队。排队中的来电者会听到等待音频,并持续收到 queue_status 事件,直至接入或超时。新增 API 方法可上传或删除自定义等待音频。
  • 测试版本元数据:智能体测试结果现在会标识其运行所针对的智能体版本,以及是否包含草稿更改。调用摘要还会标识部分重新提交是否针对不同版本运行。
  • 模型和账户元数据:智能体 LLM 配置现支持 gemini-3.8-flash。WhatsApp 账户响应会标识账户使用 Cloud API 还是共存注册流程。

音乐

  • Music v2.5 API 支持:音乐端点和 SDK 现支持 music_v2_5。乐曲方案生成分块最多支持 6,132 个字符,最多 30 行,每行 200 个字符。

SDK 发布

JavaScript SDK

  • v2.68.0 - 新增上传和删除智能体等待音频的方法。重新生成了通话排队、流程引用、草稿分支创建、RAG 查询限制、测试版本元数据、gemini-3.8-flash 和 music_v2_5 的类型。

Python SDK

  • v2.68.0 - 新增同步和异步上传、删除智能体等待音频的方法。重新生成了通话排队、流程、草稿分支创建、RAG 查询限制、测试版本元数据、gemini-3.8-flash 和 music_v2_5 的类型。compose_detailed 封装器现支持所有已生成的音乐模型 ID,以及基于提示词和分块的乐曲方案。

iOS SDK

  • v3.3.1 - 现按 response_id 而非 event_id 协调智能体消息,可保留工具调用前后的多个响应,并防止流式片段或修正内容附加到错误的消息。

ElevenLabs CLI

  • v1.3.0 - 为生成的 API 命令新增可选 --intent 元数据。新增 elevenlabs feedback missing-capability,用于报告 CLI 不支持的工作流程。

软件包

  • @elevenlabs/convai-widget-core@0.18.2 和 @elevenlabs/convai-widget-embed@0.18.2 - 修复工具和流程调用后出现重复智能体回复的问题。流式文本回复会保留 Markdown 格式,语音对话也不再渲染未说出的流式聊天片段。嵌入软件包还将 user_activity 事件限制为每秒一次,并在会话结束时清除该限制。

API

查看 API 变更

新增端点

ElevenAgents

  • 上传智能体等待音频 - POST /v1/convai/agents/{agent_id}/hold-audio
    • 接受必填的 hold_audio_file(二进制)作为 multipart 表单数据。文件必须为 MP3 或 WAV,最大 40 MB、180 秒。
    • 返回必填的 agent_id(字符串)和 hold_audio(AgentHoldAudioConfig)。等待音频对象需要 audio_path、audio_url、original_filename(字符串)、duration_secs(数字)和 size_bytes(整数)。
  • 删除智能体等待音频 - DELETE /v1/convai/agents/{agent_id}/hold-audio
    • 删除自定义片段,使排队来电者听到默认等待音。
    • 返回必填的 agent_id(字符串)。

更新的端点

ElevenAgents

  • 创建智能体、获取智能体 和 更新智能体
    • 新增可选 platform_settings.queueing_config(AgentQueueingConfig),包含 enabled(布尔值,默认 false)和 wait_timeout_seconds(整数,1–1,800,默认 180)。
    • 队列配置响应包含只读、可为空的 hold_audio(AgentHoldAudioConfig)。智能体响应还包含可选 default_hold_audio_url(字符串)。
  • 获取对话 - GET /v1/convai/conversations/{conversation_id}
    • 元数据新增可选、可为空的 queue_wait_secs(数字)。排队时间不计入 call_duration_secs 和计费时长。
  • 创建智能体分支 - POST /v1/convai/agents/{agent_id}/branches
    • 新增可选 include_draft(布尔值,默认 false)。设为 true 时,从分支顶端创建的分支会包含调用方的草稿流程集。
  • 列出流程以及流程创建、获取和草稿端点
    • 列表项新增可选 referenced_tool_ids、referenced_kb_ids、referenced_procedure_ids 和 referenced_dynamic_variables(字符串数组)。
    • 智能体和合并预览响应新增可选 procedures,这是一个以流程 ID 为键的映射。
  • 列出测试调用 - GET /v1/convai/test-invocations
    • 新增可选、可为空的 search(字符串),可按名称筛选测试和文件夹。
  • 在智能体上运行测试和获取测试调用
    • 测试套件调用和单元测试运行响应新增可选、可为空的 version_id(字符串)以及可选 ran_against_draft(布尔值,默认 false)。
    • 调用摘要还新增可选 runs_diverged_from_version(布尔值,默认 false)。
  • POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query
    • 请求正文新增可选、可为空的查询专用覆盖项 max_documents_length(整数,1–50,000)和 max_retrieved_rag_chunks_count(整数,1–20)。
  • 获取 WhatsApp 账户 - GET /v1/convai/whatsapp-accounts/{phone_number_id}
    • 新增可选 account_type(WhatsAppAccountType,默认 cloud_api)。可选值为 cloud_api 和 coexistence。
  • 计算预期 LLM 用量 - POST /v1/convai/agent/{agent_id}/llm-usage/calculate
    • LLMUsageCalculatorLLMResponseModel 新增必填 price_per_message(数字)。

音乐

  • MusicModelID 为 POST /v1/music/video-to-music、POST /v1/music/plan、创作音乐、POST /v1/music/detailed、POST /v1/music/detailed/stream、POST /v1/music/stream、POST /v1/music/upload 和 POST /v1/music/finetunes 新增 music_v2_5。
  • 对于 POST /v1/music/plan、POST /v1/music、POST /v1/music/detailed、POST /v1/music/detailed/stream、POST /v1/music/stream 和 POST /v1/music/upload,GenerationChunk.text 的 maxLength 从 6,000 个字符提高到 6,132 个字符。段落名称可包含 1–100 个字符,分块最多可包含 30 行,每行 200 个字符。

架构变更

ElevenAgents

  • 实时服务器事件新增 queue_status。其必填 queue_status_event.status 接受 waiting、admitted 或 timed_out;timed_out 会先于 WebSocket 关闭代码 4300 发生。等待音频仍作为常规 audio 事件发送。
  • LLM 枚举新增 gemini-3.8-flash,包括对话发起覆盖项。
  • 对话系统工具结果联合类型新增 start_procedure_success、start_procedure_error、end_procedure_success 和 end_procedure_error。
  • FeaturesUsageCommonModel 新增可选 freeform_procedure 和 structured_procedure 功能状态。

Scribe v2 Medical

Scribe v2 Medical 现已正式发布。这是一款专为医疗和临床音频设计的批量语音识别模型,计费标准与 Scribe v2 相同。

在创建转录文本时,将 model_id 设为 scribe_v2_medical。关键词提示、实体检测、说话人分离和非逐字模式的使用方式与 Scribe v2 相同。

模型

模型 ID、功能以及适合使用 Scribe v2 Medical 的场景。

创建转录文本

将 model_id 设为 scribe_v2_medical,即可转录音频。

ElevenAgents

  • 工作区范围的对话工单:新增列出工作区工单,可获取有访问权限的智能体中的对话分诊工单。可按状态或负责人筛选,并使用游标分页,每页最多获取 100 个工单。
  • 动态变量对话筛选:列出对话和文本搜索对话消息现接受可重复的 dynamic_variable_params 筛选条件。使用 name:op:value 格式,op 可为 eq、gt、gte、lt 或 lte;比较运算符要求值为数值。
  • Twilio 答录机检测:外呼电话和批量呼叫配置现支持可选的 twilio_machine_detection。选择 enable 可尽早判断是人工还是机器,选择 detect_message_end 则等待语音信箱问候语结束。结果将通过新的 answering_machine_detection webhook 事件送达。
  • 数据收集值约束:数据收集属性现可使用 allowed_values 指定一个包含允许值的动态变量。此前的 allowed_values_dynamic_variable 字段已弃用。
  • 智能体元数据:列出智能体分支响应现会指明草稿的创建时间,以及它是否早于分支最新提交。智能体和语音引擎摘要现在要求提供 voice_id。
  • 知识库源 URL:智能体 RAG 查询分块现包含必需且可为 null 的 source_url,其中包含 URL 文档的追踪 URL。
  • 智能体响应附件:agent_response WebSocket 事件现包含可选的 attachments。每个附件都需要 url 和 name,并可包含 mime_type。

工作区

  • API 密钥平台限制:服务账号 API 密钥响应现可包含企业版 platform_limits,涵盖额度、专业语音克隆,以及 TTS、配音和音乐的并发限制。

SDK 发布

JavaScript SDK

  • v2.67.0 - 在对话列表和文本搜索请求中添加 dynamicVariableParams。重新生成 Twilio 答录机检测、数据收集值约束、API 密钥平台限制、智能体分支草稿元数据和知识库源 URL 的类型。

Python SDK

  • v2.67.0 - 在同步和异步对话列表及文本搜索方法中添加 dynamic_variable_params。重新生成 Twilio 答录机检测、数据收集值约束、API 密钥平台限制、智能体分支草稿元数据和知识库源 URL 的类型。实时文本转语音客户端不再将内部 omit sentinel 传递给连接。

ElevenLabs CLI

  • v1.2.0 - 添加 elevenlabs say 命令及其智能体技能,重新生成 API 命令绑定,并将 eleven_v3 设为默认 TTS 模型。

软件包

  • @elevenlabs/client@1.25.0、@elevenlabs/react@1.15.2、@elevenlabs/react-native@1.2.27、@elevenlabs/convai-widget-core@0.18.1 和 @elevenlabs/convai-widget-embed@0.18.1 - 从 @elevenlabs/client 重新导出 MessageAttachment,以便使用者直接导入该类型。
  • @elevenlabs/client@1.24.0、@elevenlabs/types@0.23.0、@elevenlabs/react@1.15.1、@elevenlabs/react-native@1.2.26、@elevenlabs/convai-widget-core@0.18.0 和 @elevenlabs/convai-widget-embed@0.18.0 - 将智能体响应文件附件转发至 onMessage,并新增可选的 webRtc.singlePeerConnection 会话设置。组件还对问候按钮进行了本地化,并修复了文本聊天响应丢失或重复的问题。

API

查看 API 变更

新增端点

ElevenAgents

  • 列出工作区工单 - GET /v1/convai/triage-tickets
    • 列出调用方有权访问的所有智能体中的对话分诊工单,按创建时间从近到远排序。
    • 添加可选的 page_size(整数,1–100,默认 100)、status(AgentConversationTicketStatus)、assignee_user_id(字符串或 unassigned)和 cursor(字符串)查询参数。
    • 返回 GetAgentConversationTicketsPageResponseModel。

已更新端点

ElevenAgents

  • 列出对话 - GET /v1/convai/conversations
    • 添加可选且可为 null 的 dynamic_variable_params(可重复字符串数组)。每个值使用 name:op:value 格式,其中 op 为 eq、gt、gte、lt 或 lte。
  • 文本搜索对话消息 - GET /v1/convai/conversations/messages/text-search
    • 添加具有相同语法的可选且可为 null 的 dynamic_variable_params(可重复字符串数组)。
  • Twilio 外呼、SIP 中继外呼、Exotel 外呼和提交批量呼叫
    • telephony_call_config 现使用独立的输入和输出 schema。
    • 添加可选且可为 null 的 twilio_machine_detection(TwilioMachineDetectionConfig)。其 mode 接受 enable 或 detect_message_end,默认值为 enable。非 Twilio 服务商和呼入电话会忽略此设置。
  • 导入电话号码 - POST /v1/convai/phone-numbers
    • 为 Twilio API 密钥导入添加可选且可为 null 的 account_auth_token(字符串),用于验证呼入 webhook 签名。

Schema 变更

ElevenAgents

  • WebhookEventType 新增 answering_machine_detection。
  • AgentBranchSummary 新增可选且可为 null 的 draft_created_at(整数)和可选的 draft_is_behind_tip(布尔值,默认 false)。
  • AgentKnowledgeBaseRagChunkResponseModel 新增必需且可为 null 的 source_url(字符串)。
  • AgentSummaryResponseModel 和 SpeechEngineSummaryResponse 新增必需的 voice_id(字符串)。
  • AnalysisProperty 新增可选且可为 null 的 name(字符串)和 allowed_values(AllowedValues)。LiteralJsonSchemaProperty 也新增 allowed_values。两者均弃用 allowed_values_dynamic_variable。
  • DataCollectionResultCommonModel 新增可选且可为 null 的 name(字符串)。
  • WorkspaceApiKeyResponseModel 新增可选且可为 null 的 platform_limits(PlatformLimits)。
  • MCP 工具 Icon 新增可选且可为 null 的 theme(light 或 dark)。
  • SMBToolConfig 新增 send_custom_email、create_service_quote_request 和 create_product_quote_request 参数变体。
  • Webhook 查询参数 schema 和电话呼叫配置现使用独立的输入和输出模型。
  • agent_response WebSocket 事件新增可选的 attachments(数组)。每项都需要 url 和 name(字符串),并接受可选的 mime_type(字符串)。

ElevenCreative

  • ReferenceVideo.studio_clip 现使用 StudioClipLocator 替代 StudioClipReference。字段和线缆格式保持不变。

ElevenAgents

  • 电话按键输入:智能体对话配置现支持可选的 dtmf_input_settings,用于 DTMF 输入。可配置数字输入超时、使用 # 作为结束符,并从转录文本、日志和分析中隐藏按键输入内容。
  • 对话附件历史记录:获取对话的转录条目现包含 file_inputs,这是一个数组,包含每个附件文件的 ID、名称、MIME 类型和 URL。
  • 智能体标签筛选:列出智能体现接受可选的 tags 查询参数。重复该参数可匹配带有任一指定标签的智能体。
  • 批量活动上下文:获取对话现可通过可为 null 的 campaign 元数据识别批量呼叫,其中包含必需的 campaign_id 和 campaign_lead_id。

音乐

  • 波形可视化数据:详细生成音乐、流式生成音乐及详情和上传音乐现接受可选的 with_waveform_visual(布尔值,默认 false)。选择启用后,响应会返回低分辨率的 waveform_visual 整数数组,每秒包含 4 个采样点。

配音

  • 项目分页行为:列出配音项目和列出语言目标现会将 page_size 限制在 1–100。项目状态筛选新增 queued,且两个端点均说明如何使用 next_cursor 获取下一页。

SDK 发布

JavaScript SDK

  • v2.66.0 - 为 sendMultimodalMessage 添加 fileIds,一条消息现在可包含多个文件附件。

Python SDK

  • v2.66.0 - 为 send_multimodal_message 添加 file_ids,一条消息现在可包含多个文件附件。

Android SDK

  • v0.12.2 - 连接会话事件时保留 onUnhandledClientToolCall 回调。需要响应的未处理客户端工具调用现在会收到自动错误响应,而不再处于未解决状态。

ElevenLabs CLI

  • v1.1.0 - 重新生成 API 命令绑定,并为 ElevenAgents workflow 添加命令级请求归因。这些命令会将 cmd/<command> 追加到 CLI 的 User-Agent,从而区分 agents push 和 agents create 等 workflow 发出的请求。

软件包

  • @elevenlabs/client@1.23.0、@elevenlabs/react@1.15.0、@elevenlabs/types@0.22.1、@elevenlabs/react-native@1.2.25、@elevenlabs/convai-widget-core@0.17.1 和 @elevenlabs/convai-widget-embed@0.17.1 - 为 sendMultimodalMessage 添加 fileIds。客户端同时发送 file 和 files 字段以保持兼容性,React 则提供更新后的客户端 API。

API

查看 API 变更

已更新端点

ElevenAgents

  • 列出智能体 - GET /v1/convai/agents
    • 添加可选且可为 null 的 tags(字符串数组)。重复该查询参数可匹配任一指定标签。
  • 创建智能体、获取智能体和更新智能体
    • 添加可选且可为 null 的 conversation_config.conversation.dtmf_input_settings(DTMFInputConfig)。支持 dtmf_input_timeout(数值,0.5–10 秒,默认 2)、hash_terminator(布尔值,默认 true)和 redact_input(布尔值,默认 false)。
    • 在电话号码转接配置中添加可选的 sip_refer_play_dialtone(布尔值,默认 true)。将其设为 false,可在 SIP REFER 转接完成期间保持原始通话线路静音。
    • 开始和结束流程系统工具现可接受 ProcedureVersionRef 或 ProcedureDraftRef。草稿引用需要 procedure_id(字符串),并将 version_id 设为 null。
  • 获取对话 - GET /v1/convai/conversations/{conversation_id}
    • 在转录条目中添加 file_inputs(ConversationHistoryTranscriptFileInputResponseModel 数组)。每项都需要 file_id、original_filename、mime_type 和 file_url(字符串)。
    • 在批量呼叫元数据中添加可选且可为 null 的 campaign(BatchCallingCampaignInformation)。该对象需要 campaign_id 和 campaign_lead_id(字符串)。
    • 向 ChatSourceMedium 添加 dtmf。
  • 对话分诊工单问题类型新增 incorrect_information、documentation_gap、platform_bug 和 wrong_action。

音乐

  • 详细生成音乐(POST /v1/music/detailed)和流式生成音乐及详情(POST /v1/music/detailed/stream)
    • 添加可选的 with_waveform_visual(布尔值,默认 false)。
    • 详情响应新增可为 null 的 waveform_visual(整数数组),每秒采样 4 次,取值范围为 -1000 到 1000。
  • 上传音乐 - POST /v1/music/upload
    • 在响应中添加可选的 with_waveform_visual(布尔值,默认 false)和可为 null 的 waveform_visual(整数数组)。

ElevenCreative

  • 创建 Studio 项目和创建播客
    • quality_preset 现接受 null,并移除了其 standard schema 默认值。

配音

  • 列出配音项目 - GET /v1/dubbing/project
    • page_size 仍为可选整数,默认值为 20,但现在会将值限制在 1–100,而非拒绝请求。
    • status 筛选器现说明 queued、preparing、ready 和 failed。
    • 将上一响应的 next_cursor 传入 cursor;获取第一页时省略该参数。
  • 列出语言目标 - GET /v1/dubbing/project/{project_id}/language
    • page_size 仍为可选整数,默认值为 20,但现在会将值限制在 1–100,而非拒绝请求。
    • status 筛选器支持 queued、processing、completed、stale 和 failed。
    • 将上一响应的 next_cursor 传入 cursor;获取第一页时省略该参数。

Schema 变更

工作区

  • PendingSubscriptionSwitchResponseModel.next_tier 新增 grant。

ElevenLabs CLI

ElevenLabs CLI v1.0.0 现已推出。每项 ElevenLabs API 操作都可作为子命令使用,支持 JSON、表格、YAML 和 CSV 输出、自动分页及 shell 补全。

CLI 还为 ElevenAgents 提供本地配置 workflow。可将智能体、工具和测试配置存为文件,通过 push 和 pull 命令同步,管理分支、运行测试、安装 ElevenLabs UI 组件,并选择数据驻留区域。

CLI 文档

安装 CLI、进行身份验证,并以代码方式管理智能体。

操作流程

操作流程现已在 ElevenAgents 中正式推出。操作流程包含针对特定任务的说明,以及决定何时应用这些说明的触发条件。对话期间,智能体会加载相关操作流程,让同一智能体无需将所有说明写入系统提示词,即可处理不同任务。

当智能体可以根据对话调整说明措辞或顺序时,请使用自由形式操作流程。需要按指定顺序执行步骤时,请使用结构化操作流程。两种类型都可与同一智能体上的 workflow 配合使用。

操作流程概览

了解何时使用操作流程,以及它们与提示词和 workflow 的区别。

自由形式操作流程

编写智能体可根据对话调整的自然语言说明。

结构化操作流程

定义智能体按一致顺序执行的类型化步骤。

ElevenAgents

  • 对话分诊工单:新增 API,可创建关于智能体表现的工单、创建手动跟进工单、列出工单、分配工作区成员、更新状态和受理人,以及添加工单级或轮次级评论。
  • 对话可观测性:实时客户端可在每次智能体轮次完成后接收 context_usage 事件。该事件会报告模型、提示词 token 数和模型上下文限制。

SDK 版本发布

JavaScript SDK

  • v2.65.0 - 新增对话分诊工单和轻量级对话摘要的客户端及类型。对话 API 新增操作流程、无效工具调用和排序筛选;操作流程 API 新增智能体版本选择;主题 API 新增评估详情控制和挫败感排序。此版本还新增知识库刷新频率、测试环境和告警集成字段,以及实时配音消息类型。

Python SDK

  • v2.65.0 - 新增对话分诊工单和轻量级对话摘要的客户端及类型。对话 API 新增操作流程、无效工具调用和排序筛选;操作流程 API 新增智能体版本选择;主题 API 新增评估详情控制和挫败感排序。此版本还新增知识库刷新频率、测试环境和告警集成字段,并保留语音转文本 keyterms 和配音 webhook_ids 的重复 multipart 字段。

Swift SDK

  • v3.3.0 - 新增类型化客户端错误解析、expects_response 处理和类型安全的工具结果。WebRTC 启动现在会在智能体加入时就绪,无需等待音轨订阅。此版本还增强了 URL 处理,抑制未知事件噪声,并从软件静音处理移除了实时线程分配。

软件包

  • @elevenlabs/client@1.19.1, @elevenlabs/react@1.12.3, @elevenlabs/react-native@1.2.21, @elevenlabs/convai-widget-core@0.16.2 和 @elevenlabs/convai-widget-embed@0.16.2 - 在严格内容安全策略下,WebRTC 输出捕获现在使用自托管的 AudioWorklet 路径。Worklet 缓存包含请求的源,避免较早的内联 URL 替换自托管路径。React Native 设置错误现在会指向 @elevenlabs/react-native。
  • @elevenlabs/client@1.20.0, @elevenlabs/react@1.12.4, @elevenlabs/react-native@1.2.22, @elevenlabs/convai-widget-core@0.16.3 和 @elevenlabs/convai-widget-embed@0.16.3 - 新增可选的 webRtc.iceTransportPolicy。在阻止直接 UDP 流量的网络中,将其设为 relay,可将 WebRTC ICE 候选限制为 TURN 中继。
  • @elevenlabs/client@1.21.0, @elevenlabs/react@1.13.0, @elevenlabs/types@0.21.1, @elevenlabs/react-native@1.2.23, @elevenlabs/convai-widget-core@0.16.4 和 @elevenlabs/convai-widget-embed@0.16.4 - 新增 onContextUsage 回调和 ContextUsageEvent 类型。React 通过 useConversation 提供该回调。React Native 现在通过其软件包导出条件解析,而非检测浏览器全局变量。
  • @elevenlabs/client@1.22.0, @elevenlabs/react@1.14.0, @elevenlabs/types@0.22.0, @elevenlabs/react-native@1.2.24, @elevenlabs/convai-widget-core@0.17.0 和 @elevenlabs/convai-widget-embed@0.17.0 - 新增带归因按钮响应的首条消息富内容、onExternalAgentDisconnected 和 onMCPToolApprovalRequest。WebRTC 现在使用所选输入设备,切换麦克风时保留静音状态,并会在无法发送初始化数据时终止设置。小组件新增并发队列状态、可选的折叠触发器语言选择,以及对同时支持文本和语音的智能体的首条消息渲染。

API

查看 API 变更

新增端点

ElevenAgents

  • 新增 9 个对话分诊工单端点:
    • 创建对话工单 - POST /v1/convai/triage-tickets。请求需要 conversation_id(字符串),并接受 qa_comment(可为 null 的字符串,1–10,000 个字符)以及最多 200 条轮次评论。
    • 列出工单 - GET /v1/convai/agents/{agent_id}/triage-tickets,支持游标分页。
    • 创建手动工单 - POST /v1/convai/agents/{agent_id}/triage-tickets。请求需要 qa_comment(字符串,1–10,000 个字符)。
    • 列出可分配用户 - GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users。响应会列出非服务账号的工作区成员,以及每位成员是否有权访问该智能体。
    • 获取工单 - GET /v1/convai/triage-tickets/{agentqa_ticket_id}。
    • 更新工单 - PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}。请求接受可选的 status 和可为 null 的 assignee_user_id。
    • 删除工单 - DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}。
    • 添加评论 - POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments。请求需要 comment(字符串,1–10,000 个字符)。
    • 添加轮次评论 - POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments。请求需要从 0 开始的 turn_index(整数)和 comment(字符串,1–10,000 个字符)。

更新的端点

ElevenAgents

  • 获取签名 URL - GET /v1/convai/conversation/get-signed-url
    • 新增可选的 debug_events_request(布尔值,默认 false)。调试事件需要智能体编辑者权限。
  • 获取 WebRTC token - GET /v1/convai/conversation/token
    • 新增可选的 debug_events_request(布尔值,默认 false)。旧版 GET /v1/convai/conversation/get_signed_url 路由接受相同参数。
  • 列出对话 - GET /v1/convai/conversations
    • 新增可选的 triggered_procedure_ids(可为 null 的字符串数组,最多 50 个),用于匹配运行过任一指定操作流程的对话。
    • 新增可选的 include_invalid_tool_calls(布尔值,默认 false),以包含未运行的工具调用。
    • 新增用于通话开始时间的可选 sort_direction(asc 或 desc,默认 desc)。
  • 文本搜索对话消息 - GET /v1/convai/conversations/messages/text-search
    • 新增可选的 triggered_procedure_ids(可为 null 的字符串数组,最多 50 个)。
    • 新增可选的 include_invalid_tool_calls(布尔值,默认 false)。
  • 获取智能体对话主题 - GET /v1/convai/agents/{agent_id}/topics
    • 新增可选的 include_evaluation_criteria(布尔值,默认 true)。
    • sort_by 新增 frustration。
    • 主题响应新增可为 null 的 success_rate(数字),整体响应新增 aggregated_run_count(整数,默认 0)。
    • from_unix_secs 会向下取整至其 UTC 日期的起始时间。有界范围会聚合已完成的每日发现运行;省略两个边界则返回最新运行。
  • 列出操作流程(GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures)和 获取操作流程(GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id})
    • 新增可选且可为 null 的 agent_version_id(字符串),用于从特定智能体版本获取操作流程。
  • 创建测试 和 更新测试
    • 响应、模拟和工具调用单元测试 schema 新增可选且可为 null 的 environment(字符串)。该值用于选择特定环境的 URL、标头和身份验证连接;默认为 production。
  • 创建 URL 文档、创建爬取任务 和 创建文件夹
    • 自动同步新增可选且可为 null 的 minimum_frequency_days(整数,1–180)。默认值为 7,更严格的父文件夹频率优先。

音乐

  • 列出音乐 Finetune - GET /v1/music/finetunes
    • 最大 page_size 从 100 提高到 150。默认值仍为 50。

Schema 变更

ElevenAgents

  • 智能体更新请求新增可选且可为 null 的 procedures(object<string, ProcedureVersionRef>)。每个值都需要 procedure_id 和 version_id(字符串)。空对象会移除所有操作流程。
  • 对话初始化配置新增 enable_procedure_ids_from_client(布尔值,默认 false)。初始化数据新增可选且可为 null 的 procedure_ids(字符串数组);空数组会禁用起始智能体的所有操作流程。
  • ClientEvent 新增 context_usage。
  • 软超时覆盖新增可选且可为 null 的 additional_soft_timeout_messages(字符串数组)。
  • 分析和 schema 覆盖模型中的常量值现在接受 null。
  • 小组件配置中 mic_muting_enabled 和 transcript_enabled 的默认值已从 false 改为 true。请显式将其设为 false 以保留此前行为。

工作区

  • 获取用户 响应已从 UserResponseModel 移除 xi_api_key。
  • ResourceMetadataResponseModel.role_to_group_ids 现在接受自定义角色 ID 作为键,不再将键限制为 admin、editor、commenter 和 viewer。
  • 直接发布响应新增可选且可为 null 的 restricted_to_user_email_domains(字符串数组)。
  • 待处理订阅切换响应的 next_tier 新增 go。

MCP 服务器

  • 本地 MCP 服务器已弃用:本地 ElevenLabs MCP 服务器和 MCP 播放器已弃用,建议改用托管 MCP 服务器。两个仓库均已归档,不再接收更新。托管服务器位于 https://api.elevenlabs.io/v1/mcp,可通过 OAuth 使用 ElevenLabs 账户登录,无需本地安装或 API 密钥。有关 Claude、Cursor 和其他 MCP 客户端的设置说明,请参阅托管 MCP 服务器文档。

ElevenCreative

  • 图像、视频和语音生成 API:新的异步 Flows API 可创建、列出和获取视频、图像及语音生成任务。生成响应提供 pending、generating、completed 和 failed 状态,请求还可包含用于接收完成事件的 Webhook 目标。
  • 可复用媒体资源:新的资源 API 可上传、列出、获取和删除工作区媒体。图像、视频和音频引用可使用已上传资源、之前的生成结果或内联 base64 数据,从而串联生成任务。参阅引用和资源。

ElevenAgents

  • 轻量级对话摘要:获取对话摘要返回生成的标题、转录摘要、通话结果,以及无需加载完整转录的纯用户或智能体消息。可选的 max_messages 查询参数为介于 1 到 200 之间的整数(默认 40);较长的对话会将 messages_omitted 设为 true。适用于需要保留上下文的智能体。
  • 对话主题分页和排序:获取智能体对话主题新增可选的游标分页和排序。使用 page_size(整数,1–100)、cursor(字符串)、sort_by(conversations、sentiment 或 success_rate)和 sort_direction(asc 或 desc)。响应新增 has_more 和可为空的 next_cursor。
  • 并发等待队列:智能体平台设置新增可选的 queueing(AgentQueueingConfig)。当智能体达到并发限制时,将 enabled 设为 true 可让来电者等待;wait_timeout_seconds 为最高 1,800 的整数(默认 180)。
  • 轮次和工作流控制:轮次配置新增 merge_with_default_ignore_terms(布尔值,默认 false),用于将自定义中断词与精选默认词合并。软超时新增 disable_until_first_user_message(布尔值,默认 false),工作流工具定位器新增可选的 schema_overrides,用于按节点覆盖参数。
  • 背景音频默认值:BackgroundSoundConfig.volume 默认值现从 0.6 改为 0.15,crossfade_loop 默认值现从 false 改为 true。请显式设置这些字段以保留原有行为。

SDK 发布

JavaScript SDK

  • v2.64.0 - 新增 client.assets,可上传、列出、获取和删除资源;新增 client.flows,用于异步生成视频、图像和语音。轮次配置新增 mergeWithDefaultIgnoreTerms。从 WorkspaceGroupResponseModel 中移除 CustomToolApiSchemaConfig 和 scimExternalId。

Python SDK

  • v2.64.0 - 新增资源和 Flows 客户端,用于异步生成视频、图像和语音;轮次配置新增 merge_with_default_ignore_terms。本地部署会话设置新增 extra_setup_config,用于传递其他设置消息字段。

软件包

  • @elevenlabs/client@1.18.0, @elevenlabs/react@1.12.1, @elevenlabs/types@0.20.0, @elevenlabs/react-native@1.2.19, @elevenlabs/convai-widget-core@0.16.0 和 @elevenlabs/convai-widget-embed@0.16.0 - 新增实验性的自托管编排器会话和富内容事件。Scribe 音频 worklet 现可自托管,以满足严格的内容安全策略。断开连接处理现在会稳定进入 disconnected 状态,并防止延迟回调清除较新的会话。组件可内联呈现快捷回复和链接,恢复语音转录中的 Markdown,并修复容器查询布局中的语言菜单定位。
  • @elevenlabs/client@1.19.0, @elevenlabs/react@1.12.2, @elevenlabs/types@0.21.0, @elevenlabs/react-native@1.2.20 和 @elevenlabs/convai-widget-core@0.16.1 - 新增实时语音转文本选项,支持次要语言、实体检测和背景音频过滤。新增最终转录、检测到的实体和无效请求事件;使时间戳单词类型与实时架构保持一致;并修复阻止 useScribe 重新连接的麦克风权限失败问题。

API

查看 API 变更

新增端点

ElevenCreative

  • 创建视频生成任务 - POST /v1/flows/video
  • 列出视频生成任务 - GET /v1/flows/video
  • 获取视频生成任务 - GET /v1/flows/video/{generation_id}
  • 创建图像生成任务 - POST /v1/flows/image
  • 列出图像生成任务 - GET /v1/flows/image
  • 获取图像生成任务 - GET /v1/flows/image/{generation_id}
  • 创建语音生成任务 - POST /v1/flows/text-to-speech
  • 列出语音生成任务 - GET /v1/flows/text-to-speech
  • 获取语音生成任务 - GET /v1/flows/text-to-speech/{generation_id}
  • 上传资源 - POST /v1/assets
  • 列出资源 - GET /v1/assets
  • 获取资源 - GET /v1/assets/{asset_id}
  • 删除资源 - DELETE /v1/assets/{asset_id}

ElevenAgents

  • 获取对话摘要 - GET /v1/convai/conversations/{conversation_id}/summary
    • 接受可选的 max_messages(整数,1–200,默认 40)
    • 返回 GetConversationSummaryResponseModel,其中必填 conversation_id、agent_id、status、message_count 和 note
    • 纯 messages 仅包含 role(user 或 agent)和 message;超过限制的对话返回 messages_omitted: true

已更新端点

ElevenAgents

  • 获取实时数量 - GET /v1/convai/analytics/live-count
    • 新增可选的 agent_ids(字符串数组,最多 25 个),其优先级高于 agent_id
  • 获取智能体对话主题 - GET /v1/convai/agents/{agent_id}/topics
    • 新增可选的 page_size(整数,1–100)、cursor(字符串)、sort_by(conversations、sentiment 或 success_rate)和 sort_direction(asc 或 desc)
    • 响应新增 has_more(布尔值,默认 false)和可为空的 next_cursor(字符串)

架构变更

ElevenAgents

  • 智能体平台设置新增可选的 queueing(AgentQueueingConfig)。它包含 enabled(布尔值,默认 false)和 wait_timeout_seconds(大于 0 且最多 1,800 的整数,默认 180)
  • WorkflowToolLocator 新增可选的 schema_overrides;按节点的常量、动态变量、LLM 或省略覆盖优先于工具级覆盖
  • 轮次配置及相关覆盖架构新增 merge_with_default_ignore_terms(布尔值,默认 false)
  • 软超时配置及相关覆盖架构新增 disable_until_first_user_message(布尔值,默认 false)
  • 实时智能体工具响应事件新增必填只读 status(success、error、blocked 或 skipped)
  • 对话发起来源新增 avaya,授权方式新增 avaya_api_key
  • 支持的智能体 LLM 值新增 gemini-3.6-flash 和 gemini-3.7-flash
  • BackgroundSoundConfig.volume 默认值从 0.6 改为 0.15,crossfade_loop 默认值从 false 改为 true
  • 移除 CustomToolApiSchemaConfig;导入此类型的生成 SDK 用户必须移除该导入
  • 从 WorkspaceGroupResponseModel 中移除 scim_external_id