Gemini Code Assist によるコード

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

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

Gemini がプロンプトやそのレスポンスをデータとして使用してモデルをトレーニングすることはありせん。詳細については、Google Cloud の Gemini がデータを使用する方法をご覧ください。

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

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

始める前に

Cloud Code プラグインをインストールします（まだインストールしていない場合）。Gemini Code Assist は Cloud Code と統合されており、AI を活用したコラボレーターをローカルの IDE に取り込めます。
省略可: このドキュメントのタスク用にサンプルのクローンを作成する場合は、Git をインストールします。サンプルをマシンにコピーするには Git が必要です。

Google Cloud に接続してプロジェクトを選択する

このセクションでは、Google Cloud に接続し、IDE で Cloud AI Companion API が有効になっている Google Cloud プロジェクトを選択します。

Cloud AI Companion API を有効にせずに Google Cloud プロジェクトを選択すると、エラー通知が表示され、管理者に問い合わせるように指示されます。詳細については、プロジェクトに Gemini Code Assist を設定するをご覧ください。

IDE で Google Cloud に接続するには、次の手順を実施します。

IDE を起動します。
[ツール] > [Google Cloud Code] > [Sign in to Google Cloud Platform] をクリックします。
画面の指示に沿って Google アカウントにログインします。
Cloud Code を Google からダウンロードしたことを確認するメッセージが表示されたら、[ログイン] をクリックします。

これで Google Cloud に接続されました。

次に、Cloud AI Companion API が有効になっている Google Cloud プロジェクトを選択する手順は次のとおりです。

[Gemini コードアシスタンス] ステータスバーで [Gemini コードアシスタンス] をクリックします。
[Gemini コードアシスタンス] メニューで [設定] を選択します。
[Cloud Project] フィールドで、more_horiz [Select Google Cloud Project] をクリックし、Cloud AI Companion API が有効になっているプロジェクトを選択します。

Gemini を使用する準備が整いました。

Gemini Code Assist の機能をテストするには、アプリケーションを開くか、次のセクションでサンプルアプリケーションを作成します。

省略可: サンプルアプリケーションを作成する

既存のアプリケーションを使用して Gemini Code Assist の機能をテストする場合は、このセクションをスキップしてください。スキップしない場合は、次の手順でサンプルアプリケーションを作成します。

IDE で、[File] > [New] > [Project] をクリックします。
[新しいプロジェクト] ウィンドウの左側のペインで、[Cloud Code: Kubernetes] を選択します。
使用する言語に対応するサンプル ゲストブックの 1 つを選択し、[Next] をクリックします。

注: このドキュメントの例では、Python（Flask）: ゲストブックのサンプルアプリケーションを使用します。
プロジェクト名を入力してプロジェクトのロケーションを選択します。
[作成] をクリックします。

Cloud Code によって Python（Flask）テンプレートのクローンが作成され、新しく作成したプロジェクトが開かれます。

Gemini Code Assist とチャットする

このセクションでは、[Gemini コードアシスタンス] ペインを開き、Gemini コードアシスタンスとチャットして、既存のコードの説明を取得する方法について学習します。

Gemini とチャットを開始するには、次の手順を行います。

コードファイルを作成するか、既存のコードファイルを使用します。Python（Flask）サンプルを使用している場合は、front.py ファイルでこのタスクを実行できます。front.py ファイルは、[Project] ツールウィンドウで、[src] > [フロントエンド] に移動して開きます。
ステータスバーで [Gemini コードアシスタンス] をクリックし、[Open chat] を選択します。
[Gemini コードアシスタンス] チャットウィンドウで、プロンプト Explain this code to me を入力して [Send] をクリックします。

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

チャット履歴をリセットする

Gemini コードアシスタンスは、プロンプトへの応答時に、追加のコンテキストとしてチャット履歴を使用します。

チャットの履歴と、実現しようとしていることとの関連性がなくなった場合は、チャット履歴をリセットできます（[Gemini コードアシスタンス] ペインでdelete [Chat のリセット] をクリックします）。

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

以降のセクションでは、Gemini Code Assist を使用して、Python ファイル内のサンプルプロンプト # Function to create a Cloud Storage bucket でコードを生成する方法を説明します。また、コーディング中にコードの候補を取捨選択することも可能です。

コードファイルでの Gemini Code Assist をプロンプト表示する

