> 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.

import { YoutubeEmbed } from "../../../components/YoutubeEmbed";

### ElevenLabs CLI

[ElevenLabs CLI v1.0.0](https://github.com/elevenlabs/cli/releases/tag/v1.0.0) 现已推出。每项 ElevenLabs API 操作都可作为子命令使用，支持 JSON、表格、YAML 和 CSV 输出、自动分页及 shell 补全。

CLI 还为 ElevenAgents 提供本地配置 workflow。可将智能体、工具和测试配置存为文件，通过 push 和 pull 命令同步，管理分支、运行测试、安装 ElevenLabs UI 组件，并选择数据驻留区域。

<YoutubeEmbed id="MuORAEVtJIQ" />

<CardGroup cols={1}>
  <Card
    title="CLI 文档"
    icon="duotone book"
    href="/docs/zh/eleven-agents/operate/cli"
  >
    安装 CLI、进行身份验证，并以代码方式管理智能体。
  </Card>
</CardGroup>

### 操作流程

操作流程现已在 ElevenAgents 中正式推出。操作流程包含针对特定任务的说明，以及决定何时应用这些说明的触发条件。对话期间，智能体会加载相关操作流程，让同一智能体无需将所有说明写入系统提示词，即可处理不同任务。

当智能体可以根据对话调整说明措辞或顺序时，请使用自由形式操作流程。需要按指定顺序执行步骤时，请使用结构化操作流程。两种类型都可与同一智能体上的 workflow 配合使用。

<CardGroup cols={3}>
  <Card
    title="操作流程概览"
    icon="duotone book"
    href="/docs/zh/eleven-agents/customization/procedures"
  >
    了解何时使用操作流程，以及它们与提示词和 workflow 的区别。
  </Card>
  <Card
    title="自由形式操作流程"
    icon="duotone code"
    href="/docs/zh/eleven-agents/customization/procedures/free-form-procedures"
  >
    编写智能体可根据对话调整的自然语言说明。
  </Card>
  <Card
    title="结构化操作流程"
    icon="duotone list-check"
    href="/docs/zh/eleven-agents/customization/procedures/structured-procedures"
  >
    定义智能体按一致顺序执行的类型化步骤。
  </Card>
</CardGroup>

### ElevenAgents

- **对话分诊工单**：新增 API，可创建关于智能体表现的工单、创建手动跟进工单、列出工单、分配工作区成员、更新状态和受理人，以及添加工单级或轮次级评论。
- **对话可观测性**：实时客户端可在每次智能体轮次完成后接收 `context_usage` 事件。该事件会报告模型、提示词 token 数和模型上下文限制。

### SDK 版本发布

#### JavaScript SDK

- [v2.65.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.65.0) - 新增对话分诊工单和轻量级对话摘要的客户端及类型。对话 API 新增操作流程、无效工具调用和排序筛选；操作流程 API 新增智能体版本选择；主题 API 新增评估详情控制和挫败感排序。此版本还新增知识库刷新频率、测试环境和告警集成字段，以及实时配音消息类型。

#### Python SDK

- [v2.65.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.65.0) - 新增对话分诊工单和轻量级对话摘要的客户端及类型。对话 API 新增操作流程、无效工具调用和排序筛选；操作流程 API 新增智能体版本选择；主题 API 新增评估详情控制和挫败感排序。此版本还新增知识库刷新频率、测试环境和告警集成字段，并保留语音转文本 `keyterms` 和配音 `webhook_ids` 的重复 multipart 字段。

#### Swift SDK

- [v3.3.0](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.3.0) - 新增类型化客户端错误解析、`expects_response` 处理和类型安全的工具结果。WebRTC 启动现在会在智能体加入时就绪，无需等待音轨订阅。此版本还增强了 URL 处理，抑制未知事件噪声，并从软件静音处理移除了实时线程分配。

#### 软件包

- [@elevenlabs/client@1.19.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.19.1), [@elevenlabs/react@1.12.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.3), [@elevenlabs/react-native@1.2.21](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.21), [@elevenlabs/convai-widget-core@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.2) 和 [@elevenlabs/convai-widget-embed@0.16.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.2) - 在严格内容安全策略下，WebRTC 输出捕获现在使用自托管的 AudioWorklet 路径。Worklet 缓存包含请求的源，避免较早的内联 URL 替换自托管路径。React Native 设置错误现在会指向 `@elevenlabs/react-native`。
- [@elevenlabs/client@1.20.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.20.0), [@elevenlabs/react@1.12.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.12.4), [@elevenlabs/react-native@1.2.22](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.22), [@elevenlabs/convai-widget-core@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.3) 和 [@elevenlabs/convai-widget-embed@0.16.3](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.3) - 新增可选的 `webRtc.iceTransportPolicy`。在阻止直接 UDP 流量的网络中，将其设为 `relay`，可将 WebRTC ICE 候选限制为 TURN 中继。
- [@elevenlabs/client@1.21.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.21.0), [@elevenlabs/react@1.13.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.13.0), [@elevenlabs/types@0.21.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.21.1), [@elevenlabs/react-native@1.2.23](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.23), [@elevenlabs/convai-widget-core@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.16.4) 和 [@elevenlabs/convai-widget-embed@0.16.4](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.16.4) - 新增 `onContextUsage` 回调和 `ContextUsageEvent` 类型。React 通过 `useConversation` 提供该回调。React Native 现在通过其软件包导出条件解析，而非检测浏览器全局变量。
- [@elevenlabs/client@1.22.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.22.0), [@elevenlabs/react@1.14.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.14.0), [@elevenlabs/types@0.22.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.22.0), [@elevenlabs/react-native@1.2.24](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.24), [@elevenlabs/convai-widget-core@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.17.0) 和 [@elevenlabs/convai-widget-embed@0.17.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.17.0) - 新增带归因按钮响应的首条消息富内容、`onExternalAgentDisconnected` 和 `onMCPToolApprovalRequest`。WebRTC 现在使用所选输入设备，切换麦克风时保留静音状态，并会在无法发送初始化数据时终止设置。小组件新增并发队列状态、可选的折叠触发器语言选择，以及对同时支持文本和语音的智能体的首条消息渲染。

### API

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

## 新增端点

### ElevenAgents

- 新增 9 个对话分诊工单端点：
  - [创建对话工单](/docs/zh/api-reference/triage-tickets/create-agent-conversation-ticket-route) - `POST /v1/convai/triage-tickets`。请求需要 `conversation_id`（字符串），并接受 `qa_comment`（可为 null 的字符串，1–10,000 个字符）以及最多 200 条轮次评论。
  - [列出工单](/docs/zh/api-reference/triage-tickets/list-agent-conversation-tickets-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets`，支持游标分页。
  - [创建手动工单](/docs/zh/api-reference/triage-tickets/create-manual-agent-ticket-route) - `POST /v1/convai/agents/{agent_id}/triage-tickets`。请求需要 `qa_comment`（字符串，1–10,000 个字符）。
  - [列出可分配用户](/docs/zh/api-reference/triage-tickets/get-assignable-users-route) - `GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users`。响应会列出非服务账号的工作区成员，以及每位成员是否有权访问该智能体。
  - [获取工单](/docs/zh/api-reference/triage-tickets/get-agent-conversation-ticket-route) - `GET /v1/convai/triage-tickets/{agentqa_ticket_id}`。
  - [更新工单](/docs/zh/api-reference/triage-tickets/update-agent-conversation-ticket-route) - `PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}`。请求接受可选的 `status` 和可为 null 的 `assignee_user_id`。
  - [删除工单](/docs/zh/api-reference/triage-tickets/delete-agent-conversation-ticket-route) - `DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}`。
  - [添加评论](/docs/zh/api-reference/triage-tickets/add-ticket-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments`。请求需要 `comment`（字符串，1–10,000 个字符）。
  - [添加轮次评论](/docs/zh/api-reference/triage-tickets/add-turn-comment-route) - `POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments`。请求需要从 0 开始的 `turn_index`（整数）和 `comment`（字符串，1–10,000 个字符）。

