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

# 合并提案

## 概览

合并提案用于记录将一个[分支](/docs/zh/eleven-agents/operate/versioning#branches)的更改合并到另一个分支的请求，并让团队成员在合并前审核差异。任何拥有智能体编辑权限的人都可以创建提案，即使其无权自行合并到目标分支。合并提案仍需目标分支的写入权限，因此无需为每位贡献者授予受保护分支的合并权限，也能让更改进入该分支。

> **Note**
>
> 合并提案在[直接合并分支 ](/docs/zh/eleven-agents/operate/versioning#merging-branches)的基础上增加了可选审核步骤。如果拥有目标分支的写入权限且不需要他人复核，可直接合并。若希望先审核，或目标分支受保护而你没有其写入权限，请创建提案。

## 可用性

合并提案目前处于 Alpha 阶段。当一个智能体的多个分支同时在开发时，很难追踪哪些分支已准备就绪且可安全合并。合并提案为团队提供了统一位置，可审核和讨论分支更改、比较分支之间的测试通过率，以及查看分支的最新对话。

Alpha 版是迈向智能体 CI/CD 工作流程的第一步，类似 GitHub 上的拉取请求。未来几周计划增加：

* 提案合并前必须通过的必需测试。
* 向特定审核者请求批准。
* 为智能体的不同部分配置负责人。

## 提案生命周期

每个提案都有以下状态之一：

| 状态  | 含义                          |
| --- | --------------------------- |
| 打开  | 等待审核或合并。                    |
| 已合并 | 源分支的更改已合并到目标分支。             |
| 已关闭 | 由作者撤回、被其他人拒绝，或因源分支已归档而自动关闭。 |

提案处于打开状态时，审核者可给出以下结论。审核者最新的结论会替代同一审核者此前的结论：

| 审核状态 | 含义               |
| ---- | ---------------- |
| 已批准  | 审核者认可这些更改。       |
| 请求更改 | 审核者希望在合并前处理某些问题。 |

## 创建提案

从希望审核其更改的分支创建提案：

#### 从分支列表创建

在智能体的 **Branches** 标签页中，打开源分支的选项菜单，然后选择 \*\*Open
merge proposal \*\*。

![分支选项菜单中的 Open merge proposal 选项](/docs/_fern-img/5216047fc93408959d31bba118e0f0e8853129da106a9d75c00d57a2307e33e0.webp)

#### 从 Proposals 标签页创建

在智能体的 **Branches > Proposals** 标签页中，选择源分支，然后点击 \*\*Create
proposal \*\*。

![智能体 Branches 页面中的 Proposals 标签页](/docs/_fern-img/bfdb23ad1edb31c89c2ff2a137fa3028bf3f9fbcf31e236de142e207b5d54cd0.webp)

为提案填写标题和可选描述，并从智能体其他未归档分支中选择目标分支。创建提案不会更改任一分支，只会记录该请求。

> **Note**
>
> 同一源分支和目标分支组合一次最多只能有一个打开的提案。在同一对分支之间创建新提案前，请先关闭现有提案。

## 审核提案

提案页面包含以下标签页：

#### 概览

显示描述、审核历史和提交审核的表单。

![合并提案的概览标签页](/docs/_fern-img/44894b2d2cbb79aeff99813f83d5832ab4a9e6ff44796c772e3681c69120b04c.webp)

#### 更改

源分支与目标分支配置之间的差异。

![合并提案的更改标签页](/docs/_fern-img/968126763b1bb7e5bf57ad68ee334d5d5bc64b43a7ce3006184a462ce0c3d929.webp)

#### 测试运行

源分支的测试历史，方便审核者在批准前确认其仍能通过测试。

![合并提案的测试运行标签页](/docs/_fern-img/a39354598b070cef39720159b84da10414d7b17820c8c71780ed2bd5a66a47fc.webp)

#### 对话

源分支的近期对话。

![合并提案的对话标签页](/docs/_fern-img/c37286e50107428225c57804a8bc8e09fe364b1ad6dc6cf582084dd8c52a6565.webp)

除提案作者外，任何拥有智能体编辑权限的人都可提交带可选评论的审核。评论支持 Markdown。

## 合并提案

合并提案与直接合并执行相同的[分支合并](/docs/zh/eleven-agents/operate/versioning#merging-branches)，包括[冲突解决](/docs/zh/eleven-agents/operate/versioning#resolving-merge-conflicts)和之后归档源分支的选项。提案合并前必须满足以下要求：

* 执行合并的用户同时拥有源分支和目标分支的写入权限。对于[受保护分支](/docs/zh/eleven-agents/operate/versioning)，这意味着该用户必须是工作区管理员。
* 没有任何审核者的最新结论为“请求更改”。请求过更改的审核者必须批准后，提案才能合并。
* 提案至少获得一名非作者用户的批准。工作区管理员无需该批准即可合并。

合并提案会自动关闭同一源分支的所有其他打开提案，因为其更改现已转移。

## 关闭提案

提案处于打开状态时，可随时关闭而不合并。提案关闭前，作者和审核者都可以编辑其标题和描述。

* 作者关闭自己的提案时，会记录为 **已撤回**。
* 其他人关闭提案时，会记录为 **已拒绝**。
* 归档源分支会自动关闭来自或指向该分支的所有打开提案，并记录为 **branch_archived**。

## 合并提案与 ElevenAgents Architect

[Architect](/docs/zh/eleven-agents/operate/architect) 可为你创建合并提案。它在分支上完成并测试更改后，会读取分支的提交和合并预览，并创建包含 **摘要**、**测试** 和 **如何审核** 部分的提案。它还可建议供你选择的审核者。由于 Architect 代表你操作，提案会将你列为作者。

Architect 无法审核、批准、合并或关闭提案。这些步骤始终由人工完成。完整流程请参阅[提案和验证](/docs/zh/eleven-agents/operate/architect/proposals)。

## 后续步骤

#### [版本控制](/docs/zh/eleven-agents/operate/versioning)

分支、版本和直接合并。

#### [ElevenAgents Architect](/docs/zh/eleven-agents/operate/architect)

ElevenAgents 内置的智能体迭代助手。

#### [分诊](/docs/zh/eleven-agents/operate/triage)

审核标记为需跟进的对话问题。

#### [实验](/docs/zh/eleven-agents/operate/experiments)

使用分支和流量部署运行 A/B 测试。