新しいコードファイルを作成するか、既存のコードファイルを使用します。Python（Flask）サンプルを使用している場合は、front.py ファイルでこれを行えます。front.py ファイルは、[Project] ペインで、[python-guestbook] > [src] > [フロントエンド] に移動して開きます。
コードファイルの新しい行で「# Function to create a Cloud Storage bucket」と入力し、Enter（Windows および Linux の場合）または Return（macOS の場合）を押します。
コードを生成するには、Alt+Shift+\（Windows および Linux の場合）または Option+Shift+\（macOS の場合）を押します。または、コードファイルの行頭にある spark [Gemini コードアシスタンス] をクリックします。

このコードは、Python ファイルのプロンプトテキストの横に、ゴーストテキスト形式でコードを生成します。
省略可: 生成されたコードを受け入れるには、Tab を押します。生成されたコードを 1 行で受け入れるには、Shift+Enter キーを押します。

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

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

IDE で [ファイル]（Windows および Linux の場合）または [IntelliJ IDEA]（macOS の場合）をクリックし、[設定] > [キーマップ] > [プラグイン] > [Google Cloud Code] に移動します。
キーボードショートカットのリストで、[コードを生成] が表示されるまでスクロールします。
[コードを生成] を右クリックし、[キーボードショートカットを追加] を選択します。
[キーボードショートカット] ダイアログで、現在のキーボードショートカットをダブルクリックして、希望するショートカットを入力します。
[OK] をクリックします。
[Apply]、[OK] の順にクリックします。

新しく割り当てたキーボードショートカットを使用して、Gemini Code Assist でコードを生成できるようになりました。

IDE のショートカットを変更することの詳細については、キーボードショートカットを構成するをご覧ください。

コーディング中にインライン候補を表示する

Gemini Code Assist は、コードの記述時に、インラインコードの候補を作成します。ユーザーはこれを取捨選択できます。この機能を試すには、次の手順を行います。

新しいコードファイルを作成するか、既存のコードファイルを使用します。Python（Flask）サンプルを使用している場合は、front.py ファイルでこれを行えます。front.py ファイルは、[Project] ペインで、[python-guestbook] > [src] > [フロントエンド] に移動して開きます。
コードファイルの新しい行で、関数の作成を開始します。たとえば、Python ファイルの場合は、「def」と記述します。

Gemini は、ゴーストテキスト形式でコードの候補を表示します。
Gemini Code Assist のコード候補を受け入れるには、Tab を押します。それ以外で、提案を無視するには、Esc を押すか、引き続きコードを記述します。

引用されたソースに一致するコードの候補を無効にする

既存のオープンソースコードなど、別のソースから詳細に直接引用する際、Gemini が引用情報を提供します。詳細については、Gemini によるソースの引用方法とタイミングをご覧ください。

引用されたソースに一致するコードが提案されないようにするには、settings.json ファイルの cloudcode.duetAI.recitation.maxCitedLength 設定を 0 に変更します。

"cloudcode.duetAI.recitation.maxCitedLength": 0

他のサンプルプロンプトをテストする

このドキュメントのプロンプトを使用してコードを生成するセクションを読み終えたら、次のプロンプト例をいくつか試してください。

[Gemini コードアシスタンス] チャットペインで、次のいずれかのプロンプトを入力します。

Explain this code to me.
Write unit tests for my code.
Help me debug my code.
Make my code more readable.

既知の問題

以降のセクションでは、Gemini Code Assist の既知の問題について説明します。

大きなオープンファイルの更新バージョンが含まれている場合、チャットの回答が切り捨てられることがある

この問題を回避するには、コードの小さな部分を選択して、チャットプロンプトに追加のディレクティブ（only output the selected code. など）を含めます。

IdeaVim: `Esc` キーを押して IntelliJ の候補を拒否しても、プラグインに Gemini Code Assist の候補が表示されない

IntelliJ で IdeaVim プラグインを使用する場合、Esc キーを押して IntelliJ の候補を拒否すると、VIM コマンドモードになり、Gemini Code Assist の候補は表示されません。

Gemini Code Assist は、挿入モードで意図したとおりに動作します。

IdeaVim: 挿入モード以外で、コード生成候補を承認することができない

通常モードで IdeaVim プラグインを使用する場合は、コードの候補を承認することはできません。

この問題を回避するには、i キーを押して挿入モードに移行し、Tab キーを押して候補を承認します。

提案を拒否するには、Esc キーを押します。

フィードバック

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

ステータスバーで [Gemini コードアシスタンス] をクリックし、メニューで [Submit feedback] を選択します。
フォーム上部のテキストフィールドにフィードバックを入力します。
Geni Code Assist のログを共有する場合は、ログオプションを選択してください。
[フィードバックを送信する] をクリックします。

次のステップ

より良いプロンプトを作成する方法を確認する。