> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

### ElevenAgents

- **通话排队和等待音频**：为达到并发上限的智能体新增[通话排队](/docs/zh/eleven-agents/guides/call-queueing)。排队中的来电者会听到等待音频，并持续收到 `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](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.68.0) - 新增上传和删除智能体等待音频的方法。重新生成了通话排队、流程引用、草稿分支创建、RAG 查询限制、测试版本元数据、`gemini-3.8-flash` 和 `music_v2_5` 的类型。

#### Python SDK

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

#### iOS SDK

- [v3.3.1](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.3.1) - 现按 `response_id` 而非 `event_id` 协调智能体消息，可保留工具调用前后的多个响应，并防止流式片段或修正内容附加到错误的消息。

#### ElevenLabs CLI

- [v1.3.0](https://github.com/elevenlabs/cli/releases/tag/v1.3.0) - 为生成的 API 命令新增可选 `--intent` 元数据。新增 `elevenlabs feedback missing-capability`，用于报告 CLI 不支持的工作流程。

#### 软件包

- [@elevenlabs/convai-widget-core@0.18.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.2) 和 [@elevenlabs/convai-widget-embed@0.18.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.2) - 修复工具和流程调用后出现重复智能体回复的问题。流式文本回复会保留 Markdown 格式，语音对话也不再渲染未说出的流式聊天片段。嵌入软件包还将 `user_activity` 事件限制为每秒一次，并在会话结束时清除该限制。

### API

<Accordion title="查看 API 变更">

## 新增端点

### ElevenAgents

- [上传智能体等待音频](/docs/zh/api-reference/agents/hold-audio/create) - `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`（整数）。
- [删除智能体等待音频](/docs/zh/api-reference/agents/hold-audio/delete) - `DELETE /v1/convai/agents/{agent_id}/hold-audio`
  - 删除自定义片段，使排队来电者听到默认等待音。
  - 返回必填的 `agent_id`（字符串）。

## 更新的端点

### ElevenAgents

- [创建智能体](/docs/zh/api-reference/agents/create)、[获取智能体](/docs/zh/api-reference/agents/get) 和 [更新智能体](/docs/zh/api-reference/agents/update)
  - 新增可选 `platform_settings.queueing_config`（`AgentQueueingConfig`），包含 `enabled`（布尔值，默认 `false`）和 `wait_timeout_seconds`（整数，1–1,800，默认 `180`）。
  - 队列配置响应包含只读、可为空的 `hold_audio`（`AgentHoldAudioConfig`）。智能体响应还包含可选 `default_hold_audio_url`（字符串）。
- [获取对话](/docs/zh/api-reference/conversations/get) - `GET /v1/convai/conversations/{conversation_id}`
  - 元数据新增可选、可为空的 `queue_wait_secs`（数字）。排队时间不计入 `call_duration_secs` 和计费时长。
- [创建智能体分支](/docs/zh/api-reference/agents/branches/create) - `POST /v1/convai/agents/{agent_id}/branches`
  - 新增可选 `include_draft`（布尔值，默认 `false`）。设为 `true` 时，从分支顶端创建的分支会包含调用方的草稿流程集。
- [列出流程](/docs/zh/api-reference/agents/procedures/list)以及流程创建、获取和草稿端点
  - 列表项新增可选 `referenced_tool_ids`、`referenced_kb_ids`、`referenced_procedure_ids` 和 `referenced_dynamic_variables`（字符串数组）。
  - 智能体和合并预览响应新增可选 `procedures`，这是一个以流程 ID 为键的映射。
- [列出测试调用](/docs/zh/api-reference/tests/test-invocations/list) - `GET /v1/convai/test-invocations`
  - 新增可选、可为空的 `search`（字符串），可按名称筛选测试和文件夹。
- [在智能体上运行测试](/docs/zh/api-reference/tests/run-tests)和[获取测试调用](/docs/zh/api-reference/tests/test-invocations/get)
  - 测试套件调用和单元测试运行响应新增可选、可为空的 `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 账户](/docs/zh/api-reference/whats-app/accounts/get) - `GET /v1/convai/whatsapp-accounts/{phone_number_id}`
  - 新增可选 `account_type`（`WhatsAppAccountType`，默认 `cloud_api`）。可选值为 `cloud_api` 和 `coexistence`。
- [计算预期 LLM 用量](/docs/zh/api-reference/agents/calculate) - `POST /v1/convai/agent/{agent_id}/llm-usage/calculate`
  - `LLMUsageCalculatorLLMResponseModel` 新增必填 `price_per_message`（数字）。

### 音乐

- `MusicModelID` 为 `POST /v1/music/video-to-music`、`POST /v1/music/plan`、[创作音乐](/docs/zh/api-reference/music/compose)、`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` 功能状态。

</Accordion>