pull request 向けの Copilot コード レビューの使用を開始する

Azure DevOps サービス

Important

この機能は限定パブリック プレビュー 段階であり、サインアップが必要です。 組織へのアクセスを要求するには、 パブリック プレビューにサインアップします。

機能は予告なく変更または削除される場合があります。 プレビュー機能には、サービス レベル アグリーメント (SLA) および制限付きサポートはありません。

GitHub Copilotを使用して、Azure Reposの pull request を確認します。 Copilotは、変更されたコードにコメントや提案を投稿する自動レビュー担当者として機能するため、人間のレビュー担当者がサインオフする前にフィードバックを受け取ります。

この機能を使用するには、Project コレクション管理者が組織に対してオンにし、リポジトリ所有者が各リポジトリに対してオンにし、個々のユーザーがプレビュー機能を使用してオプトインします (管理者がすべてのユーザーに対してプレビューを有効にしない限り)。

Prerequisites

カテゴリ 必要条件
組織 Azure DevOps の組織
リポジトリ Azure Reposの Git リポジトリ。 TFVC はサポートされていません。
組織のアクセス許可 Project コレクション管理者組織レベルで機能を有効にします。
リポジトリのアクセス許可 リポジトリの所有者または管理者がリポジトリの機能を有効にします。
請求書 Azure DevOps組織にリンクされているAzure サブスクリプション。 Copilot コードレビューの利用分は、Azure Cost Management 経由で請求されます。 詳細については、請求を参照してください。

組織レベルで Copilot コード レビューを有効にする

