マージリクエストにおけるGitLab Duo
GitLab Duoは、マージリクエストのライフサイクル全体を通じて、コンテキストに応じた関連情報を提供するように設計されています。
コード変更を要約して説明を生成する
- プラン: Premium、Ultimate
- アドオン: GitLab Duo Enterprise
- 提供形態: GitLab.com、GitLab Self-Managed
- ステータス: ベータ版
マージリクエストを作成または編集する際に、GitLab Duoマージリクエストサマリーを使用してマージリクエストの説明を作成します。
説明フィールドで、説明を挿入したい場所にカーソルを置きます。
テキストエリア上部のツールバーで、コード変更のサマリー（ ）を選択します。
カーソルがあった場所に説明が挿入されます。
イシュー443236で、この機能に関するフィードバックをお寄せください。
データ使用: ソースブランチのヘッドとターゲットブランチ間の変更差分が、大規模言語モデルに送信されます。
GitLab Duoを使用してコードをレビューする
GitLab Duoは、マージリクエストをレビューし、潜在的なエラーを検出したり、標準への適合性に関するフィードバックを提供します。
GitLab Duoにレビューをリクエストすると、使用しているアドオンに応じて、2つのコードレビュー機能のいずれかが自動的に実行されます。グループのオーナーロールを持つユーザーは、すべてのユーザーに対してどちらの機能を実行するかを設定できます。
| 詳細 | コードレビューフロー | GitLab Duoコードレビュー |
|---|---|---|
| レビュアー | @GitLabDuo | @GitLabDuo |
| タイプ | エージェント型 | 非エージェント型 |
| 必須アドオン | なし。GitLabクレジットを使用します。 | GitLab Duo Enterprise |
| コンテキスト認識 | リポジトリ構造とファイル間の依存関係をより高度に理解 | マージリクエストと、その中のファイルの差分に重点を置く |
| 分析 | 複数ステップのエージェント型推論 | 単一パス |
| セッション作成 | いいえ | |
| 自動レビュー | ||
| カスタム指示 | ||
| カスタムコメント |
実行するレビュー機能を決定する
デフォルトでは、GitLabが実行するコードレビュー機能は、レビューを開始したユーザーによって決まります。
| レビューのトリガー | 開始ユーザー |
|---|---|
| レビューを手動でリクエスト | レビューをリクエストしたユーザー。 |
| マージリクエストを作成（ドラフトではない） | マージリクエストの作成者。 |
| ドラフトのマージリクエストを準備完了としてマーク | マージリクエストの作成者。 |
開始ユーザーにGitLab Duo Enterpriseシートが割り当てられている場合、GitLab Duoコードレビューが実行されます。割り当てられていない場合、コードレビューフローが実行されます。同じプロジェクトで両方の機能を実行できます。
グループのオーナーロールを持つユーザーは、シートの種類に関係なく、すべてのレビューでコードレビューフローを使用するように設定できます。コードレビューフローが実行された場合、GitLabクレジットの使用量は開始ユーザーに帰属します。
レビューを実行した機能を確認するには、マージリクエストのアクティビティフィードを確認します。コードレビューフローが実行されると、レビューセッションが開始されます。レビューセッションが表示されない場合は、GitLab Duoコードレビューによってレビューが実行されています。
レビューの完了後、プロジェクトのセッションでコードレビューフローセッションを確認することもできます。
GitLab Duo Enterpriseシートでコードレビューフローをオンにする
GitLab Duo Enterpriseシートの所有者がGitLabクレジットを消費する機能を使用しないようにするため、これらのユーザーが開始するすべてのコードレビューでは、デフォルトでGitLab Duoコードレビューを使用します。この動作は、オーナーロールを持つユーザーがグループに対してコードレビューフローをオンにしている場合でも適用されます。
このデフォルトを変更して、ユーザーのシートに関係なく、すべてのコードレビューでコードレビューフローを使用するように設定できます。
GitLab Duo Enterpriseシートのデフォルトのコードレビュー機能をオーバーライドするには:
前提条件:
- トップレベルグループのオーナーロール。
- トップレベルグループに対してコードレビューフローがオンになっており、正しく設定されている。
- 上部のバーで検索または移動先を選択して、トップレベルグループを見つけます。
- 設定 > GitLab Duoを選択します。
- 設定の変更を選択します。
- フローの実行 > 基本フローを許可で、コードレビューフローチェックボックスをオフにしてから、もう一度オンにします。
- 確認ダイアログで、コードレビューフローを有効にするを選択します。
前提条件:
- グループのメンテナーまたはオーナーのロール。
- インスタンスに対してコードレビューフローがオンになっており、正しく設定されている。
- 上部のバーで、検索または移動先を選択して、グループまたはサブグループを見つけます。
- 設定 > 一般を選択します。
- GitLab Duoの機能を展開します。
- フローの実行で、コードレビューフローチェックボックスをオフにし、変更を保存を選択します。
- もう一度GitLab Duoの機能を展開し、フローの実行で、コードレビューフローチェックボックスをオンにします。
- 確認ダイアログで、コードレビューフローを有効にするを選択します。
- 変更を保存を選択します。
これで、グループ内のすべてのコードレビューでコードレビューフローが実行され、GitLabクレジットが消費されます。すべてのレビューをGitLab Duoコードレビューに戻すには、コードレビューフローをオフにします。
GitLab Duoでディスカッションを解決する
- プラン: Premium、Ultimate
- 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated
この機能の利用可否は、機能フラグによって制御されます。詳細については、履歴を参照してください。
GitLab Duoを使用して、マージリクエストのレビューディスカッションを解決します。
GitLab Duoにディスカッションの解決を依頼すると、レビューコメントとその周辺のコードを読み取り、ソースブランチにリクエストされた変更を加えて、その変更をコミットおよびプッシュします。その後、GitLab Duoは変更のサマリーをディスカッションに返信し、スレッドを解決します。
この機能では、GitLab Duo Agent Platformのデベロッパーフローを使用します。
前提条件:
- プロジェクトのデベロッパー、メンテナー、またはオーナーロール。
- GitLab Duo Agent Platformの前提条件。
- トップレベルグループで、基本フローを許可とデベロッパーを有効にしている。
- サービスアカウントを許可するようにプッシュルールを設定している。
- 独自のRunnerを設定しているか、プロジェクトでGitLabホストRunnerをオンにしている。
GitLab Duoでディスカッションを解決するには:
- マージリクエストで、未解決のディスカッションに移動します。
- スレッドを解決の横にあるその他の解決オプション（ ）を選択します。
- GitLab Duoで解決を選択します。
GitLab Duoによってセッションが開始されます。このセッションは、プロジェクトのセッションで追跡できます。
コードレビューのサマリーを生成する
- プラン: Premium、Ultimate
- アドオン: GitLab Duo Enterprise
- 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated
- ステータス: 実験的機能
マージリクエストのレビューを完了し、レビューを送信する準備ができたら、GitLab Duoコードレビューサマリーを使用してコメントのサマリーを生成します。
- 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
- 左側のサイドバーで、コード > マージリクエストを選択し、レビューするマージリクエストを見つけます。
- レビューを送信する準備ができたら、レビューを終了を選択します。
- サマリーを追加を選択します。
サマリーはコメントボックスに表示されます。レビューを送信する前に、サマリーを編集して改善することができます。
イシュー408991で、この実験的機能に関するフィードバックをお寄せください。
データ使用: この機能を使用すると、次のデータが大規模言語モデルに送信されます:
- ドラフトコメントのテキスト
マージコミットメッセージを生成する
- プラン: Premium、Ultimate
- アドオン: GitLab Duo Enterprise、GitLab Duo with Amazon Q
- 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated
マージリクエストをマージする準備をするときは、GitLab Duoマージコミットメッセージ生成を使用して、提案されたマージコミットメッセージを編集します。
- 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
- 左側のサイドバーで、コード > マージリクエストを選択して、マージリクエストを見つけます。
- マージウィジェットでコミットメッセージを編集チェックボックスを選択します。
- コミットメッセージを生成を選択します。
- 提供されたコミットメッセージをレビューし、挿入を選択してコミットに追加します。
データ使用: この機能を使用すると、次のデータが大規模言語モデルに送信されます:
- ファイルの内容
- ファイル名
関連トピック
トラブルシューティング
マージリクエストでGitLab Duoを使用する場合、次の問題が発生する可能性があります。
応答がない
@GitLabDuoにメンションまたは返信してGitLab Duoにレビューをリクエストしても応答がない場合は、適切なGitLab Duoアドオンがないことが原因である可能性があります。
GitLab Duoアドオンを確認するには、グループのGitLab Duoシートの割り当てを確認するようグループオーナーに依頼してください。
GitLab Duoアドオンを変更するには、管理者にお問い合わせください。
GitLab Duoをレビューに割り当てることができない
GitLab Duoをレビュアーとして割り当てることができない場合は、適切なGitLab Duoアドオンがないことが原因である可能性があります。
GitLab Duoアドオンを確認するには、グループのGitLab Duoシートの割り当てを確認するようグループオーナーに依頼してください。
GitLab Duoアドオンを変更するには、管理者にお問い合わせください。
エラー: GitLab Duo Code Review was not automatically added...
GitLab Duoからの自動レビューをオンにしてマージリクエストを作成しようとすると、次のエラーメッセージが表示される場合があります:
GitLab Duo Code Review was not automatically added because your account requires
GitLab Duo Enterprise. Contact your administrator to upgrade your account.管理者に連絡して、GitLab Duo Enterpriseシートを購入し、自分に割り当てるよう依頼してください。