Changelog

September 14, 2026

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 不支持的工作流程。

软件包

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 功能状态。