> 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

- **WhatsApp 分支和环境覆盖**：[Outbound WhatsApp messages](/docs/zh/api-reference/whats-app/outbound-message) 和 [outbound calls](/docs/zh/api-reference/whats-app/outbound-call) 现在会遵循 `conversation_initiation_client_data` 中传入的 `branch_id` 和 `environment`。所有消息发送前都会验证覆盖项——未知分支或环境会报错拒绝——并且会在整个对话期间持续生效，因此客户回复后会在指定的 [分支](/docs/zh/eleven-agents/operate/versioning) 和 [环境](/docs/zh/eleven-agents/integrate/environment-variables) 中继续对话。示例请参阅 [WhatsApp 指南](/docs/zh/eleven-agents/whatsapp)。
- **流程 API**：新增 8 项面向公众、限定分支范围的操作，用于管理[流程](/docs/zh/eleven-agents/customization/procedures)。你可以创建、列出、获取和删除流程；创建、获取或丢弃草稿更改；以及将流程草稿编译为智能体 workflow。创建流程时可传入 `name`、`content`、`type` 和 `trigger`。空 `trigger` 会创建子流程；省略 `trigger` 或将其设为 `null` 时，会根据流程内容推导触发条件。
- **知识库爬取任务**：新增用于创建、列出、查看和取消爬取任务的 API。创建请求需要 `url`（字符串），并支持爬取深度、页面数量限制、URL 模式、站点地图 URL、文件夹放置位置、自动同步和移除不可用文档。
- **知识库批量管理**：新增针对 1–20 个唯一文档或文件夹 ID 的[批量依赖项检查](/docs/zh/api-reference/knowledge-base/dependent-agents-multiple)和[批量删除](/docs/zh/api-reference/knowledge-base/bulk-delete)。依赖项检查支持分页和 `dependent_type`；删除操作会为每个 ID 分别返回成功或失败结果。设置 `force: true` 还会移除依赖项，并递归删除非空文件夹。
- **批量通话结果导出**：新增[导出批量通话结果](/docs/zh/api-reference/batch-calling/export)，可将已结束批次的收件人和对话结果下载为 CSV。
- **对话筛选和分析数据**：[列出对话](/docs/zh/api-reference/conversations/list)和[文本搜索对话消息](/docs/zh/api-reference/conversations/messages/text-search)新增可选的 `visited_agent_ids` 和 `visited_agent_branch_ids` 数组筛选条件，每项最多包含 50 个值。列出请求还接受 `data_collection_ids` 和 `evaluation_criteria_ids`，以在每个对话摘要中包含对应结果。摘要新增可选的 `data_collection_results`、`evaluation_criteria_results` 和 `tag_ids`。
- **引用式分析配置**：智能体平台设置新增可选且可为 null 的 `analysis_items` 字段，类型为 `AgentAnalysisItems`，用于通过引用关联评估和数据收集项。值为 `null` 表示智能体仍使用旧版内联字段；空值表示已迁移的智能体未关联任何项目。
- **流程依赖项元数据**：流程引用新增 `trigger`（字符串），以及 `referenced_tool_ids`、`referenced_kb_ids`、`referenced_procedure_ids` 和 `referenced_dynamic_variables` 数组。
- **WebRTC 令牌响应**：[获取 WebRTC 令牌](/docs/zh/api-reference/conversations/get-webrtc-token)响应除 `token` 外，现在还必须包含 `conversation_id`（字符串）。对于验证或反序列化响应结构的客户端，这是一次破坏性架构变更。
- **知识库 RAG 结果**：`KnowledgeBaseRagToolResultModel` 新增 `chunks`（`KnowledgeBaseRagChunkModel[]`），用于工具结果中的 RAG 结果模式。

### Studio

- **项目草稿状态**：`ProjectCreationMetaResponseModel.status` 新增 `draft`。项目创建类型现在使用共享的 `ProjectCreationMetaType` 枚举，现有值保持不变。

### 音色

- **音色口音**：新增 `GET /v1/voices/accents`，用于列出共享声音库中可用的口音。结果可按 `language` 和 `model_id` 筛选，每种口音都会返回 `accent`、`language`、`code` 和人类可读的 `name`。可将 `accent` 值传给[获取共享音色](/docs/zh/api-reference/voices/voice-library/get-shared)的 `accent` 查询参数，以筛选共享音色。

### 工作区

- **Webhook 用量报告**：`WebhookUsageType` 新增 `Flows`。

### SDK 发布

#### JavaScript SDK

- [v2.60.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.60.0) - 新增 `voices.accents.get`，用于列出共享声音库中的音色口音；还新增了最新架构中的 ElevenAgents 流程、知识库爬取任务、批量管理 API 和引用式分析配置。

#### Python SDK

- [v2.60.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.60.0) - 新增最新架构中的音色口音、ElevenAgents 流程、知识库爬取任务和批量管理 API。同时修复了 `AsyncConversation` 启动时的阻塞问题，并修正了基本类型列表 multipart 字段的发送方式，使其作为重复表单字段发送。

#### 软件包

- [@elevenlabs/client@1.15.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.15.2) - 修复 WebRTC 传输上的 `onAudioAlignment`：从音频消息转发对齐元数据，同时仍通过 LiveKit 轨道播放音频。
- [@elevenlabs/react@1.10.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.10.2)、[@elevenlabs/react-native@1.2.16](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.16)、[@elevenlabs/convai-widget-core@0.14.12](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.12) 和 [@elevenlabs/convai-widget-embed@0.14.12](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.12) - 更新依赖项，包含来自 `@elevenlabs/client@1.15.2` 的 WebRTC 对齐修复。

### API

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

## 新增端点

