> 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が変更を完了すると、その変更は**提案**として渡されます。提案には、変更内容を保持するブランチ、変更が機能することを示すテスト、そのブランチを`main`にマージするよう求める[マージ提案](/docs/ja/eleven-agents/operate/merge-proposals)が含まれます。このページでは、各要素の仕組み、見つける場所、提案が会話からライブトラフィックに至るまでの流れを説明します。

## 提案とは

提案は既存の[バージョン管理](/docs/ja/eleven-agents/operate/versioning)モデルに基づいて構築されます。

| 要素    | 内容                                                                        |
| ----- | ------------------------------------------------------------------------- |
| ブランチ  | 変更のためにArchitectが作成したブランチです。作業中も`main`とライブの通話者には影響しません。                    |
| ドラフト  | そのブランチ上の、未公開ドラフトにステージングされたArchitectによる編集内容です。                             |
| バージョン | ドラフトを公開すると、ブランチ上の新しいバージョンになります。                                           |
| テスト   | 変更のためにArchitectが作成したテストです。エージェントに紐付けられ、ブランチに対して実行されます。                    |
| マージ提案 | 変更内容、実行したテスト、レビュアーが確認すべき点を記載し、ブランチを`main`（または選択した別のブランチ）にマージするためのリクエストです。 |

マージ提案は、チームメイトが手動で作成するものと同じ、標準的なElevenAgentsのマージ提案です。別のオブジェクトタイプではありません。

マージ提案は、1つのソースブランチと1つのターゲットブランチを対象とするため、1つの提案には1つの候補ソリューションが含まれます。代替案を比較するには、それぞれを別々のブランチに置くようArchitectに依頼してください。各ブランチにはそれぞれ独自の提案が作成され、[実験](/docs/ja/eleven-agents/operate/experiments)としてトラフィックを分割できます。

> **Note**
>
> Architectはあなたとして動作するため、Architectが作成したマージ提案は作成者としてあなたの名前で記録されます。\n  Architectが作成したことを記録するフィールドはありません。チームで把握する必要がある場合は、\n  提案の説明に記載してください。

## 提案の作成方法

