pull requests をマージする準備をする Agent Merge

Copilot が pull request を監視し、失敗したワークフローとマージの競合を修正する間、他の作業に集中できるようにします。

この記事で

Agent Merge の概要

Agent Merge Copilot in the cloudの一部です。 選択したブロッカーについてプルリクエストを監視し、検出されると自動的に動作が開始されます。 GitHub Actionsに、失敗したCopilotワークフローの修正、マージの競合の解決、またはその両方を許可できます。

Agent Merge は、プル リクエストをマージできる状態に整え、それを維持するのに役立ちます。 これは、変更のレビューやリポジトリのマージ要件に代わるものではありません。

前提条件と制限事項

Agent Mergeを使用するには、有料Copilot in the cloudプランを通じてCopilotにアクセスできる必要があります。 お客様の組織または企業が Copilot アクセスを提供する場合は、そのポリシーで Copilot in the cloud を使用できるようにする必要があります。

リポジトリの [自動化を有効にするCopilot ポリシーも有効にする必要があります。

Agent Merge は、スタックされたプル要求またはフォークから開かれたプル要求をサポートしていません。

pull request での Agent Merge を有効にする

  1. GitHubで、Copilotに監視させたいプル リクエストを開きます。

  2. プル リクエストのマージ ボックスで、[Watch and fix] をクリックします。

  3. Copilot に実行させるアクションを選択します。

    • 失敗したアクション ワークフローを修正する: GitHub Actionsに、失敗したCopilotワークフローの調査と修正を許可します。
    • マージの競合を解決する: プル リクエストのブランチとそのベース ブランチの間の競合を Copilot が解決できるようにします。

選択したブロッカーのいずれかが発生すると、Copilot はクラウド開発環境で作業を開始してその問題の修正を開始します。

Agent Mergeの作業に続いて

Copilot がプル リクエストを監視すると、マージ ボックスの Agent Merge セクションに更新が表示されます。

Copilotが作業を開始すると、更新が pull request タイムライン イベントとして表示されます。 この更新プログラムは、失敗したワークフローやマージの競合など、発生した理由を説明します。

Copilotが行った変更を確認し、マージする前にワークフローの結果を確認してください。 Agent Merge は、人間によるレビューの必要性を取り除くものではありません。

Agent Mergeを自動的に有効にする

作成したプル要求に対して既定で Agent Merge を有効にすることができます。

  1. GitHub の任意のページの右上隅にあるプロフィール写真をクリックし、[ Settings] をクリックします。
  2. サイドバーの Copilot の下の [クラウド] をクリックします。
  3. 自分が作成する pull request に対して自動的にAgent Mergeを有効にする を選択します。
  4. [失敗した Actions ワークフローの修正] と [マージ競合の解決] スイッチを使用して、プルリクエストに対してCopilotが自動的に有効になっているときに、Agent Merge実行できるアクションを選択します。 アクションのみ、または両方を有効にすることができます。

pull request の Agent Merge を無効にする機能

Agent Merge を有効にした場合、またはリポジトリへの書き込みアクセス権がある場合は、プル リクエストに対して Agent Merge を無効にすることができます。

  1. GitHub上で、プルリクエストを開きます。
  2. プル リクエストの下部にあるマージ ボックスで、[割り当て解除Copilot] をクリックします。

自動マージでの Agent Merge の使用

Agent Merge はブロッカーを修正しますが、自動マージでは、必要なすべてのレビューと状態チェックが成功した後にプル リクエストがマージされます。 Agent Mergeを有効にしても、自動マージは有効になりません。

この 2 つを組み合わせると、Copilot で pull request を準備して準備完了の状態に保ち、GitHub で、すべての要件が満たされるとすぐにそれをマージできます。 セットアップ ガイダンスについては、プルリクエストを自動的にマージするを参照してください。

Agent Mergeの環境のカスタマイズ

Agent MergeはCopilot in the cloudの一部ですが、その修正はクラウド サンドボックスではなく、GitHub Actionsベースの開発環境で行われます。 次のような、Copilotで実行される他のGitHub Actionsタスクと同じリポジトリのカスタマイズが使用されます。

使用量と請求

AI creditsによって使用されるAgent Mergeは、そのプルリクエストでそれを有効にするユーザーに課金されます。pull request の作成者であるとは限りません。 使用量と許容量の詳細については、 GitHub Copilot の請求と使用状況 を参照してください。