### ElevenAgents

- `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`
  - 创建流程并返回其 `procedure_id`（字符串）
  - 接受可选的 `name`（字符串，最多 200 个字符）、`content`（字符串）、`type`（`ProcedureType`，默认 `free_form`）和 `trigger`（可为 null 的字符串）
- `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`
  - 列出分支流程，包含 `procedure_id`、`version_id`、`name`、`type`、`trigger` 和 `has_draft`
  - 不包含流程内容；请获取单个流程以读取其内容
- `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`
  - 接受可选的 `version_id`（字符串）；否则返回分支头部的版本
  - 返回 `name`、`content`、`type` 和 `trigger`
- `DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`
  - 从分支的草稿工作集中移除流程
- `GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft`
  - 返回当前流程草稿
- `PATCH /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft`
  - 创建或更新草稿
  - 需要 `name`（字符串，最多 200 个字符）、`content`（字符串，最多 50,000 个字符）和 `type`（`ProcedureType`）；接受可选的 `trigger`（可为 null 的字符串）
- `DELETE /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}/draft`
  - 丢弃草稿更改，并将流程重置为已提交版本
- `POST /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/compile`
  - 将流程草稿编译为 `AgentWorkflowResponseModel`
- [创建爬取任务](/docs/zh/api-reference/knowledge-base/create-crawl-job) - `POST /v1/convai/knowledge-base/crawl`
  - 需要 `url`（字符串）
  - 接受可选的 `max_depth`（整数，1–5，默认 `3`）、`max_pages`（整数，1–10,000，默认 `1000`）、`pattern`（字符串）、`sitemap_urls`（字符串数组）、`parent_folder_id`（字符串）、`enable_auto_sync`（布尔值，默认 `false`）和 `auto_remove`（布尔值，默认 `false`）
- [列出爬取任务](/docs/zh/api-reference/knowledge-base/list-crawl-jobs) - `GET /v1/convai/knowledge-base/crawl`
  - 接受可选的 `include_job_ids`（字符串数组）、`page_size`（整数，1–100，默认 `30`）和 `cursor`（字符串）
- [获取爬取任务](/docs/zh/api-reference/knowledge-base/get-crawl-job) - `GET /v1/convai/knowledge-base/crawl/{crawl_job_id}`
- [取消爬取任务](/docs/zh/api-reference/knowledge-base/cancel-crawl-job) - `POST /v1/convai/knowledge-base/crawl/{crawl_job_id}/cancel`
- [获取多个文档的依赖智能体](/docs/zh/api-reference/knowledge-base/dependent-agents-multiple) - `POST /v1/convai/knowledge-base/dependent-agents`
  - 需要 `document_ids`（包含 1–20 个唯一字符串的数组）
  - 接受可选的 `dependent_type`（`KnowledgeBaseDependentType`，默认 `all`）、`page_size`（整数，1–100，默认 `30`）和 `cursor`（字符串）
- [批量删除知识库文档](/docs/zh/api-reference/knowledge-base/bulk-delete) - `POST /v1/convai/knowledge-base/bulk-delete`
  - 需要 `document_ids`（包含 1–20 个唯一字符串的数组）
  - 接受可选的 `force`（布尔值，默认 `false`）
  - 为每个文档 ID 返回成功或失败结果
- [导出批量通话结果](/docs/zh/api-reference/batch-calling/export) - `GET /v1/convai/batch-calling/{batch_id}/export`
  - 将已结束批次的收件人和对话结果作为 CSV 返回

### 音色

- `GET /v1/voices/accents`
  - 列出共享声音库中可用的口音
  - 接受可选的 `language`（字符串）和 `model_id`（字符串）查询参数
  - 每种口音返回 `accent`、`language`、`code` 和 `name`

## 已更新端点

### ElevenAgents

- [列出对话](/docs/zh/api-reference/conversations/list) - `GET /v1/convai/conversations`
  - 新增可选的 `visited_agent_ids` 和 `visited_agent_branch_ids` 字符串数组筛选条件，每项最多包含 50 个值
  - 新增可选的 `data_collection_ids` 和 `evaluation_criteria_ids` 字符串数组，用于选择每个摘要的分析结果
  - 响应摘要新增可选对象字段 `data_collection_results` 和 `evaluation_criteria_results`，以及字符串数组 `tag_ids`
- [文本搜索对话消息](/docs/zh/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
  - 新增可选的 `visited_agent_ids` 和 `visited_agent_branch_ids` 字符串数组筛选条件，每项最多包含 50 个值
- [获取 WebRTC 令牌](/docs/zh/api-reference/conversations/get-webrtc-token) - `GET /v1/convai/conversation/token`
  - 响应现在必须包含 `conversation_id`（字符串）
  - 破坏性变更：严格的响应验证器和反序列化器必须接受新的必填字段

## 架构变更

### ElevenAgents

- 智能体平台请求和响应设置新增可选且可为 null 的 `analysis_items` 字段，类型为 `AgentAnalysisItems`，用于引用式评估和数据收集配置
- 流程引用新增 `trigger`（字符串）、`referenced_tool_ids`（字符串数组）、`referenced_kb_ids`（字符串数组）、`referenced_procedure_ids`（字符串数组）和 `referenced_dynamic_variables`（字符串数组）
- `KnowledgeBaseRagToolResultModel` 新增 `chunks`（`KnowledgeBaseRagChunkModel[]`）

### Studio

- `ProjectCreationMetaResponseModel.status` 新增 `draft`
- `ProjectCreationMetaResponseModel.type` 现在引用共享的 `ProjectCreationMetaType` 枚举

### 工作区

- `WebhookUsageType` 新增 `Flows`

</Accordion>