Mengaktifkan Conversational Analytics API

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di 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 Google Cloud project Anda. Conversational Analytics API adalah kemampuan pertama di bagian Data Analytics API with Gemini di Google Cloud konsol.

Sebelum memulai

Sebelum dapat menggunakan Conversational Analytics API, Anda harus memiliki Google Cloud project yang dapat mengakses data yang ingin Anda gunakan. 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, Looker Explore, laporan Data Studio, dan data dari AlloyDB untuk PostgreSQL, GoogleSQL untuk Spanner, Cloud SQL untuk MySQL, dan Cloud SQL untuk PostgreSQL.

2. Di Google Cloud konsol, 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 Data 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 Data Studio Pro, langganan Pro Anda harus berada di luar perimeter VPC-SC.

Persyaratan AlloyDB

Jika Anda menggunakan Conversational Analytics API dengan AlloyDB, instance AlloyDB Anda harus memenuhi persyaratan tertentu. Selesaikan semua langkah di bagian Sebelum memulai.

Persyaratan Cloud SQL untuk MySQL

Jika Anda menggunakan Conversational Analytics API dengan Cloud SQL untuk MySQL, instance Cloud SQL Anda harus memenuhi persyaratan tertentu. Selesaikan semua langkah di Sebelum memulai.

Persyaratan Cloud SQL untuk PostgreSQL

Jika Anda menggunakan Conversational Analytics API dengan Cloud SQL untuk PostgreSQL, instance Cloud SQL Anda harus memenuhi persyaratan tertentu. Selesaikan semua langkah di bagian Sebelum memulai.

Persyaratan Spanner

Jika Anda menggunakan Conversational Analytics API dengan Spanner, instance Spanner Anda harus memenuhi persyaratan tertentu. Selesaikan semua langkah di bagian Sebelum memulai.

Mengaktifkan API yang diperlukan

Untuk menggunakan Conversational Analytics API, Anda harus mengaktifkan serangkaian API yang diperlukan di dalam Google Cloud project Anda. 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 bagi Anda dari dasbor API & Layanan. Atau, administrator project Anda dapat memberi Anda peran Service Usage Admin (roles/serviceusage.serviceUsageAdmin) di Google Cloud konsol, yang memungkinkan Anda mengaktifkan dan menonaktifkan API untuk project saat ini.

konsol

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

Mengaktifkan Gemini Data Analytics API

Mengaktifkan Gemini for Google Cloud API

Mengaktifkan BigQuery API

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

Google Cloud

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 contoh perintah gcloud CLI sebelumnya, ganti project_id dengan Google Cloud project ID Anda.

Catatan: Hanya aktifkan BigQuery API jika Anda menggunakan BigQuery.

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 Google Cloud konsol untuk mengonfirmasi bahwa API tersebut diaktifkan.

Memberikan peran yang diperlukan

Untuk menggunakan Conversational Analytics API, principal (seperti pengguna atau akun layanan) memerlukan peran Identity and Access Management (IAM) yang memberikan akses ke API dan sumber data pokok.

Untuk memberikan peran ini, gunakan Google Cloud konsol:

Buka Peran

Peran Gemini Data Analytics

Untuk memungkinkan principal membuat agen Conversational Analytics API dan menggunakan metode chat stateful untuk percakapan, berikan peran IAM berikut:

• Gemini Data Analytics Data Agent Creator (roles/geminidataanalytics.dataAgentCreator): diperlukan untuk mulai membuat agen hanya di BigQuery, Looker, dan Data Studio Pro.
• Gemini for Google Cloud User (roles/cloudaicompanion.user): diperlukan untuk menggunakan metode chat stateful untuk percakapan.

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

Peran BigQuery

Untuk memungkinkan principal membuat kueri sumber data BigQuery melalui Conversational Analytics API, berikan peran IAM berikut:

• 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.

Peran Looker

Untuk memungkinkan principal membuat kueri sumber data Looker melalui Conversational Analytics API, berikan peran IAM berikut:

• Pengguna Instance Looker (roles/looker.instanceUser): diperlukan untuk mengakses data dari instance Looker (Google Cloud core).

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

Peran database

Untuk memungkinkan principal membuat kueri sumber data AlloyDB, Cloud SQL untuk MySQL, Cloud SQL untuk PostgreSQL, atau Spanner melalui Conversational Analytics API, berikan peran IAM berikut:

• Pengguna Database AlloyDB (roles/alloydb.databaseUser): diperlukan untuk mengakses data dari instance AlloyDB.
• Pengguna Cloud SQL untuk MySQL dan Cloud SQL untuk PostgreSQL Studio (roles/cloudsql.studioUser): diperlukan untuk menggunakan Google Cloud konsol guna melihat dan mengelola instance Cloud SQL untuk MySQL dan Cloud SQL untuk PostgreSQL.
• Pengguna Instance Cloud SQL untuk MySQL dan Cloud SQL untuk PostgreSQL (roles/cloudsql.instanceUser): diperlukan untuk terhubung ke instance Cloud SQL untuk MySQL dan Cloud SQL untuk PostgreSQL.
• Pembaca Database Spanner (roles/spanner.databaseReader): diperlukan untuk membaca data dari database GoogleSQL untuk Spanner.

Konfigurasi tambahan untuk Kontrol Layanan VPC

Conversational Analytics API terintegrasi dengan Kontrol Layanan VPC. Anda dapat menambahkan Conversational Analytics API ke perimeter layanan untuk meningkatkan keamanan data dan layanan serta membantu mengurangi risiko pemindahan data yang tidak sah. Jika Anda menyertakan geminidataanalytics.googleapis.com sebagai layanan yang dibatasi 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 terdapat dalam sumber tersebut. Sumber data umum untuk Conversational Analytics API mencakup BigQuery, Looker, dan Data 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, sedangkan 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 yang kuat.