プロジェクトと開発環境を設定する

このページでは、Gemini Enterprise Agent Platform の使用を開始するために、 Cloud de Confiance by S3NS プロジェクトを作成し、Agent Platform API を有効にする方法について説明します。これらのタスクを実行する権限がない場合は、プロジェクトの設定と Gemini Enterprise Agent Platform の有効化を管理者に依頼してください。このページでは、ローカル開発環境で Google Cloud CLI を設定する方法についても説明します。

プロジェクトの設定

プロジェクトを設定する手順は次のとおりです。

  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 Gemini Enterprise Agent Platform 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

認証を設定する

    API へのアクセス方法に応じてタブを選択してください。

    コンソール

    Cloud de Confiance コンソールを使用して Cloud de Confiance by S3NS サービスと API にアクセスする場合、認証を設定する必要はありません。

    gcloud

    1. Google Cloud CLI をインストールします。

    2. フェデレーション ID（連携 ID）を使用するように gcloud CLI を構成します。

      詳細については、 フェデレーション ID を使用して gcloud CLI にログインするをご覧ください。

    3. gcloud CLI を初期化するには、次のコマンドを実行します。

      gcloud init

    4. gcloud CLI を初期化した後に更新して、必要なコンポーネントをインストールします。

      gcloud components update
gcloud components install beta

    ユーザー認証情報ではなく、サービス アカウントの権限借用を使用して Google API の認証を行うように gcloud CLI を設定するには、次のコマンドを実行します。

    gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

    詳細については、サービス アカウントの権限借用をご覧ください。

    クライアント ライブラリ

    ローカル開発環境でクライアント ライブラリを使用するには、gcloud CLI をインストールして初期化し、ユーザー認証情報を使用してアプリケーションのデフォルト認証情報を設定します。

    1. Google Cloud CLI をインストールします。

    2. フェデレーション ID（連携 ID）を使用するように gcloud CLI を構成します。

      詳細については、 フェデレーション ID を使用して gcloud CLI にログインするをご覧ください。

    3. gcloud CLI を初期化した後に更新して、必要なコンポーネントをインストールします。

      gcloud components update
gcloud components install beta

    4. ユーザー アカウントのローカル認証情報を作成します。 

      gcloud auth application-default login

      認証エラーが返された場合は、 フェデレーション ID を使用して gcloud CLI にログインしていることを確認します。

    詳細については、 Cloud de Confiance 認証ドキュメントの ローカル開発環境の ADC の設定をご覧ください。

    ユーザー認証情報ではなく、サービス アカウントの権限借用を使用して Google API の認証を行うようにローカル ADC ファイルを設定するには、次のコマンドを実行します。

    gcloud auth application-default login --impersonate-service-account=SERVICE_ACCT_EMAIL

    詳細については、サービス アカウントの権限借用をご覧ください。

    REST

    ローカル開発環境で REST API を使用するには、gcloud CLI に指定した認証情報を使用します。

    1. Google Cloud CLI をインストールします。

    2. フェデレーション ID（連携 ID）を使用するように gcloud CLI を構成します。

      詳細については、 フェデレーション ID を使用して gcloud CLI にログインするをご覧ください。

    3. gcloud CLI を初期化した後に更新して、必要なコンポーネントをインストールします。

      gcloud components update
gcloud components install beta

    詳細については、 Cloud de Confiance 認証ドキュメントの REST を使用して認証するをご覧ください。

    サービス アカウントの権限借用を使用して、REST API リクエスト用のアクセス トークンを生成できます。詳細については、権限借用されたサービス アカウントをご覧ください。

    本番環境での認証の設定については、 Cloud de Confiance 認証ドキュメントの Cloud de Confianceで実行されるコードのアプリケーションのデフォルト認証情報を設定する をご覧ください。

管理者に Gemini Enterprise Agent Platform プロジェクトの設定を依頼する

このセクションでは、管理者が Gemini Enterprise Agent Platform の使用に必要なロールを付与する方法について説明します。

  1. プロジェクトを識別するために、わかりやすいプロジェクト名とプロジェクト ID を決めます。組織に属している場合や、複数のプロジェクトを作成する予定がある場合は、プロジェクトの組織を明確にするために、どのような命名規則やフォルダ階層に従っているか、または従う可能性があるかを検討します。
  2. 必要なロール:
    1. ほとんどの Gemini Enterprise Agent Platform 機能へのアクセスは、Gemini Enterprise Agent Platform ユーザーの (roles/aiplatform.user) IAM ロールによって付与されます。ほとんどの Gemini Enterprise Agent Platform ユーザーはこれで十分です。Gemini Enterprise Agent Platform リソースを完全に制御するには、Gemini Enterprise Agent Platform 管理者の (roles/aiplatform.admin) ロールをリクエストします。これらと他の Gemini Enterprise Agent Platform ロールの違いについては、IAM を使用した Gemini Enterprise Agent Platform のアクセス制御をご覧ください。
    2. Cloud de Confiance by S3NSで Gemini Enterprise Agent Platform Workbench インスタンスを使用する場合は、プロジェクトに対する Notebooks 管理者 (roles/notebooks.admin) IAM ロールと、プロジェクトまたは Compute Engine のデフォルト サービス アカウントに対する サービス アカウント ユーザー (roles/iam.serviceAccountUser) IAM ロールを付与するよう管理者に依頼してください。
    3. さらに、必要な API を有効にするには、Service Usage 管理者 (roles/serviceusage.serviceUsageAdmin) IAM ロールが必要です。または、管理者が最初の数ステップで API を有効にする必要があります。
  3. 管理者に Agent Platform API を有効にするように依頼してください。Service Usage 管理者 (roles/serviceusage.serviceUsageAdmin) IAM ロールが付与されている場合は、自分でこの操作を行うことができます。

次のステップ