Gemini Code Assist によるコード

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

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

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

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

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

始める前に

Cloud Code 拡張機能をインストールします（まだインストールしていない場合）。Cloud Code は、IDE の Gemini Code Assist と統合されています。
省略可: このドキュメントのタスク用にサンプルのクローンを作成する場合は、Git をインストールします。サンプルをマシンにコピーするには Git が必要です。

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

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

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

IDE で直接 Code with Gemini Code Assist のチュートリアルに沿う場合は、[Launch VS Code] をクリックし、そのチュートリアルの手順に沿って Google Cloud に接続し、Gemini Code Assist を有効にしてください。

VS Code を起動する

それ以外の場合は、次の手順を行います。

IDE を起動します。
ステータスバーで [Cloud Code] - [ログイン] をクリックします。
Cloud Code で外部のウェブサイトを開くように求められたら、[開く] をクリックします。
画面の指示に沿って Google アカウントにログインします。
Cloud Code を Google からダウンロードしたことを確認するメッセージが表示されたら、[ログイン] をクリックします。

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

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

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

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

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

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

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

IDE でコマンドパレットを開きます。Ctrl+Shift+P（Windows および Linux の場合）または Command+Shift+P（macOS の場合）を押してから、Cloud Code: 新しいアプリケーションを実行します。
[Kubernetes アプリケーション] を選択します。
[Python (Flask): Guestbook] アプリケーションテンプレートを選択します。
新しいアプリケーションを任意の場所に保存します。

アプリケーションが作成されたことを確認する通知が表示され、アプリケーションが読み込まれた状態で新しいウィンドウが開きます。

Gemini Code Assist とチャットする

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

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

新しいコードファイルを作成するか、既存のコードファイルを使用します。Python（Flask）サンプルを使用している場合は、front.py ファイルでこのタスクを行えます（front.py ファイルは、[Explorer] > [src] > [フロントエンド] に移動して開きます）。
IDE のアクティビティバーで、chat_spark [Gemini コードアシスタンス] をクリックします。
[Gemini コードアシスタンス] ペインで、プロンプト「Explain this code to me」を入力し、send [送信] をクリックします。

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

ファイル内のすべてのコードではなく、特定のコードブロックを参照するには、コードファイル内のブロックを選択して、Gemini に指示します。

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

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

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

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

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

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

新しいコードファイルを作成するか、既存のコードファイルを使用します。Python（Flask）サンプルを使用している場合は、これを front.py ファイルで行えます（front.py ファイルは、[Explorer] > [src] > [フロントエンド] に移動して開きます）。
コードファイルの新しい行で「# Function to create a Cloud Storage bucket」と入力し、Enter（Windows および Linux の場合）または Return（macOS の場合）を押します。
コードを生成するには、Control+Enter（Windows および Linux）や Ctrl+Return（macOS の場合）を押します。

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

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

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

IDE で、[ファイル]（Windows および Linux の場合）または [コード]（macOS の場合）をクリックして [設定] > [キーボードショートカット] に移動します。
キーボードショートカットのリストで、[Cloud Code: コードを生成] が表示されるまでスクロールします。
[Cloud Code: コードを生成] をクリックし、[編集] [キーバインドを変更] をクリックします。
表示されるダイアログで、独自のショートカットを入力します。
Enter（Windows および Linux の場合）または Return（macOS の場合）を押します。

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

IDE におけるショートカット変更の詳細については、Visual Studio Code のキーバインドをご覧ください。

選択したコードでチャットを使用して Gemini Code Assist をプロンプト表示する

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

IDE で、コードを含むプロジェクト内のファイルを開くか、前の手順で使用した同じコードファイルを使用します。
アクティビティバーで、chat_spark [Gemini コードアシスタンス] をクリックして [Gemini コードアシスタンス] ペインを開きます。
コードファイルで、コードのブロックを選択します。
[Gemini コードアシスタンス] ペインのテキストフィールドに、選択したコードに対するプロンプトを入力します。

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

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

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

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

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

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

省略可: インライン候補を無効にする