## 更新的端点

### ElevenAgents

- [获取签名 URL](/docs/zh/api-reference/conversations/get-signed-url) - `GET /v1/convai/conversation/get-signed-url`
  - 新增可选的 `debug_events_request`（布尔值，默认 `false`）。调试事件需要智能体编辑者权限。
- [获取 WebRTC token](/docs/zh/api-reference/conversations/get-webrtc-token) - `GET /v1/convai/conversation/token`
  - 新增可选的 `debug_events_request`（布尔值，默认 `false`）。旧版 `GET /v1/convai/conversation/get_signed_url` 路由接受相同参数。
- [列出对话](/docs/zh/api-reference/conversations/list) - `GET /v1/convai/conversations`
  - 新增可选的 `triggered_procedure_ids`（可为 null 的字符串数组，最多 50 个），用于匹配运行过任一指定操作流程的对话。
  - 新增可选的 `include_invalid_tool_calls`（布尔值，默认 `false`），以包含未运行的工具调用。
  - 新增用于通话开始时间的可选 `sort_direction`（`asc` 或 `desc`，默认 `desc`）。
- [文本搜索对话消息](/docs/zh/api-reference/conversations/messages/text-search) - `GET /v1/convai/conversations/messages/text-search`
  - 新增可选的 `triggered_procedure_ids`（可为 null 的字符串数组，最多 50 个）。
  - 新增可选的 `include_invalid_tool_calls`（布尔值，默认 `false`）。