問題の修正や改善をArchitectに依頼したとき、失敗したテスト、Spotlightの検出結果、またはトリアージチケットを渡したときに、Architectは提案を作成します。各ステップでArchitectが呼び出すツールを含む完全な手順は、[実例](/docs/ja/eleven-agents/operate/architect/how-it-works#worked-example-improving-refund-resolutions)を参照してください。概要は次のとおりです。

1. Architectが調査し、ブランチを作成して、そのブランチ上のドラフトに変更をステージングします。
2. Architectが変更用のテストとシミュレーションを作成し、結果を表示する前に会話内で実行します。
3. Architectが公開ダイアログを開きます。差分を確認して**公開**を選択すると、変更がブランチ上の新しいバージョンとしてコミットされます。
4. Architectが`main`へのマージ提案を作成し、ブランチの実際のコミットとテスト実行結果に基づいて説明を記載します。
5. 提案のレビュー中に、少量のライブトラフィックをブランチへ送ることをArchitectが提案します。これには承認が必要です。

どの段階でも停止できます。公開済みバージョンがあってもマージ提案がないブランチは、引き続き利用できます。自分でテストすることも、後で提案を作成することもできます。

### 会話内での検証

Architectは、後から開始する別のステップとしてではなく、変更の作成過程でテストを記述・実行します。修正では、新しいテストが変更なしでは失敗し、変更ありでは成功することを示すのが有用なパターンです。Architectは、元のブランチと変更を含むドラフトの両方に対して同じテストを実行できます。

Architectは、すべての変更に対してこの変更前後のチェックを自動では実行しません。必要な場合に依頼してください。例：「新しいシミュレーションがmainでは失敗し、ブランチでは成功することを示してから、提案を作成してください。」

すべての成功条件を満たすと、テストは**成功**します。LLMテストでは、エージェントの応答が成功基準を満たします。ツール呼び出しテストでは、想定したツールが想定したパラメータで呼び出されます。シミュレーションでは、シミュレートされた会話が成功条件を満たします。不安定な結果を確認するには、Architectにテストを複数回実行するよう依頼してください。各テストは最大50回繰り返し、成功率を報告できます。

各テストタイプの定義については、[テスト](/docs/ja/eleven-agents/customization/agent-testing)を参照してください。

## 提案を見つける場所

エージェントを開き、**Version Control** > **Proposals**に移動します。リストは、ステータス、作成者（**Created by**）、レビュアー（**Awaiting review from**、**Reviewed by**）でフィルタリングできます。会話内でArchitectが作成した提案は、作成者としてあなたの名前で表示されます。

Architectは、提案を作成するとすぐに、会話内でも提案へのリンクを返します。

![Branchesページの提案リスト](/docs/_fern-img/bfdb23ad1edb31c89c2ff2a137fa3028bf3f9fbcf31e236de142e207b5d54cd0.webp)

## 提案の構成

提案ページには、ソースブランチとターゲットブランチ、ステータス、マージ可能かどうか、ソースブランチがターゲットよりどれだけ遅れているかまたは進んでいるかが表示されます。次のタブがあります。

#### 概要

説明、ソースブランチ上のコミット・レビュー・コメントのアクティビティタイムライン、コメントボックスが表示されます。サイドバーには、レビュアー、推奨レビュアー、リンクされたトリアージチケットが表示されます。

Architectが作成する説明には、常に3つのセクションがあります。**概要**（重要な変更内容とその理由）、**テスト**（実行したテストと結果、またはテスト未実行である旨）、**レビュー方法**（注目すべき点、実行するテストまたは試す会話）。

![マージ提案のOverviewタブ](/docs/_fern-img/569eccd1750f90cd5ec8121411e8effd3a38e924e0f03f06f6216a9fcc160e08.webp)

#### 変更

設定の差分です。ターゲットブランチの現在の状態と比較して、マージ後にどのようになるかを表示します。両方のブランチで同じフィールドが変更されている場合、**Conflicts**ビューに各競合とどちらの変更が優先されるかが表示されます。

提案がマージされた後、このタブにはマージ前後のターゲットブランチが表示されます。

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

#### テスト実行

会話内でArchitectが開始した実行を含め、ソースブランチの成功率とテスト実行履歴を表示します。ターゲットブランチに切り替えると成功率を比較できます。**Run tests**を選択すると、どちらのブランチでも、紐付けられたすべてのテストを再実行できます。必要に応じて各テストを複数回実行できます。

テスト実行は提案ではなくブランチに紐付きます。マージにテストの成功は必須ではありません。タブに表示される内容に基づいて、レビュアーが判断します。

![マージ提案のTest runsタブ](/docs/_fern-img/58e28b31cb3408fe5bf8e9193f4a4edb5e716e6023c56f29d5a4f924c70a0f7a.webp)

#### 会話

トラフィック分割によって送信されたライブトラフィックを含め、ソースブランチで実行されたすべての会話が表示されます。会話を選択すると、文字起こしを開けます。ブランチを段階的にロールアウトしている間は、実際の通話者が変更を利用する様子をここで確認できます。

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

## レビューとマージ

### ステータス

マージ提案のステータスは次のいずれかです。

| ステータス  | 意味                                                                 |
| ------ | ------------------------------------------------------------------ |
| Open   | レビューまたはマージ待ちです。                                                    |
| Merged | ブランチがターゲットにマージされました。                                               |
| Closed | 作成者による取り下げ、他者による却下、またはブランチのアーカイブによりクローズされました。クローズされた提案は再オープンできません。 |

提案がオープン中の場合、各レビュアーの最新レビューは**Approved**または**Changes requested**のいずれかです。「テスト済み」や「レビュー準備完了」といった個別のステータスはありません。テスト結果は代わりに**Test runs**タブに表示されます。

レビューとコメントは、ソースブランチにコミットされた各新しいバージョンとともに、**Overview**タブのアクティビティタイムラインに表示されます。

![マージ提案のアクティビティタイムライン](/docs/_fern-img/522012341d0089ff418032a34bae6653d2b883934b64a0b6a12de887646b2f5f.webp)

### 承認とマージを実行できる人

* エージェントへの編集アクセスを持つ人は、作成者を除いて誰でも提案をレビューできます。Architectはあなたとして動作するため、会話内でArchitectが作成した提案をあなた自身は承認できません。チームメイトによる承認が必要です。
* 作成者以外から少なくとも1件の承認があり、どのレビュアーの最新レビューも**Changes requested**ではない場合、提案をマージできます。ワークスペース管理者は承認なしでマージできます。
* [保護されたブランチ](/docs/ja/eleven-agents/operate/versioning)へのマージには、管理者権限、または管理者からの承認が必要です。

Architectは、マージ提案の承認、コメント、マージ、クローズを行えません。これらのステップは常に人が実行します。レビューに関する完全なルールは、[マージ提案](/docs/ja/eleven-agents/operate/merge-proposals)を参照してください。

> **Warning**
>
> Architectは、依頼され、かつロールにマージ権限がある場合、提案なしでブランチを直接マージできます。\n  **Approval required**モードでは最初に確認を求めます。**Auto-approve**モードでは確認しません。\n  すべての変更をレビュー済みの提案経由にする必要がある場合は、`main`でブランチ保護を使用してください。

### マージ時に起こること

マージ後に別途公開する必要はありません。マージによりターゲットブランチに新しいバージョンが書き込まれ、そのバージョンはターゲットが受け取るトラフィックの割合に応じて、すぐにライブトラフィックを処理します。ターゲットが`main`で、トラフィック分割が設定されていない場合、すべての通話者が対象です。

マージでは、次のことも行われます。

* ソースブランチに割り当てられていたライブトラフィックの割合をターゲットに移します。
* デフォルトでソースブランチをアーカイブします。
* 同じブランチからの他のオープン中の提案をすべてクローズします。
* リンクされたトリアージチケットがある場合、それを解決します。

## 段階的なロールアウト

提案がマージされる前に、ライブトラフィックの一部をそのブランチへ送信して、実際の通話者に変更を利用してもらうことができます。

#### 分割を開始する

たとえばArchitectに「このブランチにトラフィックの5%を送ってください」と依頼します。Architectは、`main`の割合を含む\n    分割後の全体を伝え、適用前に承認を求めます。自分で設定することもできます。**Version Control** > **Branches**で、\n    ブランチの**Deploy**を選択してください。

#### 結果を確認する

提案の**Conversations**タブを開いてブランチ上の会話を読むか、Architectに\n    ブランチの結果を`main`の結果と比較するよう依頼してください。

#### 昇格またはロールバックする

昇格するには、提案をマージします。ブランチのトラフィック割合は、マージとともに`main`へ移ります。ロール\n    バックするには、Architectにブランチの割合を0%に設定するよう依頼するか、自分でデプロイ設定を編集してください。\n    ライブトラフィックはすぐに`main`へ戻ります。

トラフィックの割合の合計は常に100%である必要があり、ルーティングは会話ごとに決定的です。保護された`main`からトラフィックを移す場合を含め、保護されたブランチの割合を変更するには管理者が必要です。[トラフィックのデプロイ](/docs/ja/eleven-agents/operate/versioning#traffic-deployment)を参照してください。

## プロアクティブな提案

> **Note**
>
> Architectは、依頼されたとき、または失敗したテスト、Spotlightの検出結果、アラート、トリアージチケットを\n  渡されたときに提案を作成します。まだスケジュールに従ってエージェントをスキャンしたり、\n  自ら提案を作成したりはしません。

現在のプロアクティブな流れは、[Spotlight](/docs/ja/eleven-agents/dashboard/spotlight)とその後の引き継ぎです。Spotlightはエージェントの会話を継続的に監視します。調査候補を含む週次サマリーを作成し、リアルタイムアラートを発生させ、設定変更を推奨します。Spotlightの検出結果を提案に変えるには、次の手順に従います。

#### Spotlightを開く

エージェントを開きます。概要ページがSpotlightです。

#### 検出結果を選ぶ

週次サマリーを開いて**Suggested next steps**を確認するか、リアルタイムアラートを開きます。

#### ElevenAgents Architectに引き継ぐ

提案では**Open in Architect**、サマリーでは**Analyze with Architect**、アラートでは\n    **Investigate with Architect**を選択します。Architectは検出結果を受け取り、\n    変更を提案する前に、実際の会話に照らして検証し、影響を受けるブランチを特定するよう\n    指示されます。

#### 提案を依頼する

Architectの検出結果を確認します。根本原因に同意できる場合は、問題をブランチで修正し、\n    修正をテストして、提案を作成するよう依頼してください。

トリアージチケットも同様に機能します。ライブエージェントは会話中に[問題をレビュー用にフラグ付け](/docs/ja/eleven-agents/customization/tools/system-tools/flag-issue-for-review)でき、チケット上の**Discuss with Architect**を選択すると、そのチケットの調査が開始されます。

Architectの受信トレイにレポートを配信するスケジュール済み自動化は開発中です。Architectページの**Inbox**タブは、そのためのプレースホルダーです。