Gemini CLI を使用する

このページでは、Gemini Enterprise Agent Platform Workbench インスタンスで Gemini コマンドライン インターフェース（CLI）を使用する方法について説明します。

このドキュメントは、Agent Platform Workbench を使用するデータ アナリスト、データ サイエンティスト、データ デベロッパーを対象としています。このドキュメントは、ノートブック環境でコードを記述する方法を理解していることを前提としています。

概要

Gemini CLI は、ターミナルで Gemini に直接アクセスできるオープンソースの AI エージェントです。詳細については、geminicli.com をご覧ください。

Gemini CLI は、Agent Platform Workbench インスタンスで使用できます。Gemini CLI を使用して、次のことができます。

  • 新しいノートブックを作成します。
  • ノートブックのセルを実行します。
  • ノートブックのコードセルとテキストセルを記述して編集する。
  • コードと技術的な概念について説明する。
  • Agent Platform Workbench インスタンスのローカル ファイル システムを操作する。これには、単一の高レベルの指示に基づく、複数のファイルにわたる複雑なファイル操作の実行が含まれます。
  • 基本的なシェルコマンドを実行します。
  • コマンドを実行して、Gemini Enterprise Agent Platform や BigQuery などの他の Google Cloud サービスを操作する。

制限事項

Agent Platform Workbench で Gemini CLI を使用する場合は、次の制限事項を考慮してください。

  • Gemini CLI は CLI 専用です。グラフィカルなチャット インターフェースや高度なエディタ内ツールは含まれていません。

  • Gemini CLI にノートブックの変更を依頼すると、Gemini CLI はインスタンスのディスク上のノートブック ファイルを直接変更します。そのため、ノートブック エディタの [元に戻す] ボタンまたは Control+Z（macOS では Command+Z）を使用して、Gemini CLI で行った編集を元に戻すことはできません。ただし、Undo your last change などの自然言語コマンドを使用して、Gemini CLI に変更の取り消しを依頼できます。

始める前に

  1. Google Cloud アカウントにログインします。 Google Cloudを初めて使用する場合は、 アカウントを作成して、実際のシナリオでの Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Compute Engine, Notebooks, and Agent Platform APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Compute Engine, Notebooks, and Agent Platform APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

    8.

必要なロール

Agent Platform Workbench で Gemini CLI を使用するには、Agent Platform Workbench インスタンスのユーザーとインスタンスのサービス アカウントに権限を付与する必要があります。

インスタンスのユーザーに権限を付与する

Agent Platform Workbench インスタンスで Gemini CLI を使用するために必要な権限を取得するには、プロジェクトに対する Agent Platform ユーザー（roles/aiplatform.user)）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

インスタンスのサービス アカウントに権限を付与する

Agent Platform Workbench インスタンスで Gemini CLI を実行するために必要な権限が Agent Platform Workbench インスタンスのサービス アカウントに付与されるようにするには、プロジェクトに対する Agent Platform ユーザー（roles/aiplatform.user)）IAM ロールを Agent Platform Workbench インスタンスのサービス アカウントに付与するよう管理者に依頼してください。

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

この事前定義ロールには、Gemini CLI を Agent Platform Workbench インスタンスで実行するために必要な aiplatform.endpoints.predict 権限が含まれています。

管理者は、カスタムロールや他の事前定義ロールを使用して、この権限を Agent Platform Workbench インスタンスのサービス アカウントに付与することもできます。

Gemini CLI を使用する

  1. Google Cloud コンソールで [インスタンス] ページに移動します。

    [Spanner インスタンス] に移動

  2. Agent Platform Workbench インスタンス名の横にある [JupyterLab を開く] をクリックします。

    Agent Platform Workbench インスタンスで JupyterLab が開きます。

  3. JupyterLab で、[File] > [New launcher] をクリックします。

  4. [Launcher] タブの [Other] セクションで、[Gemini CLI] タイルをクリックします。

  5. Gemini CLI ターミナルを初めて開いた場合は、Y と入力して利用規約に同意します。

    Agent Platform Workbench インスタンスに Gemini CLI がインストールされている。

  6. Gemini CLI ターミナルにプロンプトを入力します。

    たとえば、「Create a new notebook named 'test-notebook'」と入力します。役立つ可能性のあるプロンプトの例については、サンプル プロンプトをご覧ください。

サンプル プロンプト

Gemini CLI の使用方法のアイデアを得るには、次のプロンプトの例をご覧ください。

  • 「BigQuery と Python を使用して、bigquery-public-data.ml_datasets.census_adult_income から「所得区分」を予測するモデルをトレーニングする新しいノートブックを作成して。」

  • 「test-file という名前のノートブックを要約し、プロジェクトの次のステップを提案してください。」

  • 「このディレクトリにあるノートブックの概要を簡単に把握したい。すべての .ipynb ファイルについて、ファイルの最初の 5 行を表示して。

  • 「test-file ノートブックの内容を使用してスクリプトを作成します。」

  • Agent Platform Workbench 内から BigQuery テーブルのデータにアクセスする方法を教えて。

  • 「bigquery-public-data.ml_datasets.census_adult_income テーブルに対してクエリを実行して、所得区分が 50K を超える人の数を調べます。」

  • 「デフォルトの Google Cloud プロジェクトを my-project に設定して。」

  • Cloud Storage バケットを作成し、現在のディレクトリにあるすべての CSV ファイルをアップロードしてください。

  • 「Debian 11 イメージと n1-standard-4 マシンタイプを使用して Compute Engine インスタンスを作成します。」

  • 「test-script のコードを実行するノートブック ファイルを作成します。コードを説明するテキストセルを追加します。」

Gemini CLI へのアクセスを制御する

Agent Platform Workbench で Gemini CLI へのアクセスを制御するには、次の方法を使用します。

  • 管理者は、組織、フォルダ、プロジェクト レベルで特定の Gemini モデルの使用を制限する組織のポリシーを設定できます。Model Garden モデルへのアクセスを制御するをご覧ください。Gemini CLI は JupyterLab に引き続き表示されますが、CLI はプロンプトに応答しません。

  • aiplatform.endpoints.predict 権限を付与しないことで、管理者は一部の ID が推論に Gemini エンドポイントを使用できないようにブロックできます。

Gemini CLI のマジック コマンドを使用する

ノートブック ファイルのセル内で Gemini CLI を直接使用するには、次の操作を行います。

  1. Gemini CLI が有効になっており、ユーザーまたは作成者が利用規約に同意していることを確認します。
  2. 新しいセルの 1 行目に「%%geminicli_magic」と入力します。
  3. 同じセルに、次の行にプロンプトを入力します。
  4. セルを実行します。

Gemini CLI は、回答を含む新しいセルを下に挿入します。

トラブルシューティング

Agent Platform Workbench インスタンスで Gemini CLI を使用しているときに問題が発生した場合は、一般的な問題の解決に役立つ Agent Platform Workbench のトラブルシューティングをご覧ください。

次のステップ