Gemini Code Assist でインライン候補を無効にするには、次の手順を行います。

IDE で、[コード]（macOS の場合）または [ファイル]（Windows と Linux の場合）を選択して、[設定] > [設定] に移動します。
[設定] ダイアログの [ユーザー] タブで、[拡張機能] > [Cloud Code] に移動します。
[Cloudcode: Gemini Code Assist: Inline Suggestions: Enable Auto] リストが表示されるまでスクロールして、[Off] を選択します。

これで、インライン候補は無効になります。インライン候補は、Control+Enter（Windows および Linux の場合）や Ctrl+Return（macOS の場合）を押すことで、引き続き手動で起動できます。

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

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

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

"cloudcode.duetAI.recitation.maxCitedLength": 0

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

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

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

コードファイルで、コードのブロックを選択します。
選択したコードブロックの横にある電球アイコン [コードアクションを表示] をクリックします。
[Generate unit tests] などのアクションを選択します。

Gemini は、選択したアクションに基づいてレスポンスを生成します。

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

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

コードの説明を取得する

コードファイルで、説明対象の関数を選択します。
[Gemini コードアシスタンス] ペインで、プロンプト「Explain this code to me」を入力します。

Gemini は、選択したコードをリファレンスとして使用し、選択した関数の説明を返します。

テスト計画を生成する

コードファイルで、単体テストを追加するコードを選択します。
[Gemini コードアシスタンス] ペインで、プロンプト「Write unit tests for my code」を入力します。

デバッグコードでヘルプを受ける

コードファイルで、デバッグするコードを選択します。
[Gemini コードアシスタンス] ペインで、プロンプト「Help me debug my code」を入力します。

コードを読みやすくする

コードファイルで、読みやすくするコードを選択します。
[Gemini コードアシスタンス] ペインで、プロンプト「Make my code more readable」を入力します。

コードの特定の部分に焦点を当てるには、Gemini のプロンプトを表示する前にコードの目的の箇所を選択します。

既知の問題

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

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

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

Vim: 挿入モード以外で、コード生成候補を承認または拒否することができない

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

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

Vim: `Esc` キーを押して候補を拒否するときの動作が一貫しない

Esc キーを押すと、IntelliJ と Gemini の両方の候補が拒否されます。この動作は、Esc キーを押すと Gemini が再トリガーされる Vim 以外の動作とは異なります。

ライセンスの引用に関する警告がセッションをまたいで維持されない

ライセンスの引用に関する警告がセッションをまたいで維持されない場合は、永続ログをご覧ください。

[表示] > [出力] をクリックします。
[Gemini コードアシスタンス- 引用] を選択します。

Gemini コードアシスタンスの出力ウィンドウにおける接続の問題

Gemini Code Assist の出力ウィンドウに接続エラーなどの接続の問題が表示される場合は、次のことをお試しください。

oauth2.googleapis.com と cloudaicompanion.googleapis.com へのアクセスを許可するようにファイアウォールを構成する。
gRPC が使用する HTTP/2 経由の通信を許可するようにファイアウォールを構成する。

grpc-health-probe ツールを使用して接続をテストできます。テストで問題がない場合は、次の出力が表示されます。

$ grpc-health-probe -addr cloudaicompanion.googleapis.com:443 -tls error: this server does not implement the grpc health protocol (grpc.health.v1.Health): GRPC target method can't be resolved

テストで問題があった場合は、次の出力が表示されます。

timeout: failed to connect service "cloudaicompanion.googleapis.com:443" within 1s

詳細を取得するには、「grpc-health-probe」の前に次のコマンドを実行します。

export GRPC_GO_LOG_SEVERITY_LEVEL=info

フィードバック

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

ステータスバーで [Gemini コードアシスタンス] をクリックし、[クイックピック] メニューで [フィードバックの送信] を選択します。
フォームの [Title] と [Comment] のフィールドに記入します。
Skaffold または AI Companion のログを共有したい場合は、[Skaffold ログを送信する] または [AI Companion ログを送信する] のオプションを選択してください。
[フィードバックを送信する] をクリックします。

次のステップ

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