> 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/ja/eleven-agents/operate/versioning#branches)の変更を別のブランチにマージするリクエストを記録し、実行前にチームメイトが差分をレビューできます。エージェントの編集アクセス権を持つユーザーは、マージ先ブランチに自身でマージする権限がなくても、提案を作成できます。提案のマージには引き続き対象ブランチへの書き込みアクセスが必要です。そのため、提案を使うと、すべてのコントリビューターに保護されたブランチへのマージ権限を与えずに変更を反映できます。

> **Note**
>
> マージ提案は、[ブランチを直接マージする](/docs/ja/eleven-agents/operate/versioning#merging-branches)場合に追加できる任意のレビューステップです。
> 対象ブランチへの書き込みアクセスがあり、他者の意見が不要な場合は直接マージしてください。先にレビューを受けたい場合や、
> 対象ブランチが保護されていて書き込みアクセスがない場合は、提案を作成してください。

## 提供状況

マージ提案はアルファ版です。1つのエージェントで複数のブランチを同時に進めている場合、マージの準備ができ安全に反映できるブランチを把握するのは難しくなります。マージ提案により、チームはブランチの変更をレビュー・議論し、ブランチ間のテスト合格率を比較し、ブランチの最新の会話を確認するための場所を1つにまとめられます。

このアルファ版は、GitHubのプルリクエストに似た、エージェント向けCI/CDスタイルのワークフローに向けた最初のステップです。今後数週間で、次の追加を予定しています。

* 提案をマージする前に合格が必須となるテスト
* 特定のレビュアーへの承認依頼
* エージェントの異なる部分に対するオーナーの設定

## 提案のライフサイクル

各提案には、次のいずれかのステータスがあります。

| ステータス | 意味                                                               |
| ----- | ---------------------------------------------------------------- |
| オープン  | レビューまたはマージ待ちです。                                                  |
| マージ済み | ソースブランチの変更が対象ブランチにマージされました。                                      |
| クローズ  | 作成者により取り下げられた、他のユーザーにより却下された、またはソースブランチがアーカイブされたため自動的にクローズされました。 |

提案がオープン中、レビュアーは次のいずれかの判定を残します。同じレビュアーによる最新の判定は、それ以前の判定を置き換えます。

| レビュー状態   | 意味                   |
| -------- | -------------------- |
| 承認済み     | レビュアーは変更内容に満足しています。  |
| 変更をリクエスト | マージ前に対応してほしい項目があります。 |

## 提案を作成する

変更をレビューしてほしいブランチから提案を作成します。

#### ブランチ一覧から

エージェントの **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**
>
> ソースブランチと対象ブランチの組み合わせごとに、同時にオープンできる提案は最大1件です。同じ2つのブランチ間で別の提案を作成する前に、
> 既存の提案をクローズしてください。

## 提案をレビューする

提案ページには次のタブがあります。

#### 概要

説明、レビュー履歴、レビューを残すためのフォームです。

![マージ提案の概要タブ](/docs/_fern-img/44894b2d2cbb79aeff99813f83d5832ab4a9e6ff44796c772e3681c69120b04c.webp)

#### 変更

ソースブランチと対象ブランチの設定の差分です。

![マージ提案の変更タブ](/docs/_fern-img/968126763b1bb7e5bf57ad68ee334d5d5bc64b43a7ce3006184a462ce0c3d929.webp)

#### テスト実行

承認前にテストが引き続き合格していることをレビュアーが確認できるよう、ソースブランチのテスト履歴を表示します。

![マージ提案のテスト実行タブ](/docs/_fern-img/a39354598b070cef39720159b84da10414d7b17820c8c71780ed2bd5a66a47fc.webp)

#### 会話

ソースブランチの最近の会話です。

![マージ提案の会話タブ](/docs/_fern-img/c37286e50107428225c57804a8bc8e09fe364b1ad6dc6cf582084dd8c52a6565.webp)

提案の作成者以外でエージェントの編集アクセス権を持つユーザーは、任意のコメントを添えてレビューを残せます。コメントではMarkdownを使用できます。

## 提案をマージする

提案のマージでは、直接マージする場合と同じ[ブランチマージ](/docs/ja/eleven-agents/operate/versioning#merging-branches)が実行されます。これには[競合の解決](/docs/ja/eleven-agents/operate/versioning#resolving-merge-conflicts)と、その後にソースブランチをアーカイブするオプションも含まれます。マージするには、提案が次の要件を満たす必要があります。

* マージするユーザーがソースブランチと対象ブランチの両方に書き込みアクセスを持っていること。[保護されたブランチ](/docs/ja/eleven-agents/operate/versioning)では、ワークスペース管理者である必要があります。
* どのレビュアーについても、最新の判定が「変更をリクエスト」になっていないこと。変更をリクエストしたレビュアーは、提案をマージする前に承認する必要があります。
* 作成者以外のユーザーから少なくとも1件の承認を得ていること。ワークスペース管理者はこの承認なしでマージできます。

提案をマージすると、同じソースブランチに対する他のオープン中の提案は、変更がすでに移行したため自動的にクローズされます。

## 提案をクローズする

提案はオープン中であれば、いつでもマージせずにクローズできます。作成者とレビュアーは、クローズされるまでタイトルと説明を編集できます。

* 作成者が自身の提案をクローズすると、**取り下げ** として記録されます。
* 他のユーザーがクローズすると、**却下** として記録されます。
* ソースブランチをアーカイブすると、そのブランチから、またはそのブランチへのオープン中の提案はすべて自動的にクローズされ、**branch_archived** として記録されます。

## マージ提案とElevenAgents Architect

[Architect](/docs/ja/eleven-agents/operate/architect)は、マージ提案を代わりに作成できます。ブランチ上で変更を加えてテストした後、ブランチのコミットとマージプレビューを読み取り、**Summary**、**Testing**、**How to review** のセクションを含む提案を作成します。選択できるレビュアーを提案することもできます。Architectは代理で操作するため、提案の作成者にはユーザー自身が表示されます。

Architectは提案のレビュー、承認、マージ、クローズはできません。これらのステップは常に人が行います。詳細なフローについては、[Proposals and validation](/docs/ja/eleven-agents/operate/architect/proposals)をご覧ください。

## 次のステップ

#### [バージョン管理](/docs/ja/eleven-agents/operate/versioning)

ブランチ、バージョン、直接マージについて説明します。

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

エージェントを反復改善するためにElevenAgentsに組み込まれたアシスタントです。

#### [トリアージ](/docs/ja/eleven-agents/operate/triage)

フォローアップ対象としてフラグ付けされた会話の問題を確認します。

#### [実験](/docs/ja/eleven-agents/operate/experiments)

ブランチとトラフィックデプロイメントを使用してA/Bテストを実行します。