- [获取智能体对话主题](/docs/zh/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics`
  - 新增可选的 `include_evaluation_criteria`（布尔值，默认 `true`）。
  - `sort_by` 新增 `frustration`。
  - 主题响应新增可为 null 的 `success_rate`（数字），整体响应新增 `aggregated_run_count`（整数，默认 `0`）。
  - `from_unix_secs` 会向下取整至其 UTC 日期的起始时间。有界范围会聚合已完成的每日发现运行；省略两个边界则返回最新运行。
- [列出操作流程](/docs/zh/api-reference/agents/procedures/list)（`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures`）和 [获取操作流程](/docs/zh/api-reference/agents/procedures/get)（`GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}`）
  - 新增可选且可为 null 的 `agent_version_id`（字符串），用于从特定智能体版本获取操作流程。
- [创建测试](/docs/zh/api-reference/tests/create) 和 [更新测试](/docs/zh/api-reference/tests/update)
  - 响应、模拟和工具调用单元测试 schema 新增可选且可为 null 的 `environment`（字符串）。该值用于选择特定环境的 URL、标头和身份验证连接；默认为 `production`。
- [创建 URL 文档](/docs/zh/api-reference/knowledge-base/create-from-url)、[创建爬取任务](/docs/zh/api-reference/knowledge-base/create-crawl-job) 和 [创建文件夹](/docs/zh/api-reference/knowledge-base/create-folder)
  - 自动同步新增可选且可为 null 的 `minimum_frequency_days`（整数，1–180）。默认值为 `7`，更严格的父文件夹频率优先。

### 音乐

- [列出音乐 Finetune](/docs/zh/api-reference/music/finetunes/list) - `GET /v1/music/finetunes`
  - 最大 `page_size` 从 100 提高到 150。默认值仍为 50。

## Schema 变更

### ElevenAgents

- 智能体更新请求新增可选且可为 null 的 `procedures`（`object<string, ProcedureVersionRef>`）。每个值都需要 `procedure_id` 和 `version_id`（字符串）。空对象会移除所有操作流程。
- 对话初始化配置新增 `enable_procedure_ids_from_client`（布尔值，默认 `false`）。初始化数据新增可选且可为 null 的 `procedure_ids`（字符串数组）；空数组会禁用起始智能体的所有操作流程。
- `ClientEvent` 新增 `context_usage`。
- 软超时覆盖新增可选且可为 null 的 `additional_soft_timeout_messages`（字符串数组）。
- 分析和 schema 覆盖模型中的常量值现在接受 `null`。
- 小组件配置中 `mic_muting_enabled` 和 `transcript_enabled` 的默认值已从 `false` 改为 `true`。请显式将其设为 `false` 以保留此前行为。

### 工作区

- [获取用户](/docs/zh/api-reference/user/get) 响应已从 `UserResponseModel` 移除 `xi_api_key`。
- `ResourceMetadataResponseModel.role_to_group_ids` 现在接受自定义角色 ID 作为键，不再将键限制为 `admin`、`editor`、`commenter` 和 `viewer`。
- 直接发布响应新增可选且可为 null 的 `restricted_to_user_email_domains`（字符串数组）。
- 待处理订阅切换响应的 `next_tier` 新增 `go`。

</Accordion>