Mengaktifkan Conversational Analytics API

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Halaman ini menjelaskan langkah-langkah untuk mengaktifkan Conversational Analytics API (diakses melalui geminidataanalytics.googleapis.com) untuk project Google Cloud Anda. Conversational Analytics API adalah kemampuan pertama di bagian Data Analytics API with Gemini di konsol Google Cloud .

Sebelum memulai

Sebelum dapat menggunakan Conversational Analytics API, Anda harus memiliki Google Cloud project yang dapat mengakses data yang ingin Anda kerjakan. Untuk menyiapkan project, selesaikan langkah-langkah berikut:

1. Identifikasi data yang ingin Anda gunakan dengan Conversational Analytics API. Anda dapat menggunakan sumber data seperti tabel BigQuery, Eksplorasi Looker, laporan Looker Studio, dan data dari AlloyDB, GoogleSQL untuk Spanner, Cloud SQL, dan Cloud SQL untuk PostgreSQL.

2. Di konsol Google Cloud, pada halaman pemilih project, buat Google Cloud project yang dapat mengakses data yang ingin Anda gunakan dengan Conversational Analytics API.

   Catatan: Saat ini tidak ada penagihan untuk Conversational Analytics API.

   Buka pemilih project

Persyaratan Looker dan Looker Studio Pro

Jika Anda menggunakan Conversational Analytics API dengan Looker, instance Looker Anda harus memenuhi persyaratan tertentu:

• Looker (asli)
• Looker (Google Cloud core)

Untuk menggunakan Conversational Analytics API dengan Looker Studio Pro, langganan Pro Anda harus berada di luar perimeter VPC-SC.

Mengaktifkan API yang diperlukan

Untuk menggunakan Conversational Analytics API, Anda harus mengaktifkan serangkaian API yang diperlukan di project Anda. Google Cloud Jika berencana menggunakan Conversational Analytics API dari lingkungan Colab Enterprise, Anda juga harus mengaktifkan API tambahan.

API yang diperlukan

Catatan: Jika Anda tidak memiliki izin untuk mengaktifkan API, minta administrator project Anda untuk mengaktifkan API untuk Anda dari dasbor API & Layanan. Atau, administrator project Anda dapat memberi Anda peran Service Usage Admin (roles/serviceusage.serviceUsageAdmin) di konsol Google Cloud , yang memungkinkan Anda mengaktifkan dan menonaktifkan API untuk project saat ini.

console

Aktifkan API berikut di konsol Google Cloud untuk project Google Cloud yang akan Anda gunakan dengan Conversational Analytics API.

Mengaktifkan Gemini Data Analytics API

Mengaktifkan Gemini for Google Cloud API

Aktifkan BigQuery API

Tips: Saat mengaktifkan API, Anda mungkin perlu memuat ulang halaman konsol Google Cloud untuk mengonfirmasi bahwa API telah diaktifkan.

gcloud

Dengan Google Cloud CLI, jalankan perintah gcloud services enable berikut untuk mengaktifkan Gemini Data Analytics API, Gemini for Google Cloud API, dan BigQuery API:

gcloud services enable geminidataanalytics.googleapis.com --project=project_id
gcloud services enable cloudaicompanion.googleapis.com --project=project_id
gcloud services enable bigquery.googleapis.com --project=project_id

Pada perintah gcloud CLI contoh sebelumnya, ganti project_id dengan project ID Google Cloud Anda.

API untuk Colab Enterprise

Jika Anda berencana menggunakan Conversational Analytics API dari lingkungan Colab Enterprise, aktifkan juga API berikut:

Mengaktifkan Dataform API

Mengaktifkan Compute Engine API

Mengaktifkan Vertex AI API

Tips: Saat mengaktifkan API, Anda mungkin perlu memuat ulang halaman konsol Google Cloud untuk mengonfirmasi bahwa API telah diaktifkan.

Memberikan peran yang diperlukan

