Menyiapkan project dan lingkungan pengembangan

Untuk membantu Anda mulai menggunakan Platform Agen Gemini Enterprise, halaman ini akan memandu Anda cara membuat Google Cloud project dan mengaktifkan API Platform Agen. 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 ke akun Google Cloud Anda. 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 cara Anda berencana mengakses API:

    Konsol

    Saat menggunakan konsol Google Cloud untuk mengakses layanan Google Cloud 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 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 login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

    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 langkah ini jika menggunakan Cloud Shell.

      Jika error autentikasi ditampilkan, dan Anda menggunakan penyedia identitas (IdP) eksternal, konfirmasi bahwa 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 login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

    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 dokumentasi autentikasi Google Cloud .

Meminta administrator menyiapkan project Platform Agen Gemini Enterprise untuk Anda

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

  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 Platform Agen Gemini Enterprise diberikan oleh peran IAM Pengguna Platform Agen Gemini Enterprise (roles/aiplatform.user) dan sudah cukup untuk sebagian besar pengguna Platform Agen Gemini Enterprise. Untuk kontrol penuh atas resource Platform Agen Gemini Enterprise, Anda dapat meminta peran Administrator Platform Agen Gemini Enterprise (roles/aiplatform.admin). Untuk mempelajari perbedaan antara peran ini dan peran Platform Agen Gemini Enterprise lainnya, lihat Kontrol akses Platform Agen Gemini Enterprise dengan IAM.
    2. Jika Anda juga ingin menggunakan instance Gemini Enterprise Agent Platform Workbench di Google Cloud, minta administrator Anda untuk memberi Anda peran IAM Notebooks Administrator (roles/notebooks.admin) untuk project, serta peran IAM Service Account User (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 Anda untuk mengaktifkan Agent Platform API untuk Anda. Jika Anda diberi peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), Anda dapat melakukannya sendiri.

Langkah berikutnya