> 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

- **测试专用工具模拟**：智能体模拟和单元测试现在可定义以工具 ID 为键的 `tool_mock_overrides`，以替换单项测试的共享模拟。`ToolResponseMockConfig` 还新增可选的 `is_error`（布尔值，默认 `false`），让模拟可以测试工具失败路径。
- **已翻译的 workflow 消息**：字面量 Say 节点消息新增 `text_translations`，这是从语言键到 `TranslatedString` 对象的映射。该字段在输入中可选、在输出中必填，因此严格的响应验证器必须接受它。
- **对话版本筛选**：[列出对话](/docs/zh/api-reference/conversations/list)和[文本搜索对话消息](/docs/zh/api-reference/conversations/messages/text-search)新增可选的 `version_id` 查询参数（字符串），用于按智能体版本筛选结果。
- **知识库系统工具**：智能体配置新增 `knowledge_base` 系统工具，其中可配置 `enabled_strategies`（`SearchStrategy[]`）。智能体知识库 RAG 查询新增可选的 `use_agent_defaults`（布尔值，默认 `true`）；将其设为 `false` 可使用中性检索设置，同时保留智能体的嵌入模型。
- **智能体语音活动检测**：智能体创建、更新、响应和 workflow 覆盖架构新增 `vad` 配置。`VADConfig` 目前支持 `background_voice_detection`（布尔值，默认 `false`）。
- **WebSocket 自定义 LLM**：`CustomLLMAPIType` 新增 `websocket`。
- **文件内存控制**：小组件文件输入配置新增 `max_files_in_memory`（整数，1–30，默认 `10`）。超过限制的文件会被摘要化并从内存中释放；`max_files_per_conversation` 必须为 `-1` 或至少等于内存限制。
- **DTMF 输入脱敏**：`DTMFInputConfig` 新增可选的 `redact_input`（布尔值，默认 `false`），用于替换转写文本、对话日志和分析中的来电者键盘数字。智能体重复的数字或传给工具的数字保持不变。

### 语音转文本

- **实时实体检测**：Scribe v2 Realtime 新增 `entity_detection` 查询选项。它接受 `all`、单个实体类型或类别，或类型和类别数组，并在 `committed_transcript_entities` 事件中输出检测到的实体。支持的类别请参阅[实体检测指南](/docs/zh/eleven-api/guides/how-to/speech-to-text/batch/entity-detection)。

### 音色

- **跨数据驻留地复制音色**：新增 `POST /v1/voices/{voice_id}/replicate-to-isolated-environment`，用于将即时语音克隆或声音设计音色复制到同一合并计费组中的工作区。请求需要 `target_workspace_id`（字符串），并接受 `preserve_voice_id`（布尔值，默认 `true`）；响应返回目标 `voice_id`。
- **角色元数据**：角色响应新增 `recommended_voice_ids`（字符串数组，默认 `[]`），元数据新增可为 null 的 `role`（`CharacterRole`），并且 `CharacterAge` 将 `middle-aged` 替换为 `middle_aged`。

### SDK 发布

#### 软件包

- [@elevenlabs/client@1.16.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.16.0)、[@elevenlabs/react@1.11.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.11.0)、[@elevenlabs/types@0.18.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.18.0)、[@elevenlabs/react-native@1.2.17](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.17) 和 [@elevenlabs/convai-widget-core@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.0) - 新增 `onAgentReasoningResponsePart`，用于接收类型为 `start`、`delta` 和 `stop` 的流式智能体推理事件。
- [@elevenlabs/convai-widget-core@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.0) 和 [@elevenlabs/convai-widget-embed@0.15.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.15.0) - 新增 `show_resize_button` 和 `show-resize-button` 嵌入属性。将其中任一项设为 `false`，即可隐藏小组件标题栏的展开和收起控件。
- [@elevenlabs/client@1.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.17.0)、[@elevenlabs/react@1.12.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.0)、[@elevenlabs/types@0.19.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.19.0)、[@elevenlabs/react-native@1.2.18](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.18) 和 [@elevenlabs/convai-widget-core@0.15.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.15.1) - 为 `Scribe.connect` 和 `useScribe` 新增 `enableLogging` 选项。将其设为 `false` 会启动企业版零保留会话。Scribe 的 `session_started` 类型现在会报告 `enable_logging`；已移除未使用的 `disable_logging` 字段。

#### MCP 服务器

- [v0.12.1](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.12.1) - 包含 v0.11 工具更新和依赖项刷新，解决了 44 个安全警报。
- [v0.11.0](https://github.com/elevenlabs/elevenlabs-mcp/releases/tag/v0.11.0) - 新增 `simulate_conversation`，支持配置模拟用户行为、评估标准、转写输出和通过/失败分析。`speech_to_text` 工具现在默认使用 `scribe_v2`，`voice_clone` 现在发送音频文件内容而非路径字符串。

### API

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

## 新增端点

### 音色

- `POST /v1/voices/{voice_id}/replicate-to-isolated-environment`
  - 将即时语音克隆或声音设计音色复制到其他工作区的隔离环境
  - 需要 `target_workspace_id`（字符串）
  - 接受可选的 `preserve_voice_id`（布尔值，默认 `true`）
  - 返回必填的 `voice_id`（字符串）

## 已更新端点

### ElevenAgents

- [列出对话](/docs/zh/api-reference/conversations/list) - `GET /v1/convai/conversations`
  - 新增可选的 `version_id`（字符串）查询参数
- [文本搜索对话消息](/docs/zh/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
  - 新增可选的 `version_id`（字符串）查询参数
- `POST /v1/convai/agents/{agent_id}/knowledge-base/rag-query`
  - 新增可选的 `use_agent_defaults`（布尔值，默认 `true`）请求字段

## 架构变更

### ElevenAgents

- 模拟和单元测试负载新增可选的 `tool_mock_overrides` 映射；`ToolResponseMockConfig` 新增可选的 `is_error`（布尔值，默认 `false`）
- `SayNodeLiteralMessage` 新增 `text_translations`（`TranslatedString` 映射）；该字段在输入中可选、在输出中必填
- 智能体配置新增 `knowledge_base`（`KnowledgeBaseToolConfig`）和 `vad`（`VADConfig`）
- `CustomLLMAPIType` 新增 `websocket`
- `FileInputConfig` 新增 `max_files_in_memory`（整数，1–30，默认 `10`）
- `DTMFInputConfig` 新增可选的 `redact_input`（布尔值，默认 `false`）
- 实时智能体配置现在默认使用 `eleven_realtime_v1_mini`

### 音色

- 角色响应新增 `recommended_voice_ids`（字符串数组，默认 `[]`）
- 角色元数据新增可为 null 的 `role`（`CharacterRole`）
- 破坏性变更：`CharacterAge` 将 `middle-aged` 替换为 `middle_aged`；发送旧值的客户端必须迁移

### 文本转语音

- 破坏性变更：已从 ElevenAgents 文本转语音配置架构中移除 `AudioFilterId` 和 `audio_filter`

</Accordion>