> 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/api-reference/triage-tickets/list-for-workspace)，可获取有访问权限的智能体中的对话分诊工单。可按状态或负责人筛选，并使用游标分页，每页最多获取 100 个工单。
- **动态变量对话筛选**：[列出对话](/docs/zh/api-reference/conversations/list)和[文本搜索对话消息](/docs/zh/api-reference/conversations/messages/text-search)现接受可重复的 `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` 字段已弃用。
- **智能体元数据**：[列出智能体分支](/docs/zh/api-reference/agents/branches/list)响应现会指明草稿的创建时间，以及它是否早于分支最新提交。智能体和语音引擎摘要现在要求提供 `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](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.67.0) - 在对话列表和文本搜索请求中添加 `dynamicVariableParams`。重新生成 Twilio 答录机检测、数据收集值约束、API 密钥平台限制、智能体分支草稿元数据和知识库源 URL 的类型。

#### Python SDK

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

#### ElevenLabs CLI

- [v1.2.0](https://github.com/elevenlabs/cli/releases/tag/v1.2.0) - 添加 `elevenlabs say` 命令及其智能体技能，重新生成 API 命令绑定，并将 `eleven_v3` 设为默认 TTS 模型。

#### 软件包

- [@elevenlabs/client@1.25.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.25.0)、[@elevenlabs/react@1.15.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.15.2)、[@elevenlabs/react-native@1.2.27](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.27)、[@elevenlabs/convai-widget-core@0.18.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.1) 和 [@elevenlabs/convai-widget-embed@0.18.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.1) - 从 `@elevenlabs/client` 重新导出 `MessageAttachment`，以便使用者直接导入该类型。
- [@elevenlabs/client@1.24.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.24.0)、[@elevenlabs/types@0.23.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.23.0)、[@elevenlabs/react@1.15.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.15.1)、[@elevenlabs/react-native@1.2.26](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.26)、[@elevenlabs/convai-widget-core@0.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.18.0) 和 [@elevenlabs/convai-widget-embed@0.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.18.0) - 将智能体响应文件附件转发至 `onMessage`，并新增可选的 `webRtc.singlePeerConnection` 会话设置。组件还对问候按钮进行了本地化，并修复了文本聊天响应丢失或重复的问题。

### API

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

## 新增端点

### ElevenAgents

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

## 已更新端点

### ElevenAgents

- [列出对话](/docs/zh/api-reference/conversations/list) - `GET /v1/convai/conversations`
  - 添加可选且可为 null 的 `dynamic_variable_params`（可重复字符串数组）。每个值使用 `name:op:value` 格式，其中 `op` 为 `eq`、`gt`、`gte`、`lt` 或 `lte`。
- [文本搜索对话消息](/docs/zh/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
  - 添加具有相同语法的可选且可为 null 的 `dynamic_variable_params`（可重复字符串数组）。
- [Twilio 外呼](/docs/zh/api-reference/twilio/outbound-call)、[SIP 中继外呼](/docs/zh/api-reference/sip-trunk/outbound-call)、[Exotel 外呼](/docs/zh/api-reference/exotel/outbound-call)和[提交批量呼叫](/docs/zh/api-reference/batch-calling/submit)
  - `telephony_call_config` 现使用独立的输入和输出 schema。
  - 添加可选且可为 null 的 `twilio_machine_detection`（`TwilioMachineDetectionConfig`）。其 `mode` 接受 `enable` 或 `detect_message_end`，默认值为 `enable`。非 Twilio 服务商和呼入电话会忽略此设置。
- [导入电话号码](/docs/zh/api-reference/phone-numbers/create) - `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`。字段和线缆格式保持不变。

</Accordion>