Gemini Code Assist によるコード

このドキュメントでは、Google Cloud の AI を活用したコラボレーターである Gemini Code Assist を使用して、IDE で次のことを行う方法について説明します。

  • コードの問題を解決するためのガイダンスを提供する。
  • プロジェクトのコードを生成する。
  • コーディング時にインラインの候補を受け取る。

Gemini for Google Cloud がデータを使用する方法とタイミングについての説明をご確認ください。

コードに関するライセンス要件を遵守するために、Gemini Code Assist では、提案が特定のソースから詳細に直接引用を行っている場合、ソースの引用が提供されます。Gemini がソースを引用する方法とタイミングについて詳しくは、Gemini によるコードの生成とソースの引用方法をご覧ください。

コード カスタマイズを使用すると、組織のプライベート コードベースに基づいて、Gemini Code Assist から直接コード候補を取得できます。コードのカスタマイズを構成する方法を学習する。

このドキュメントは、全スキルレベルのデベロッパーを対象としています。IntelliJ の実践的な知識があり、Google Cloud を使い慣れていることを前提としています。必要に応じて、VS Code、Cloud Shell エディタ、Cloud Workstations で Gemini Code Assist を使用することもできます。

始める前に

  1. コードファイルで Gemini Code Assist の機能をテストする前に、ファイルのコーディング言語がサポートされていることを確認してください。サポートされているコーディング言語の詳細については、サポートされているコーディング言語をご覧ください。

  2. プロキシの背後で IDE を使用する場合は、HTTP プロキシをご覧ください。

Gemini Code Assist プラグインをインストールする

JetBrains IDE に Gemini Code Assist プラグインをインストールする手順は次のとおりです。

  1. settings [IDE and Project Settings] > [Plugins] をクリックします。
  2. [Marketplace] タブで「Gemini Code Assist」を検索します。
  3. [Install] をクリックしてプラグインをインストールします。
  4. インストールが完了したら、[Restart IDE] をクリックします。

  5. IDE が再起動すると、アクティビティ バーに Gemini Code Assist が表示されます。

    アクティビティ バーに Gemini Code Assist アイコンが表示されます。

これで、IDE で Gemini Code Assist を使用できるようになりました。

Google にログインして Google Cloud プロジェクトを選択する

このセクションでは、Google アカウントにログインします。IDE で Gemini Code Assist を初めて使用する場合は、Google Cloud プロジェクトを選択します。

Google アカウントにログインする手順は次のとおりです。

  1. アクティビティ バーで、spark [Gemini コード アシスタンス] をクリックします。

  2. [Log in to Google] をクリックします。

  3. ウェブブラウザで開いたページで、Google アカウントを選択します。

  4. このアプリを Google からダウンロードしたことを確認する画面で、[Sign in] をクリックします。

    Gemini Code Assist からアカウントにアクセスできるようになりました。

次に、IDE で Gemini を初めて使用する場合は、次の手順で Google Cloud プロジェクトを選択する必要があります。

  1. IDE に戻ります。Gemini Code Assist ツール ウィンドウで、選択したプロジェクトで Gemini Code Assist を使用するのに必要な API を Google が有効にすることに同意する場合は、[Select a GCP project] をクリックして続行します。

  2. [Select Google Cloud Project] ダイアログで、Google Cloud プロジェクトを検索して選択し、[OK] をクリックします。

  3. [FINISH] をクリックします。

Gemini Code Assist API が有効になっている Google Cloud プロジェクトが選択されています。IDE で Gemini を使用できるようになりました。

Gemini Code Assist とチャットする

このセクションでは、Gemini Code Assist に既存のコードの説明を依頼します。

コードの説明を取得する手順は次のとおりです。

  1. IDE でコードファイルを開きます。

  2. Gemini Code Assist ツール ウィンドウで、プロンプト「Explain this code to me」を入力し、[Submit] をクリックします。

    Gemini Code Assist は、コードファイル内のコードをプロンプトへの参照として使用し、コードの説明を返します。

    コードの特定の部分の説明のみが必要な場合は、特定のコードを選択して、Gemini Code Assist に再度指示できます。Gemini Code Assist は、生成されたレスポンスの参照としてのみ、選択したコードを使用します。

Gemini Code Assist に尋ねることができるその他のプロンプトの例を次に示します。

  • Write unit tests for my code.
  • Help me debug my code.
  • Make my code more readable.

