Menyiapkan Duet AI untuk Developer untuk sebuah project

Sebelum Anda dapat menggunakan Duet AI untuk Developer pada produk Google Cloud yang didukung, tim Anda harus melakukan langkah-langkah yang dijelaskan dalam dokumen ini:

  1. Beli langganan ke satu atau beberapa penawaran produk Duet AI.

  2. Aktifkan Duet AI di project Google Cloud. Langkah ini biasanya dilakukan oleh administrator.

  3. Jika Anda ingin menggunakan Duet AI di IDE, instal plugin Cloud Code.

Membeli langganan Duet AI

Jika Anda hanya menggunakan Duet AI untuk BigQuery, Spanner, atau Colab Enterprise, Anda dapat melewati bagian ini.

Duet AI untuk Developer dapat dicoba tanpa biaya hingga 11 Mei 2024, terbatas untuk satu pengguna per akun penagihan. Organisasi dengan beberapa pengguna per akun penagihan perlu membeli langganan seperti yang dijelaskan di bagian ini. Jika Anda sudah memiliki kontrak dengan Google Cloud, hubungi tim penjualan kami sebelum membeli langganan.

  1. Di konsol Google Cloud, buka halaman Admin Duet AI.

    Buka Admin Duet AI

  2. Tinjau dan konfirmasi pesan Sebelum memulai.

  3. Jika belum memiliki langganan untuk akun penagihan ini, Anda akan melihat halaman promosi. Klik Mulai menggunakan Duet AI.

  4. Jika diminta, pilih akun penagihan, lalu klik Continue Duet AI Admin page.

  5. Di halaman Langganan, klik Beli langganan baru.

  6. Lengkapi kolom untuk Mengonfigurasi langganan, termasuk nama opsional untuk langganan, jangka waktu komitmen (bulanan atau tahunan), dan jumlah lisensi dalam langganan.

    Pilih apakah Anda ingin memperpanjang langganan secara otomatis setelah jangka waktu komitmen (bulanan atau tahunan). Tindakan ini akan membuat langganan dan lisensi Anda tetap aktif. Jika tidak diperpanjang secara otomatis, langganan akan berakhir saat masa berlaku saat ini berakhir dan Anda harus melakukan proses pembelian lagi untuk mendapatkan kembali lisensi.

  7. Klik Lanjutkan untuk meninjau detail langganan. Tinjau dan setujui persyaratan pembelian.

  8. Klik Selesaikan Pembelian, lalu konfirmasi langganan Anda.

Penagihan sekarang diaktifkan untuk Duet AI. Selanjutnya, aktifkan Duet AI di satu atau beberapa project yang terkait dengan akun penagihan ini. Pengguna tidak akan melihat Duet AI sampai Anda mengaktifkannya di setidaknya satu project

Mengaktifkan Duet AI di project Google Cloud

Untuk mengaktifkan Duet AI di project Google Cloud, administrator harus mengaktifkan Cloud AI Companion API dan memberikan peran Pengguna Pendamping Cloud AI dan peran Identity and Access Management (IAM) Service Usage Viewer kepada pengguna.

Konsol

  1. Untuk mengaktifkan API, buka halaman Cloud AI Companion API di Konsol Google Cloud.

    Buka Cloud AI Companion API

  2. Di pemilih project, pilih project.

  3. Klik Enable.

    Halaman akan diperbarui dan menampilkan status Enabled. Duet AI kini tersedia di project Google Cloud yang dipilih untuk semua pengguna yang memiliki peran IAM yang diperlukan.

  4. Untuk memberikan peran IAM yang diperlukan untuk menggunakan Duet AI, buka halaman IAM.

    Buka IAM

  5. Di kolom Principal, temukan akun utama yang aksesnya ingin Anda aktifkan ke Duet AI, lalu klik Edit akun utama di baris tersebut.

  6. Di panel Edit access, klik Add another role.

  7. Pada bagian Select a role, pilih Cloud AI Companion User.

  8. Klik Tambahkan peran lain, lalu pilih Service Usage Viewer.

  9. Klik Simpan.

gcloud

  1. Di konsol Google Cloud, aktifkan Cloud Shell.

    Aktifkan Cloud Shell

  2. Di menu drop-down pemilih project, pilih project.

  3. Aktifkan Cloud AI Companion API untuk Duet AI menggunakan perintah gcloud services enable:

    gcloud services enable cloudaicompanion.googleapis.com

    Jika Anda ingin mengaktifkan Cloud AI Companion API untuk project Google Cloud lain, tambahkan parameter --project:

    gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID

    Ganti PROJECT_ID dengan ID project Google Cloud Anda.

    Outputnya mirip dengan hal berikut ini:

    Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.

    Duet AI kini tersedia di project Google Cloud yang ditentukan untuk semua pengguna yang memiliki peran IAM yang diperlukan.

  4. Berikan dua peran IAM yang diperlukan untuk menggunakan Duet AI:

    1. Berikan peran Cloud AI Companion User:

      gcloud projects add-iam-policy-binding  PROJECT_ID \
--member=PRINCIPAL --role=roles/cloudaicompanion.user

      Ganti PRINCIPAL dengan ID untuk akun utama. ID berbentuk user|group|serviceAccount:email atau domain:domain—misalnya, user:[email protected], group:[email protected], serviceAccount:[email protected], atau domain:example.domain.com.

      Output-nya adalah daftar binding kebijakan yang mencakup hal berikut:

      - members:
  - user:PRINCIPAL
  role: roles/cloudaicompanion.user

    2. Berikan peran Service Usage Viewer:

      gcloud projects add-iam-policy-binding  PROJECT_ID \
--member=PRINCIPAL --role=roles/serviceusage.serviceUsageViewer

      Output-nya adalah daftar binding kebijakan yang mencakup hal berikut:

      - members:
  - user:PRINCIPAL
  role: roles/serviceusage.serviceUsageViewer

    Untuk mengetahui informasi selengkapnya, lihat Memberikan satu peran dan gcloud projects add-iam-policy-binding.

Semua pengguna yang telah diberi peran ini dapat mengakses fitur Duet AI di Konsol Google Cloud dalam project yang ditentukan. Untuk mengetahui informasi selengkapnya, lihat Ringkasan Duet AI di Google Cloud.

Menggunakan Duet AI di IDE

Jika Anda adalah developer yang ingin menggunakan Duet AI di IDE, Anda perlu menginstal plugin Cloud Code. Untuk informasi selengkapnya, lihat hal berikut:

Tugas penyiapan lanjutan

Daripada menggunakan Konsol Google Cloud atau gcloud CLI untuk memberikan peran IAM yang telah ditetapkan, Anda dapat melakukan salah satu tindakan berikut:

  • Gunakan IAM REST API atau library klien IAM untuk memberikan peran.

    Jika Anda menggunakan antarmuka ini, gunakan nama peran yang sepenuhnya memenuhi syarat:

    • roles/cloudaicompanion.user
    • roles/serviceusage.serviceUsageViewer

    Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

  • Membuat dan memberikan peran khusus.

    Setiap peran khusus yang Anda buat memerlukan izin berikut untuk mengakses Duet AI:

    • cloudaicompanion.companions.generateChat
    • cloudaicompanion.companions.generateCode
    • serviceusage.services.get

Langkah selanjutnya