> 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 Architect 如何进行身份验证

Architect 不使用单独的服务账号，也不会以其他身份运行。在 ElevenLabs 控制台中，它的工具会在浏览器内、已登录的会话中运行。它执行的每次读取或写入操作，从获取智能体配置到创建分支，都是以你的身份并根据工作区权限发出的常规请求。

这带来 3 个结果：

* **Architect 只能执行你有权限执行的操作。** 如果你无法编辑某个智能体，Architect 可以读取它，但无法暂存对它的更改。如果你的角色不允许合并到受保护分支，Architect 也无法合并。
* **其操作会记录在你的名下。** Architect 创建的已发布版本、分支和合并提案都会显示你为作者，不会标记为由 Architect 创建。
* **不同用户可能得到不同结果。** 如果角色不同，两位团队成员向 Architect 请求相同更改，结果可能不同。

> **Note**
>
> 本页介绍的是 ElevenLabs 控制台中的 Architect，目前 Architect 仅在此处运行。Architect 将支持其他平台，
> 例如 Slack，但目前尚不可用。在所有平台上，Architect 都会遵循相同模式：以与其交谈的用户身份进行验证，
> 并使用该用户的权限执行操作。

## 各角色允许的操作

智能体访问角色对 Architect 的适用方式与在控制台中对你的适用方式完全相同。

| 你对智能体的访问权限 | Architect 可以为你执行的操作                                     |
| ---------- | ------------------------------------------------------- |
| 查看者        | 读取配置、对话、测试、分支和提案。可以调查并建议更改，但不能暂存更改。                     |
| 编辑者        | 包含查看者的所有权限，还可在草稿中暂存更改、创建分支、编写和运行测试、发起合并提案，以及合并到未受保护的分支。 |
| 工作区管理员     | 包含编辑者的所有权限，还可合并到受保护分支，并更改受保护分支的流量占比。                    |

工具、知识库文档和测试等工作区级资源遵循各自的共享权限。有关哪些操作适用于智能体、哪些适用于工作区，请参阅[Architect 可以更改的内容](/docs/zh/eleven-agents/operate/architect/capabilities)。

## 审批模式

每个 Architect 对话都以 3 种模式之一运行。可通过编辑器中的模式按钮切换，或按 <kbd>Shift</kbd>+<kbd>Tab</kbd> 依次切换。

| 模式           | 行为                                                                    |
| ------------ | --------------------------------------------------------------------- |
| **需要审批**（默认） | Architect 会在影响线上流量或共享资源的操作前请求确认。它会准确显示将发生的更改，并等待你批准或拒绝。               |
| **自动批准**     | Architect 在执行任何操作前都不会询问，包括合并分支、更改流量分配、丢弃草稿、归档智能体或发起测试通话。仅在你确信操作无误时使用。 |
| **计划**       | Architect 会使用只读工具进行研究、编写计划，并在进行任何更改前等待你批准计划。批准后，操作将和“需要审批”模式一样受到管控。   |

所选模式会保存在浏览器中。没有可为所有人强制指定模式的工作区设置。如需确保对线上智能体的每项更改都经过审核，请保护其 `main` 分支，使更改必须通过已批准的[合并提案](/docs/zh/eleven-agents/operate/merge-proposals)。

### 哪些操作会先询问

在 **需要审批** 模式下，Architect 会直接将智能体配置更改暂存到草稿中，无需询问，因为草稿不会影响线上来电者。以下操作会先询问：

* 会立即影响线上来电者的更改：合并分支和更改流量分配。
* 对共享工作区资源的更改：创建、更新或删除工具，更新或删除测试，以及大部分知识库更改。
* 破坏性操作：丢弃草稿、删除流程、归档智能体或分支。
* 现实操作：发起测试电话。

读取操作从不需要询问。审批提示会使用 **永久** 标签标记无法撤销的删除操作。完整列表请参阅 [Architect 可以更改的内容](/docs/zh/eleven-agents/operate/architect/capabilities)。

无论在哪种模式下，以下 3 个步骤都必须由你完成：

* **发布草稿。** Architect 会打开发布对话框，然后由你选择 **发布**。
* 在计划模式下**批准计划**。
* **决定如何处理现有草稿。** 如果该分支已有并非 Architect 在此对话中创建的草稿，包括编辑器中未保存的修改，Architect 会停止操作，并在暂存任何内容前询问你是保留还是丢弃该草稿。

### 在当前会话中信任工具

审批提示中有一个 **在本次会话中信任这些工具** 复选框。选中后，该会话中后续对相同工具的调用将无需询问。开始新对话后，信任即失效。如果你在约 2 分钟内未响应审批提示，请求会过期，Architect 不会执行该操作。

## 草稿、版本和分支

Architect 使用与 ElevenAgents 其他功能相同的[版本控制](/docs/zh/eleven-agents/operate/versioning)模型。

| 概念 | 含义                               | Architect 如何使用                                         |
| -- | -------------------------------- | ------------------------------------------------------ |
| 草稿 | 你在某个分支上尚未发布的更改。每位用户在每个分支都有自己的草稿。 | Architect 所做的每项配置编辑都会暂存在此处。聊天中会显示包含 **审核并发布** 的暂存更改面板。 |
| 版本 | 发布草稿时创建的不可变快照。                   | 由你发布，Architect 无法发布。在受保护分支上，对话框会提供发布到新分支的选项。           |
| 分支 | 由名称标识的一条版本线。线上流量会按百分比路由到不同分支。    | Architect 会为需要审核的更改创建分支，因此在分支合并前不会影响 `main`。           |

“未经你的批准，任何内容都不会上线”有明确含义：

* 对智能体配置的更改会暂存在草稿中，只有在提供流量的分支上由你发布后，才会影响线上来电者。
* 在 **需要审批** 模式下，影响线上流量或共享资源的操作会等待你的批准。
* 在 **自动批准** 模式下，Architect 仍无法发布，但可以在你的权限范围内无需询问地合并分支和更改流量分配。

智能体配置以外的某些更改一经完成便会在工作区生效，例如创建工具或知识库文档。它们不会影响智能体行为，直到你发布附加这些资源的草稿。已关联到线上智能体的工作区资源是例外：更新线上智能体使用的工具会立即更改该智能体。在 **需要审批** 模式下，Architect 在更新工具前会询问。

## 版本历史与回退

每个已发布版本都会记录更改内容和发布者。

* **查看更改内容**：在 **版本控制** > **分支** 中，打开某个分支的 **版本历史**。可将任何版本与前一版本或线上版本进行比较。你也可以询问 Architect，例如“过去一周 main 有哪些更改？”它会读取分支历史并为你比较版本差异。
* **查看更改者**：每个版本都会显示发布它的用户。Architect 所做的更改会显示当时与它交谈的用户。
* **回退**：在版本历史中选择 **回退到此版本**。回退不会删除历史记录，而是将旧配置作为新版本发布。你也可以使用 `/rollback`，让 Architect 审核最近的更改，并暂存一个可由你发布的回退操作。