Gemini Code Assist がレスポンスでコードを提供した場合は、レスポンスの末尾に表示される次のオプションを選択できます。

  • カーソル位置に挿入: 生成されたコードを、現在のカーソル位置の現在のファイルに挿入します。

  • 新しいファイルに挿入: 新しいファイルを開き、生成されたコードを新しいファイルに挿入します。

Gemini は、生成されたコードレスポンスの最後にコードアクションを一覧表示します。

これらのオプションは、Gemini Code Assist がコードブロックで使用されている言語を特定し、その言語が現在の IDE でサポートされている場合に使用できます。

クエリ履歴を表示する

以前のプロンプトを再利用する場合は、Gemini Code Assist ツール ウィンドウの [Query History] で、schedule [Show Query History] をクリックして確認できます。

ツール ウィンドウの Gemini クエリ履歴。

クエリと会話の履歴は IDE セッション間で保持されます。クエリと会話の履歴を消去するには、delete [Clear Conversation History] をクリックします。

Gemini ツール ウィンドウで会話履歴を消去するボタン。

プロンプトを使用してコードを生成する

以降のセクションでは、Gemini Code Assist を使用して、クイック選択メニューで /generate function to create a Cloud Storage bucket などのコード変換を行う方法について説明します。

コード変換を使用すると、クイック選択メニューでコマンドまたは自然言語プロンプトを使用してコードの変更をリクエストできます。また、コードの保留中の変更を示す差分ビューも提供されます。

また、コーディング中には、コードの一部を選択して、Gemini Code Assist ツール ウィンドウで Gemini Code Assist にサポートを求め、コードの候補から取捨選択することも可能です。

コード変換で Gemini Code Assist をプロンプトする

  1. コードファイルの新しい行で、Alt+\（Windows および Linux の場合）または Cmd+\（macOS の場合）を押して、Gemini Code Assist クイック選択メニューを開きます。

  2. メニューで /generate コマンドを使用して「/generate function to create a Cloud Storage bucket」と入力し、Enter（Windows と Linux の場合）または Return（macOS の場合）を押します。

    IntelliJ Gemini Code Assist のコード変換生成関数

    Gemini Code Assist は、差分ビューでプロンプトに基づいてコードを生成します。

    IntelliJ Gemini Code Assist のコード変換差分ビュー

  3. 省略可: これらの変更を承認するには、[変更を承認] をクリックします。

IDE では、次のコード変換コマンドを使用できます。

  • /fix: コードの問題やエラーを修正します。例: /fix potential NullPointerExceptions in my code
  • /generate: コードを生成する。例: /generate a function to get the current time
  • /doc: コードにドキュメントを追加します。例: /doc this function
  • /simplify: コードを簡素化します。例: /simplify if statement in this code

コードファイルでコメントを使用して Gemini Code Assist に指示する

  1. コードファイルの新しい行で、コメント Function to create a Cloud Storage bucket を入力します。

  2. コードを生成するには、Alt+G（Windows および Linux の場合）または Option+G（macOS の場合）を押します。または、コメントの横を右クリックして [Generate Code] を選択します。

    Gemini Code Assist は、コメントの下にゴースト テキスト形式でコードを生成します。

  3. 省略可: 生成されたコードを受け入れるには、Tab を押します。

省略可: コードを生成するためのキーボード ショートカットを変更します

前のセクションで説明したように、コードを生成するためのデフォルトのキーボード ショートカットが動作しない場合は、次の手順でキーボード ショートカットを変更できます。

  1. settings [IDE and Project Settings] > [Settings] > [Keymap] > [Gemini Code Assist] に移動します。

  2. [Gemini Code Assist] を右クリックし、[Add Keyboard Shortcut] を選択します。

  3. 任意のキーボード ショートカットを入力して、[OK] をクリックします。

  4. [Gemini Code Assist] を右クリックし、[Remove Alt+G]（Windows および Linux の場合）または [Remove Option+G]（macOS の場合）を選択します。

    新しいキーボード ショートカットを使用して、コードファイルでコードを生成できるようになりました。

選択したコードを使用してチャットで Gemini Code Assist に指示する

Gemini Code Assist は、選択したコードに基づいてタスクを実行したり、質問に回答したりすることが可能です。選択したコードとプロンプトに基づいて生成されたコードを取得するには、次の手順を行います。

  1. アクティビティ バーで、spark [Gemini Code Assist] をクリックして [Gemini Code Assist] ツール ウィンドウを開きます。

  2. コードファイルで、コードのブロックを選択します。

  3. [Gemini Code Assist] ツール ウィンドウのテキスト フィールドに、選択したコードに対するプロンプトを入力します。

    たとえば、コード内の関数を選択し、プロンプト「Write a unit test for this function.」を入力します。

    Gemini Code Assist は、選択したコードをリファレンスとして使用し、プロンプトに応答します。

