Gemini Code Assist によるコード

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

  • コードの問題を解決するためのガイダンスを提供する。

  • プロジェクトのコードを生成する。

  • コーディング時にインラインの候補を受け取る。

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

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

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

始める前に

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

  2. Gemini Code Assist + Cloud Code 拡張機能がまだインストールされていない場合は、インストールします。Cloud Code は、IDE の Gemini Code Assist と統合されています。

  3. プロキシの背後で IDE を使用する場合は、Visual Studio Code のネットワーク接続をご覧ください。

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

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

Cloud AI Companion API を有効にせずに Google Cloud プロジェクトを選択すると、IDE から API を有効にするオプションを提供する通知が送信されます。通知ウィンドウで [API を有効にする] を選択して、プロジェクトに対してこの API を有効にします。詳細については、プロジェクトに Gemini Code Assist を設定するをご覧ください。

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

VS Code を起動する

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

  1. IDE を起動します。

  2. ステータスバーで [Cloud Code] - [ログイン] をクリックします。

    Cloud Code - ステータスバーの [Sign In] ボタン。

  3. Cloud Code で外部のウェブサイトを開くように求められたら、[開く] をクリックします。

  4. 画面の指示に沿って Google アカウントにログインします。

  5. Cloud Code を Google からダウンロードしたことを確認するメッセージが表示されたら、[ログイン] をクリックします。

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

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

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

    Gemini ステータスバーが利用できます。

  2. [Gemini コード アシスタンス] メニューで、[Select Gemini Code Assist project] を選択します。

  3. Cloud AI Companion API が有効になっている Google Cloud プロジェクトを選択します。

    Gemini を使用する準備ができました。

    ステータスバーの Gemini アイコンは標準に設定されています。

Gemini Code Assist とチャットする

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

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

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

  2. IDE のアクティビティ バーで、spark [Gemini Code Assist] をクリックします。

  3. [Gemini Code Assist] ペインで、プロンプト「Explain this code to me」を入力し、send [送信] をクリックします。

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

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

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

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

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

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

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

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

  1. コードファイルの新しい行でコメントを「Function to create a Cloud Storage bucket」と入力し、Enter(Windows および Linux の場合)または Return(macOS の場合)を押します。

  2. コードを生成するには、Control+Enter(Windows および Linux)や Ctrl+Return(macOS の場合)を押します。

    コードは、Gemini Code Assist がコードファイルのプロンプト テキストの横に、ゴースト テキスト形式で生成します。

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

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

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

  1. IDE で、[ファイル](Windows および Linux の場合)または [コード](macOS の場合)をクリックして [設定] > [キーボード ショートカット] に移動します。

  2. キーボード ショートカットのリストで、[Cloud Code: コードを生成] が表示されるまでスクロールします。

  3. [Cloud Code: コードを生成] をクリックし、[編集] [キーバインドを変更] をクリックします。

  4. 表示されるダイアログで、独自のショートカットを入力します。

  5. Enter(Windows および Linux の場合)または Return(macOS の場合)を押します。

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

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

選択したコードを使用してチャットで 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 によって、選択した関数の単体テストが作成されます。

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

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

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

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

    Gemini は、ゴースト テキスト形式でコードの候補を表示します。

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

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

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

  1. IDE で、[コード](macOS の場合)または [ファイル](Windows と Linux の場合)を選択して、[設定] > [設定] に移動します。

  2. [設定] ダイアログの [ユーザー] タブで、[拡張機能] > [Cloud Code] に移動します。

  3. [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 を活用したスマート アクションをコードエディタに直接備えています。コードエディタでコードを選択すると、コンテキストに関連するアクションのリストを表示して選択できます。

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

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

  2. 選択したコードブロックの横にある電球アイコン [コード アクションを表示] をクリックします。

    VS Code でコードブロックを選択すると、スマート アクションの電球アイコンが表示されます。

  3. [Generate unit tests] などのアクションを選択します。

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

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

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

コードの説明を取得する

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

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

テスト計画を生成する

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

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

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

コードを読みやすくする

  1. コードファイルで、読みやすくするコードを選択します。
  2. [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 以外の動作とは異なります。

ログイン試行が常にタイムアウトになる

ログイン試行が常にタイムアウトになる場合は、settings.json ファイルに cloudcode.beta.forceOobLogin 設定を追加してください。

"cloudcode.beta.forceOobLogin": true

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

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

  1. [表示] > [出力] をクリックします。

  2. [Gemini コード アシスタンス- 引用] を選択します。

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

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

  • oauth2.googleapis.comcloudaicompanion.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 Code Assist プロジェクトを選択した後も、[Gemini Code Assist を有効にする] が表示される

このガイドの手順(Cloud AI Companion API を有効にすることを含む)に沿ってプロジェクトを選択した場合は、LS サーバーに問題が生じる可能性があります。

問題の詳細を確認するには、次の操作を行います。

  1. ステータスバーで、spark [Gemini Code Assist] をクリックしてから、[フィードバックを送信] を選択します。

  2. いずれかのログファイルの [表示] をクリックすると、詳細が表示され、問題のトラブルシューティングを実行できます。

フィードバック

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

  1. ステータスバーで [Gemini コード アシスタンス] をクリックし、[クイックピック] メニューで [フィードバックの送信] を選択します。

  2. フォームの [Title] と [Comment] のフィールドに記入します。

  3. Skaffold または AI Companion のログを共有したい場合は、[Skaffold ログを送信する] または [AI Companion ログを送信する] のオプションを選択していることを確認します。

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

次のステップ