コード提案

GitLab Duoコード提案を使用すると、開発中に生成AIを使用してコードを提案することにより、より効率的にコードを作成できます。

• クリックスルーデモについては、こちらをご覧ください。
• 概要を見る

前提要件

コード提案を使用するには、以下が必要です:

• GitLab Duo Core、Pro、またはEnterpriseアドオン。
• PremiumまたはUltimateサブスクリプション。
• GitLab Duo ProまたはEnterpriseをお持ちの場合は、割り当て済みのシート。
• GitLab Duo Coreをお持ちの場合は、IDE機能をオンにする。

コード提案を使用する

前提要件:

• コード提案を設定している必要があります。

コード提案を使用するには、以下の手順に従います:

1. サポートされているIDEでGitプロジェクトを開きます。

2. git remote addを使用して、ローカルリポジトリのリモートとしてプロジェクトを追加します。

3. 非表示の.git/フォルダーを含むプロジェクトディレクトリを、IDEワークスペースまたはプロジェクトに追加します。

4. コードを作成します。入力すると、候補が表示されます。コード提案は、カーソルの位置に応じて、コードスニペットを提供するか、現在の行を完了します。

5. 要件を自然言語で記述します。コード提案は、提供されたコンテキストに基づいて関数とコードスニペットを生成します。

6. 候補を受け取ったら、次のいずれかを実行できます:

   • 候補に賛成の場合は、Tabキーを押します。
   • 部分的な候補に賛成の場合は、Control+右矢印またはCommand+右矢印を押します。
   • 候補に賛成しない場合は、Escキーを押します。Neovimでメニューを終了するには、Control+Eを押します。
   • 候補を無視するには、通常どおり入力を続けます。

複数のコード提案を表示する

VS Codeのコード補完候補では、複数の候補オプションを利用できる場合があります。利用可能なすべての候補を表示するには、以下の手順に従います:

1. コード補完候補にカーソルを合わせます。
2. 代替案をスクロールします。次のいずれかの操作を行います:
   • キーボードショートカットを使用します:
     • Macでは、Option + [を押して前の候補を表示し、Option + ]を押して次の候補を表示します。
     • LinuxとWindowsでは、Alt + [を押して前の候補を表示し、Alt + ]を押して次の候補を表示します。
   • 表示されるダイアログで、右矢印または左矢印を選択して、次または前のオプションを表示します。
3. Tabを押して、希望する候補を適用します。

コード補完と生成

コード提案は、次のようなコード補完とコード生成を使用します:

コード提案は常にこれらの両方の機能を使用します。コード生成のみ、またはコード補完のみを使用することはできません。

コード補完とコード生成の比較デモを見る。

コード生成のベストプラクティス

コード生成で最良の結果を得るには、次を参考にしてください:

• シンプルさを保った上で、できるだけ具体的にしてください。
• 生成する結果（関数など）を記述し、何を達成したいかについて詳しく説明してください。
• 使用するフレームワークやライブラリなど、詳細な情報を追加してください。
• 各コメントの後にスペースまたは改行を追加してください。こうしたスペースにより、指示が完了したことをコードジェネレーターに伝えられます。
• GitLab 17.2以降で、advanced_context_resolverおよびcode_suggestions_context機能フラグが有効になっている場合は、他のタブで関連ファイルを開き、コード提案が認識しているコンテキストを拡大してください。

たとえば、特定の要件を持つPython Webサービスを作成するには、次のように記述します:

# Create a web service using Tornado that allows a user to sign in, run a security scan, and review the scan results.
# Each action (sign in, run a scan, and review results) should be its own resource in the web service
...

AIは決定的ではないため、同じ入力を使用しても毎回同じ候補が得られるとは限りません。高品質なコードを生成するには、明確かつ記述的で具体的なタスクを記述してください。

ユースケースとベストプラクティスについては、GitLab Duoの例のドキュメントに従ってください。

ファイルコンテンツの切り捨て

LLMの制限とパフォーマンス上の理由により、現在開いているファイルのコンテンツは次のトークン以降で切り捨てられます:

• コード補完の場合は、32,000トークン（約128,000文字）まで。
• コード生成の場合は、200,000トークン（約800,000文字）まで。

カーソルより上のコンテンツは、カーソルより下のコンテンツよりも優先されます。カーソルより上のコンテンツは左側から切り捨てられ、カーソルより下のコンテンツは右側から切り捨てられます。これらの数値は、コード提案の最大入力コンテキストサイズを表しています。

出力の長さ

LLMの制限とパフォーマンス上の理由から、コード提案の出力は次のように制限されています:

