Menyiapkan project dan lingkungan pengembangan

Untuk membantu Anda memulai penggunaan Gemini Enterprise Agent Platform, halaman ini memandu Anda cara membuat Google Cloud project dan mengaktifkan Agent Platform API. Jika Anda tidak memiliki izin untuk melakukan tugas ini, minta administrator untuk menyiapkan project dan mengaktifkan Gemini Enterprise Agent Platform untuk Anda. Halaman ini juga membahas cara menyiapkan Google Cloud CLI di lingkungan pengembangan lokal Anda.

Menyiapkan project

Ikuti langkah-langkah berikut untuk menyiapkan project:

  1. Login keakun Anda. Google Cloud Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

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

    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 API

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

    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 API

    8.

Menyiapkan autentikasi

    Pilih tab untuk melihat bagaimana Anda berencana mengakses API:

    Konsol

    Saat menggunakan Google Cloud konsol untuk mengakses Google Cloud layanan dan API, Anda tidak perlu menyiapkan autentikasi.

    gcloud

    1. Instal Google Cloud CLI.

    2. Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

    3. Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut: 

      gcloud init

    4. Setelah menginisialisasi gcloud CLI, update gcloud CLI dan instal komponen yang diperlukan: 

      gcloud components update
gcloud components install beta

    Untuk menyiapkan gcloud CLI agar menggunakan peniruan akun layanan untuk mengautentikasi ke Google API, alih-alih kredensial pengguna Anda, jalankan perintah berikut: 

    gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

    Untuk mengetahui informasi selengkapnya, lihat Peniruan akun layanan.

    Library klien

    Untuk menggunakan library klien di lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.

    1. Instal Google Cloud CLI.

    2. Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus terlebih dahulu login ke gcloud CLI dengan identitas gabungan Anda.

    3. Setelah menginisialisasi gcloud CLI, update gcloud CLI dan instal komponen yang diperlukan: 

      gcloud components update
gcloud components install beta

    4. Jika Anda menggunakan shell lokal, buat kredensial autentikasi lokal untuk akun pengguna Anda: 

      gcloud auth application-default login

      Anda tidak perlu melakukan hal ini jika menggunakan Cloud Shell.

      Jika error autentikasi ditampilkan, dan Anda menggunakan penyedia identitas (IdP) eksternal, pastikan Anda telah login ke gcloud CLI dengan identitas gabungan Anda.

    Untuk mengetahui informasi selengkapnya, lihat Menyiapkan ADC untuk lingkungan pengembangan lokal dalam dokumentasi autentikasi. Google Cloud

    Untuk menyiapkan file ADC lokal agar menggunakan peniruan akun layanan untuk mengautentikasi ke Google API, alih-alih kredensial pengguna Anda, jalankan perintah berikut: 

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

    Untuk informasi selengkapnya, lihat Peniruan akun layanan.

    REST

    Untuk memakai REST API di lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

    1. Instal Google Cloud CLI.

    2. Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus terlebih dahulu login ke gcloud CLI dengan identitas gabungan Anda.

    3. Setelah menginisialisasi gcloud CLI, update gcloud CLI dan instal komponen yang diperlukan: 

      gcloud components update
gcloud components install beta

    Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi. Google Cloud

    Anda dapat menggunakan peniruan akun layanan guna membuat token akses untuk permintaan REST API. Untuk mengetahui informasi selengkapnya, lihat Akun layanan yang identitasnya ditiru.

    Untuk mengetahui informasi tentang cara menyiapkan autentikasi bagi lingkungan produksi, lihat Menyiapkan Kredensial Default Aplikasi untuk kode yang berjalan di Google Cloud dalam Google Cloud dokumentasi autentikasi.

Meminta administrator untuk menyiapkan project Gemini Enterprise Agent Platform untuk Anda

Bagian ini menjelaskan cara administrator memberikan peran yang diperlukan untuk menggunakan Gemini Enterprise Agent Platform.

  1. Tentukan nama project dan project ID yang bermakna untuk mengidentifikasi project Anda. Jika Anda adalah bagian dari organisasi atau berencana membuat beberapa project, pertimbangkan konvensi penamaan dan hierarki folder yang diikuti, atau dapat diikuti, untuk memperjelas organisasi project.
  2. Peran yang diperlukan:
    1. Akses ke sebagian besar kemampuan Gemini Enterprise Agent Platform diberikan oleh peran IAM Pengguna Gemini Enterprise Agent Platform (roles/aiplatform.user) dan seharusnya cukup untuk sebagian besar pengguna Gemini Enterprise Agent Platform. Untuk kontrol penuh atas resource Gemini Enterprise Agent Platform, Anda dapat meminta peran Administrator Gemini Enterprise Agent Platform (roles/aiplatform.admin). Untuk mengetahui perbedaan antara peran ini dan peran Gemini Enterprise Agent Platform lainnya, lihat Kontrol akses Gemini Enterprise Agent Platform dengan IAM.
    2. Jika Anda juga ingin menggunakan instance Gemini Enterprise Agent Platform Workbench di Google Cloud, minta administrator untuk memberi Anda peran IAM Administrator Notebook (roles/notebooks.admin) untuk project, serta peran IAM Pengguna Akun Layanan (roles/iam.serviceAccountUser) di project atau akun layanan default Compute Engine.
    3. Selain itu, untuk mengaktifkan API yang diperlukan, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin) atau administrator Anda perlu mengaktifkan API untuk Anda dengan mengikuti beberapa langkah pertama.
  3. Minta administrator untuk mengaktifkan Agent Platform API untuk Anda. Jika Anda diberi peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), Anda dapat melakukannya sendiri.

Langkah berikutnya