コード補完を取得する

Gemini Code Assist は、コードの記述時に、インライン コードの候補（コード補完）を作成します。ユーザーはこれを取捨選択できます。コード補完を取得する手順は次のとおりです。

  1. コードファイルの新しい行で、関数の作成を開始します。たとえば、Python ファイルの場合は、「def」と記述します。

    Gemini Code Assist は、インライン候補の形式でコードの候補を表示します。

  2. Gemini Code Assist からのコード候補を受け入れるには、Tab を押します。それ以外で、提案を無視するには、Esc を押すか、引き続きコードを記述します。

  3. 省略可: 別のショートカットキーを使用してインライン候補を承認する場合は、インライン候補の上にポインタを置き、表示された [Tab] プルダウンをクリックします。次に、お好みのショートカットを選択するか、[Custom] をクリックして独自のショートカットを入力します。

    Gemini には、プルダウン メニューからショートカットを変更して、インラインの候補を受け入れられるようにする機能があります。

コード補完はデフォルトで有効になっています。コード補完を無効にするには、IDE のステータスバーで spark [Gemini Code Assist: Active] をクリックし、[Enable AI Code Completion] を選択します。

IntelliJ のステータスバーにある Gemini コード補完ボタン。

これにより、コード補完設定が無効になり、設定を再度有効にするまで Gemini Code Assist はインライン候補を行わなくなります。

スマート アクションを使用する

コンテキストの切り替えを最小限に抑えながら生産性を向上させるため、Gemini Code Assist では、AI を活用したスマート アクションをコードエディタに直接備えています。コードエディタでコードを選択すると、コンテキストに関連するアクションのリストを表示して選択できます。

コードでスマート アクションを使用するには、次の手順を行います。

  1. コードファイルで、コードの行またはブロックを選択します。

  2. 選択したコードを右クリックし、[Generate unit tests] などのスマート アクションを選択します。

    スマート アクションを選択すると、Gemini Code Assist が自動的にプロンプトに応答を生成して、[Gemini Code Assist] ツール ウィンドウに表示します。

省略可: .aiexclude ファイルを使用してファイルをコンテキストから除外する

.aiexclude ファイルを作成すると、Gemini Code Assist がコンテキストとして検討するファイルを除外できます。.aiexclude ファイルは .gitignore ファイルと同様ですが、次の点が異なります。

  • 空の .aiexclude ファイルまたは存在しない .aiexclude ファイルは、そのディレクトリとすべてのサブディレクトリ内のファイルをブロックしません。
  • .aiexclude ファイルでは、パターンの前に感嘆符（!）を付ける否定演算はサポートされていません。
  • .aiexclude ファイルは、* 文字に貪欲に一致します。これにより、ディレクトリとファイルが区別なく照合されます。この .aiexclude ファイルは、フォルダやファイルに関して ** と * を区別しません。

現在サポートされているのは 1 つの .aiexclude ファイルのみです。.aiexclude ファイルを構成するには、ワークスペース フォルダのルートに .aiexclude という名前のファイルを作成します。

例

次の例は、.aiexclude ファイルを構成する方法を示しています。

  • ワークスペース ディレクトリ以下にある apikeys.txt という名前のすべてのファイルをブロックします。

    apikeys.txt

  • ワークスペース ディレクトリ以下にある .key ファイル拡張子を持つすべてのファイルをブロックします。

    *.key

  • .aiexclude ファイルと同じディレクトリにある apikeys.txt ファイルのみをブロックし、サブディレクトリはブロックしないでください。

    /apikeys.txt

  • my/sensitive/dir ディレクトリとすべてのサブディレクトリ内のすべてのファイルをブロックします。パスは、ワークスペースのルート ディレクトリを基準とする相対パスにする必要があります。

    my/sensitive/dir/*

フィードバック

体験へのフィードバックを残すには、次の手順に従います。

  1. ステータスバーで spark [Gemini Code Assist] をクリックし、メニューで [Submit feedback] を選択します。

  2. フォーム上部のテキスト フィールドにフィードバックを入力します。

  3. Gemini Code Assist のログを共有する場合は、必ずログファイルを選択してください。

  4. [フィードバックを送信する] をクリックします。

次のステップ