プロジェクト コレクション管理者は、リポジトリ所有者が個々のリポジトリで Copilot コード レビューを有効にする前に、組織レベルでこれを有効にする必要があります。

  1. Azure DevOps 組織 (https://dev.azure.com/{yourorganization}) にサインインします。

  2. Organization settings>Repos>Repositories を選択します。

  3. GitHub Copilot コードレビュー で、この組織のリポジトリに Copilot コードレビューの使用を許可するOn に切り替えます。

    リポジトリで Copilot コード レビューを使用できるようにするトグルがオンに設定されている組織の設定ページ。

リポジトリ レベルで Copilot のコード レビューを有効にする

組織レベルのアクセスが有効になると、リポジトリ所有者は、それを使用する必要がある各リポジトリCopilotコード レビューを有効にします。

  1. プロジェクト設定>リポジトリ>リポジトリ を選択します。

  2. 有効にするリポジトリを選択します。

  3. Settings タブで、このリポジトリ内のプル要求のコード レビューを有効にするCopilotOn に切り替えます。

    プル リクエストの Copilot コード レビューを有効にするトグルがオンに設定されているリポジトリの設定ページ。

個別ユーザー向けに Copilot のコード レビューを有効にする

組織レベルとリポジトリ レベルで機能を有効にすると、個々のユーザーは プレビュー機能を使用してオプトインできます。

  1. 右上のユーザー アバターを選択し、[ プレビュー機能] を選択します。

  2. スコープを 自分用に設定します。

  3. Copilot の pull request 用コード レビューを見つけて、On に切り替えます。

    Pull Requests 用の Copilot Code Review がオンに設定されたプレビュー機能パネル。

Tip

Project コレクション管理者は、スコープを この組織 に設定して、すべてのユーザーのプレビューを一度に有効にすることができます。

この機能が有効になっていることを確認するには、リポジトリで pull request を開きます。 GitHub Copilotは、Reviewers リストに使用可能なレビュー担当者として表示されます。

Copilot のコードレビューを使用する

この機能を 3 つのスコープすべてで有効にすると、pull request を確認するようにCopilotに依頼できます。 次のセクションでは、想定される内容について説明します。

レビューを要求する

既定では、GitHub Copilot は pull request を要求した場合にのみ確認します。

  1. pull request を開きます。
  2. Reviewers セクションで、GitHub Copilot の横にある Request を選択します。
  3. レビューが完了するまで待ちます。 リポジトリのサイズとプル要求の変更の数によっては、レビューにしばらく時間がかかる場合があります。 レビューが完了すると、状態が [ レビュー完了] に変わります。

Copilot が潜在的な問題を特定すると、確認して対処できるように、プル リクエストにコメントと提案を直接追加します。

Copilotのコメントを読む

  • Copilotは、pull request に GitHub Copilot という名前の通常のレビュー担当者としてフィードバックを投稿します。
  • 各コメントは、適用対象のコード行に表示され、可能な場合は、1 回のクリックで適用できる推奨される変更が含まれます。
  • Copilot常に Comment レビューを残します。 これはプル リクエストを承認することも変更をリクエストすることもないため、そのレビューは必須レビュー担当者ポリシーの要件を満たさず、マージをブロックしません。
  • Copilotのコメントは、人間の校閲者からのコメントのように動作します。 返信、対応、解決、非表示を切り替えることができます。 Copilotは返信を読み取らないし、フォローアップもしません。

新しいコミット後に再確認する

Copilotは、新しいコミットをプッシュするときに pull request を自動的に再レビューしません。 コミット後に新しいレビューを取得するには、Reviewers> リストの GitHub Copilot の横にある Request を再度選択します。

レビューに関するフィードバックを送信する

各Copilotコメントには、サムアップ コントロールとサムダウン コントロールが含まれています。 これを使用して、特定のコメントが役に立ったかどうかをCopilotチームに伝えます。 サムダウンを選択した場合は、必要に応じて理由を選択し、送信する前に詳細を追加できます。

要件と制限

プレビュー期間中は次の要件と制限が適用され、変更される可能性があります。

Copilotは、次の要件を満たしている場合にのみ、pull request を確認します。

要件 価値
プルリクエストの状態 アクティブ
プル リクエストのマージ ステータス マージ競合なし (マージ成功)
リポジトリのサイズ 10 GB 以下
プルリクエストで変更されたファイル 100 個以下のファイル

これらのコンカレンシーとレートの制限も適用されます。

制限 価値
同じプル要求バージョンに対するレビューの重複 マージコミットごとに完了済みレビュー 1 件
プル リクエストごとの同時レビュー 1
組織ごとの同時レビュー 5
ユーザーごとの同時レビュー 2

Billing

完了した各コード レビューでは、モデルに送信された入力トークン、モデルによって生成された出力トークン、既存のコンテキストを再利用するキャッシュ されたトークンなど、トークンが使用されます。 各レビューに使用されるトークンは、GitHub AI クレジットと呼ばれる標準的な課金単位に変換されます。1 クレジットは $0.01 USD です。

料金は、Azure DevOps組織にリンクされているAzure サブスクリプションに移動し、Azure Cost Managementでは別のメーターとして表示されます。 各レビューのコストは、プル要求のサイズや変更された行数などの要因によって異なります。 環境内で予想されるコストを見積もるために、最初に 1 つまたは 2 つのリポジトリの機能を有効にして、毎日の使用状況を監視します。

1 日の料金を監視するには:

  1. Azure ポータルで、サブスクリプションに移動します。

  2. [Cost Management]>[コスト分析] の順に選択します。

  3. 製品でフィルター処理して、組織の毎日のコストを表示します。

    Copilot のコード レビューの請求額を表示するために製品で絞り込んだ Azure Cost Management のコスト分析のスクリーンショット。

よく寄せられる質問 (FAQ)

トークンに対して課金される定価はどこで確認できますか?

GitHub Copilot ドキュメントのモデルと価格を参照してください。

コード レビューで使用されるトークンの数に影響を与える要因は何ですか?

トークンの使用は、リポジトリのサイズ、変更のサイズ、レビューされるコードの複雑さなどの要因によって異なります。

Copilot サブスクリプションで購入したクレジットは、Azure DevOpsでのコード レビューの使用量にカウントされますか? GitHub Copilot プランの AI クレジットを使用できますか?

いいえ。Azure DevOpsでの使用は、GitHub Copilotプランから AI クレジットを引き出すわけではありません。

Copilot のコード レビューをオフにする

Copilot のコード レビューの使用を停止するには、無効にしたいスコープでトグルを Off に設定します。

  • 1 人のユーザーの場合: ユーザー設定で [プレビュー機能 ] トグルをオフにします。
  • 1 つのリポジトリの場合: Project settings>Repos>Repositories でリポジトリの切り替えをオフにします。
  • 組織全体: Organization settings>Repos>Repositories で組織の切り替えをオフにします。 このアクションにより、すべてのリポジトリの機能が無効になります。

フィードバックの共有

このプレビューに関する問題を報告したり、フィードバックを共有したりするには、Azure DevOps Developer Communityにアクセスしてください。

次のステップ