Untuk menggunakan Conversational Analytics API, berikan peran Identity and Access Management (IAM) berikut di konsol Google Cloud kepada principal (seperti pengguna atau akun layanan) yang perlu berinteraksi dengan API:

Buka Peran

• Gemini untuk Google Cloud Pengguna (roles/cloudaicompanion.user): diperlukan untuk membuat percakapan yang dikelola oleh Google Cloud.
• Pengguna Instance Looker (roles/looker.instanceUser): diperlukan untuk mengakses data dari instance Looker (Google Cloud core)
• Pengguna BigQuery (roles/bigquery.user): diperlukan untuk mengakses data di BigQuery
• Pengguna BigQuery Studio (roles/bigquery.studioUser): diperlukan jika Anda menggunakan BigQuery Studio dan kanvas data
• Pengguna Database AlloyDB (roles/alloydb.databaseUser): diperlukan untuk mengakses data dari instance AlloyDB
• Pengguna Cloud SQL dan Cloud SQL for PostgreSQL Studio (roles/cloudsql.studioUser): diperlukan untuk menggunakan konsol Google Cloud guna melihat dan mengelola instance Cloud SQL dan Cloud SQL for PostgreSQL
• Pengguna Instance Cloud SQL dan Cloud SQL untuk PostgreSQL (roles/cloudsql.instanceUser): diperlukan untuk terhubung ke instance Cloud SQL dan Cloud SQL untuk PostgreSQL.
• Pembuat Agen Data Gemini Data Analytics (roles/geminidataanalytics.dataAgentCreator): diperlukan untuk membuat agen data.
• Spanner Database Reader (roles/spanner.databaseReader): diperlukan untuk membaca data dari database GoogleSQL untuk Spanner

Untuk menggunakan Analisis Percakapan dan Conversational Analytics API, pengguna Looker harus diberi peran yang berisi izin gemini_in_looker untuk model yang berinteraksi dengannya.

Selain itu, izin untuk tindakan seperti mengelola agen dikontrol oleh peran Gemini Data Analytics, seperti yang dijelaskan dalam Memberikan peran dan izin IAM Conversational Analytics API.

Konfigurasi tambahan untuk Kontrol Layanan VPC

Conversational Analytics API terintegrasi dengan VPC Service Controls. Anda dapat menambahkan Conversational Analytics API ke perimeter layanan untuk meningkatkan keamanan data dan layanan Anda serta membantu mengurangi risiko pemindahan data yang tidak sah. Jika Anda menyertakan geminidataanalytics.googleapis.com sebagai layanan terbatas dalam perimeter, Kontrol Layanan VPC akan melindungi Conversational Analytics API.

Melindungi sumber data

Meskipun perimeter layanan membatasi akses ke Conversational Analytics API, Anda juga harus menyertakan layanan sumber datanya dalam perimeter layanan yang sama untuk melindungi data yang ada di sumber tersebut. Sumber data umum untuk Conversational Analytics API mencakup BigQuery, Looker, dan Looker Studio. Pastikan layanan yang sesuai dengan sumber data ini (misalnya, bigquery.googleapis.com) juga dibatasi dalam perimeter layanan.

Peran dan izin IAM

Perimeter Kontrol Layanan VPC dan peran Identity and Access Management (IAM) bekerja sama. Kontrol Layanan VPC menerapkan batas keamanan di sekitar layanan, sementara IAM mengatur siapa yang dapat mengakses resource dalam perimeter.

Meskipun akses berada dalam perimeter yang dilindungi, pengguna atau akun layanan tetap memerlukan izin IAM yang diperlukan pada layanan Conversational Analytics API dan sumber data pokok (seperti set data BigQuery atau instance Looker) untuk melakukan tindakan. Menggabungkan Kontrol Layanan VPC dengan pengelolaan IAM yang tepat sangat penting untuk keamanan alur kerja Conversational Analytics API Anda yang kuat.