Agent Platform Workbench インスタンスの JupyterLab 内の Cloud Storage バケットとファイルにアクセスする

このページでは、Cloud Storage に保存されているファイルを参照できるように、Cloud Storage バケットを Gemini Enterprise Agent Platform Workbench インスタンスの JupyterLab インターフェースにマウントする方法について説明します。テキスト ファイルやノートブック（IPYNB）ファイルなど、JupyterLab と互換性のあるファイルを開いて編集することもできます。

概要

Agent Platform Workbench インスタンスには、Cloud Storage バケットをマウントできる Cloud Storage インテグレーションが含まれています。つまり、JupyterLab インターフェース内からバケットの内容を参照し、互換性のあるファイルを操作できます。

Agent Platform Workbench インスタンスと同じプロジェクト内でインスタンスがアクセスできる任意の Cloud Storage バケットとファイルにアクセスできます。

始める前に

  1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance 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

  2. Verify that billing is enabled for your Cloud de Confiance project.

  3. Enable the Notebooks API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

必要なロール

Cloud Storage バケットを Agent Platform Workbench インスタンスにマウントするために必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。

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

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

共有ストレージのマウントを有効にするために必要な権限

Agent Platform Workbench インスタンスで共有ストレージのマウントを有効にするには、Agent Platform Workbench インスタンスのサービス アカウントにプロジェクトに対する storage.buckets.list 権限を付与するよう、管理者に依頼してください。

Agent Platform Workbench インスタンスの JupyterLab インターフェースに [Mount shared storage] ボタンを表示するには、storage.buckets.list 権限が必要です。

バケットと Agent Platform Workbench インスタンスを作成する

Agent Platform Workbench インスタンスと同じプロジェクト内の少なくとも 1 つの Cloud Storage バケットにアクセスできる必要があります。
  1. Cloud Storage バケットを作成する必要がある場合は、バケットを作成するをご覧ください。
  2. まだ作成していない場合は、Cloud Storage バケットと同じプロジェクトに Agent Platform Workbench インスタンスを作成します。

JupyterLab を開く

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

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

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

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

Cloud Storage バケットをマウントする

Cloud Storage バケットをマウントしてアクセスする手順は次のとおりです。

  1. JupyterLab で、[ File Browser] タブが選択されていることを確認します。

  2. 左側のサイドバーで、 [Mount shared storage] ボタンをクリックします。このボタンが表示されない場合は、サイドバーの右側をドラッグして、ボタンが表示されるまでサイドバーを開きます。

    左側のサイドバーの右上にある [Mount shared storage] ボタン

  3. [Bucket name] フィールドに、マウントする Cloud Storage バケット名を入力します。

  4. [Mount] をクリックします。

  5. Cloud Storage バケットは、左側のサイドバーの [File browser] タブにフォルダとして表示されます。フォルダをダブルクリックして開き、内容を確認します。

トラブルシューティング

Cloud Storage バケットをインスタンスにマウントする際の問題を診断して解決する方法については、Agent Platform Workbench のトラブルシューティングをご覧ください。

次のステップ