Mengelola agen data di Spanner Studio

Pratinjau — Data agents

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Spesifik per Layanan, dan Persyaratan Tambahan untuk Produk Pratinjau AI Generatif. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Untuk mengetahui informasi tentang akses ke rilis ini, lihat halaman permintaan akses.

Catatan antarmuka PostgreSQL: Contoh dalam topik ini ditujukan untuk database dialek GoogleSQL. Fitur ini tidak mendukung antarmuka PostgreSQL.

Dokumen ini menjelaskan cara membuat agen data di Spanner Studio menggunakan file konteks agen. Agen data dikaitkan dengan satu file konteks agen.

Untuk mempelajari agen data, lihat Ringkasan agen data.

Sebelum memulai

Selesaikan prasyarat berikut sebelum membuat agen.

Mengaktifkan layanan yang diperlukan

Aktifkan layanan berikut untuk project Anda:

• Gemini Data Analytics API
• Gemini for Google Cloud API

Siapkan instance Spanner

• Pastikan instance Spanner tersedia. Untuk mengetahui informasi selengkapnya, lihat Membuat instance.
• Isi database dengan data dan skema yang ingin diakses pengguna akhir.

Peran dan izin yang diperlukan

• Tambahkan akun pengguna atau layanan IAM ke cluster. Untuk mengetahui informasi selengkapnya, lihat Menerapkan peran IAM.
• Berikan peran spanner.databaseReader kepada pengguna IAM di tingkat project. Untuk mengetahui informasi selengkapnya, lihat Menambahkan binding kebijakan IAM untuk project.
• Berikan peran dan izin kepada pengguna IAM di tingkat project untuk database yang diperlukan.

Membuat agen data

Untuk membuat agen data, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman Spanner.

   Buka Spanner

2. Pilih instance dari daftar, lalu pilih database.

3. Di menu navigasi, klik Spanner Studio.

4. Di panel Explorer, di samping Agen Data, klik Lihat tindakan.

5. Klik Buat agen.

6. Di Nama agen, berikan nama agen yang unik. Nama agen peka huruf besar/kecil dan dapat berisi huruf, angka, tanda hubung, dan garis bawah.

7. Opsional. Di Deskripsi agen, tambahkan deskripsi untuk agen Anda.

8. Opsional. Klik Show Advanced Options dan di Select a location, pilih region untuk menyimpan konteks agen.

9. Klik Create.

Catatan: Pembuatan agen pertama dalam project dapat memerlukan waktu beberapa menit.

Membangun konteks agen

Setelah membuat agen, ikuti langkah-langkah di Membangun konteks menggunakan Gemini CLI untuk membuat file konteks agen. Kemudian, Anda dapat mengedit agen untuk mengupload file konteks.

Mengedit agen

Untuk mengedit agen data, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman Spanner.

   Buka Spanner

2. Pilih instance dari daftar, lalu pilih database.

3. Di menu navigasi, klik Spanner Studio.

4. Di panel Explorer, di samping Agen Data, klik Lihat tindakan.

5. Klik Edit agen.

6. Opsional: Edit Deskripsi agen.

7. Klik Jelajahi di bagian Upload file konteks agen, lalu pilih file konteks agen.

8. Klik Simpan.

Menghapus agen data

Untuk menghapus agen data, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman Spanner.

   Buka Spanner

2. Pilih instance dari daftar, lalu pilih database.

3. Di menu navigasi, klik Spanner Studio.

4. Di panel Explorer, di samping Agen Data, klik Lihat tindakan.

5. Klik Hapus agen.

6. Di dialog konfirmasi Hapus agen, masukkan nama agen.

7. Klik Konfirmasi untuk menghapus agen.

Catatan: Sebelum menghapus database, Anda harus menghapus semua agen yang terkait dengan database tersebut.

Langkah berikutnya

• Pelajari agen data lebih lanjut.
• Pelajari cara memeriksa dan memanggil agen data.