• コード補完の場合は、最大64トークン（約256文字）まで。
• コード生成の場合は、最大2048トークン（約7168文字）まで。

結果の精度

当社では、生成されたコンテンツ全体の精度を向上させるため、継続的に改善を行っています。ただし、コード提案では、次のような提案が生成される可能性があります:

• 無関係なもの。
• 不完全なもの。
• パイプラインで失敗するもの。
• 潜在的に脆弱なもの。
• 不快または配慮のないもの。

コード提案を使用する場合でも、コードレビューのベストプラクティスが引き続き適用されます。

利用可能な言語モデル

異なる言語モデルをコード提案のソースにすることができます。

• GitLab.comでは、: GitLabがモデルをホストし、クラウドベースのAIゲートウェイを介してモデルに接続します。
• GitLab Self-Managedの場合、次の2つのオプションがあります:
  • GitLabは、モデルをホストし、クラウドベースのAIゲートウェイを介してモデルに接続できます。
  • 組織でGitLab Duo Self-Hostedを使用することができます。この場合、AIゲートウェイと言語モデルを自分でホストします。GitLab人工知能AIベンダーモデル、サポートされているその他の言語モデルを使用するか、独自の互換性のあるモデルを持ち込むことができます。

プロンプトの作成方法

プロンプトを作成するコードについては、次のファイルを参照してください:

• コード生成: ee/lib/api/code_suggestions.rb（gitlabリポジトリ内）。
• コード補完: ai_gateway/code_suggestions/processing/completions.py（modelopsリポジトリ内）。

プロンプトのキャッシュ

コード提案のレイテンシーを改善するために、プロンプトのキャッシュがデフォルトで有効になっています。プロンプトのキャッシュが有効になっている場合、コード補完プロンプトデータは、モデルベンダーによって一時的にメモリに保存されます。プロンプトのキャッシュは、キャッシュされたプロンプトとインプットデータの再処理を回避することで、レイテンシーを大幅に改善します。キャッシュされたデータは、永続ストレージに記録されません。

プロンプトのキャッシュを無効にする

GitLab Duoの設定でトップレベルグループのプロンプトのキャッシュを無効にすることができます。

GitLab.comの場合:

1. 左側のサイドバーで、検索または移動先を選択して、グループを見つけます。
2. 設定 > GitLab Duoを選択します。
3. 設定の変更を選択します。
4. Prompt caching（プロンプトのキャッシュ）切替を無効にします。
5. 変更を保存を選択します。

GitLab Self-Managedの場合:

1. 左側のサイドバーの下部で、管理者を選択します。
2. GitLab Duoを選択します。
3. Change Configuration（設定の変更）を選択します。
4. プロンプトキャッシュで、プロンプトキャッシュを有効にするチェックボックスをオフにします。
5. 変更を保存を選択します。

応答時間

コード提案は、生成AIモデルによって強化されています。

• コード補完の場合、通常、提案は低レイテンシーです。1秒未満で完了します。
• コード生成の場合、アルゴリズムまたは大きなコードブロックの生成に5秒以上かかる場合があります。

パーソナルアクセストークンを使用すると、GitLab.comまたはGitLabインスタンスへの安全なAPI接続が可能になります。このAPI接続により、IDE/エディタからGitLab AIゲートウェイにコンテキストウィンドウを安全に送信できます。ゲートウェイは大規模言語モデルAPIを呼び出し、生成された候補がIDE/エディタに送り返されます。

ストリーミング

コード生成応答のストリーミングはJetBrainsとVisual Studioでサポートされています。それにより、応答時間が短くなっています。その他のサポートされているIDEは、生成されたコードを単一のブロックで返します。

コード補完では、ストリーミングは有効になっていません。

ダイレクト接続とインダイレクト接続

デフォルトでは、レイテンシーを最小限に抑えるため、コード補完リクエストはIDEからAIゲートウェイに直接送信されます。この直接接続を機能させるには、IDEがhttps://cloud.gitlab.com:443に接続可能な状態である必要があります。これが不可能な場合は（たとえば、ネットワーク制限のため）、すべてのユーザーに対してダイレクト接続を無効にできます。この場合、コード補完リクエストはGitLab Self-Managedインスタンスを介して間接的に送信され、次にリクエストがAIゲートウェイに送信されます。これにより、リクエストのレイテンシーが高くなる可能性があります。

ダイレクト接続またはインダイレクト接続の設定

前提要件:

• GitLab Self-Managedインスタンスの管理者である必要があります。

フィードバック

イシュー435783で、GitLab Duoコード提案のエクスペリエンスに関するフィードバックをお寄せください。