Membangun agen data dan memulai percakapan dengan data Anda

Penting: API Tanya Jawab tentang Data tidak digunakan lagi. Jika Anda bermigrasi dari Data QnA API, lihat panduan migrasi untuk mengetahui ringkasan perbedaan utama dan langkah-langkah migrasi yang diperlukan.

Developer dapat menggunakan Conversational Analytics API, yang diakses melalui geminidataanalytics.googleapis.com atau endpoint regional, untuk membuat antarmuka chat yang didukung teknologi kecerdasan buatan (AI), atau agen data. API ini menggunakan bahasa alami untuk menjawab pertanyaan tentang data terstruktur di BigQuery, Looker, dan Data Studio, serta mendukung pengiriman kueri data dari AlloyDB, GoogleSQL untuk Spanner, Cloud SQL, dan Cloud SQL untuk PostgreSQL melalui metode QueryData.

Dengan Conversational Analytics API, Anda memberikan informasi dan data bisnis (konteks) kepada agen data, serta akses ke alat seperti SQL, Python, dan library visualisasi. Respons agen ini ditampilkan kepada pengguna dan dapat dicatat oleh aplikasi klien, sehingga menciptakan pengalaman chat data yang lancar dan dapat diaudit.

Pelajari cara dan waktu Gemini untuk Google Cloud menggunakan data Anda.

Sebagai teknologi tahap awal, Gemini untuk produk Google Cloud dapat menghasilkan output yang seolah masuk akal, tetapi mengandung fakta yang salah. Sebaiknya Anda memvalidasi semua output dari Gemini untuk Google Cloud produk sebelum Anda menggunakannya. Untuk mengetahui informasi selengkapnya, lihat Gemini untuk Google Cloud dan responsible AI.

Mulai menggunakan Conversational Analytics API

Untuk mulai menggunakan Conversational Analytics API, tinjau dokumentasi berikut untuk memahami pendekatan integrasi dan konsep inti yang tersedia:

• Arsitektur dan konsep utama: Pahami cara agen data memproses permintaan, alur kerja untuk pembuat dan pengguna agen, mode percakapan, dan peran Identity and Access Management (IAM) yang diperlukan.
• Pola integrasi untuk agen data: Bandingkan pendekatan arsitektur untuk menentukan metode koneksi terbaik untuk aplikasi Anda.
• Pengelolaan status: Pelajari mode percakapan stateful dan stateless, cara API mengelola histori percakapan, dan cakupan status sesi ADK.
• Keamanan, privasi, risiko, dan kepatuhan: Pahami opsi keamanan dan kepatuhan untuk Conversational Analytics API.
• Lokasi Conversational Analytics API: Memberikan ringkasan endpoint API regional atau multiregional yang memungkinkan Anda mengontrol lokasi geografis resource, konfigurasi, dan data agen.

Untuk mulai membuat agen data, selesaikan langkah-langkah dalam dokumentasi penyiapan dan prasyarat. Untuk panduan langkah demi langkah, aplikasi contoh, SDK, dan alat pengembangan lainnya, lihat Tutorial, demo, dan alat Conversational Analytics API.

Penyiapan dan prasyarat

Sebelum Anda menggunakan API atau contoh, selesaikan langkah-langkah berikut:

• Mengaktifkan Conversational Analytics API: Menjelaskan prasyarat untuk mengaktifkan Conversational Analytics API.
• Kontrol akses dengan IAM: Menjelaskan cara menggunakan Identity and Access Management untuk membagikan dan mengelola akses ke agen data.
• Mengautentikasi dan menghubungkan ke sumber data: Memberikan petunjuk untuk mengautentikasi API dan mengonfigurasi koneksi ke data BigQuery, Lakehouse, Looker, Data Studio, dan Cloud Databases Anda (AlloyDB, GoogleSQL untuk Spanner, Cloud SQL, dan Cloud SQL untuk PostgreSQL).
• Kunci enkripsi yang dikelola pelanggan (CMEK): Menjelaskan cara menggunakan kunci enkripsi Anda sendiri di Cloud Key Management Service untuk melindungi agen data dan percakapan yang menggunakan sumber data Looker.
• Batasan kebijakan organisasi: Menjelaskan cara menggunakan batasan kebijakan organisasi yang telah ditentukan sebelumnya untuk mengontrol resource di tingkat organisasi, folder, atau project.

Membangun dan berinteraksi dengan agen data

Setelah menyelesaikan langkah-langkah sebelumnya, gunakan Conversational Analytics API untuk membuat dan berinteraksi dengan agen data dengan mengikuti langkah-langkah berikut:

• Membangun agen data menggunakan HTTP: Memberikan contoh lengkap tentang cara membangun dan berinteraksi dengan agen data menggunakan permintaan HTTP langsung dengan Python.
• Membangun agen data menggunakan Python SDK: Memberikan contoh lengkap tentang cara membangun dan berinteraksi dengan agen data menggunakan Python SDK.
• Memandu perilaku agen dengan konteks yang dibuat: Pelajari cara memberikan konteks yang dibuat untuk memandu perilaku agen dan meningkatkan akurasi respons. Anda juga dapat melihat contoh konteks yang dibuat dengan sumber data BigQuery dan dengan sumber data Looker.
• Merender respons agen Conversational Analytics API sebagai visualisasi: Memberikan contoh pemrosesan spesifikasi diagram dari respons API dan merendernya sebagai visualisasi menggunakan Python SDK dan library Vega-Altair.
  Catatan: Pembuatan agen data menggunakan HTTP atau Python SDK, dan rendering visualisasi tidak didukung untuk sumber data database (AlloyDB, GoogleSQL untuk Spanner, Cloud SQL, dan Cloud SQL untuk PostgreSQL).

Praktik terbaik

Tinjau panduan berikut untuk mempelajari praktik terbaik penggunaan Conversational Analytics API:

• Mengelola biaya BigQuery untuk agen Anda: Pelajari cara memantau dan mengelola biaya BigQuery untuk agen Conversational Analytics API dengan menetapkan batas pembelanjaan tingkat project, tingkat pengguna, dan tingkat kueri.
• Ajukan pertanyaan yang efektif: Pelajari cara membuat pertanyaan yang efektif untuk agen Anda agar mendapatkan hasil maksimal dari Conversational Analytics API.
• Retensi dan penghapusan data: Pelajari retensi dan penghapusan data untuk agen dan percakapan data Conversational Analytics API.
• Kuota dan batas: Pelajari kuota dan batas untuk Conversational Analytics API.
• Memecahkan masalah error Conversational Analytics API: Memecahkan masalah error umum Conversation Analytics API.
• Batasan umum: Memberikan informasi mendetail tentang batasan umum Conversational Analytics API, termasuk batasan kueri, data, visualisasi, dan pertanyaan.
• Merender respons agen untuk sumber data Looker: Pelajari praktik terbaik untuk merender respons Conversational Analytics API di antarmuka pengguna saat Anda menggunakan sumber data Looker.

Referensi API dan library klien

• Referensi REST Analisis Data Gemini: Memberikan deskripsi mendetail tentang versi, metode, endpoint, dan definisi jenis API.
• SDK dan alat pengembangan: Mencantumkan library klien khusus bahasa.

Operasi API utama

API ini menyediakan endpoint inti berikut untuk mengelola agen data dan percakapan:

Operasi	Metode HTTP	Endpoint	Deskripsi
Buat agen	POST	/v1/projects/*/locations/*/dataAgents	Membuat agen data baru.
Membuat agen secara sinkron	POST	/v1/projects/*/locations/*/dataAgents:createSync	Membuat agen data baru secara serentak.
Mendapatkan agen	GET	/v1/projects/*/locations/*/dataAgents/*	Mengambil detail agen data tertentu.
Mendapatkan kebijakan Identity and Access Management	POST	/v1/projects/*/locations/*/dataAgents/*:getIamPolicy	Mendapatkan izin Pengelolaan Akses dan Identitas yang ditetapkan untuk setiap pengguna pada agen data tertentu. Pengguna dengan peran Pemilik Agen Data dapat memanggil endpoint ini untuk melihat kebijakan Pengelolaan Akses dan Identitas agen data sebelum menggunakan endpoint setIAMpolicy untuk membagikan agen data kepada pengguna lain.
Menetapkan kebijakan Identity and Access Management	POST	/v1/projects/*/locations/*/dataAgents/*:setIamPolicy	Menetapkan kebijakan Identity and Access Management untuk agen data tertentu. Pengguna dengan peran Pemilik Agen Data harus memanggil endpoint ini untuk membagikan agen data kepada pengguna lain, yang secara efektif memperbarui izin Pengelolaan Akses dan Identitas pengguna tersebut.
Memperbarui agen	PATCH	/v1/projects/*/locations/*/dataAgents/*	Mengubah agen data yang ada.
Memperbarui agen secara sinkron	PATCH	/v1/projects/*/locations/*/dataAgents/*:updateSync	Mengubah agen data yang ada secara serentak.
Mencantumkan agen	GET	/v1/projects/*/locations/*/dataAgents	Mencantumkan agen data yang tersedia dalam project.
Mencantumkan agen yang dapat diakses	GET	/v1/projects/*/locations/*/dataAgents:listaccessible	Mencantumkan agen data yang dapat diakses dalam project. Agen data dianggap dapat diakses jika pengguna yang memanggil API ini memiliki izin get pada agen. Anda dapat menggunakan kolom creator_filter untuk mengelola agen mana yang ditampilkan oleh metode ini: NONE (default): Menampilkan semua agen data yang dapat diakses oleh pengguna, terlepas dari siapa yang membuat agen. CREATOR_ONLY: Hanya menampilkan agen data yang dapat diakses oleh pengguna dan yang dibuat oleh pengguna tersebut. NOT_CREATOR_ONLY: Hanya menampilkan agen data yang dapat diakses oleh pengguna dan yang dibuat oleh orang lain.
Menghapus agen	DELETE	/v1/projects/*/locations/*/dataAgents/*	Menghapus agen data.
Menghapus agen secara serentak	DELETE	/v1/projects/*/locations/*/dataAgents/*:deleteSync	Menghapus agen data secara serentak.
Buat percakapan	POST	/v1/projects/*/locations/*/conversations	Memulai percakapan baru yang persisten.
Memulai percakapan dengan menggunakan referensi percakapan	POST	/v1/projects/*/locations/*:chat	Melanjutkan percakapan stateful dengan mengirim pesan chat yang mereferensikan percakapan yang ada dan konteks agen terkait. Untuk percakapan bolak-balik, Google Cloud menyimpan dan mengelola histori percakapan.
Mulai percakapan menggunakan referensi agen data	POST	/v1/projects/*/locations/*:chat	Mengirim pesan chat tanpa status yang mereferensikan agen data tersimpan untuk konteks. Untuk percakapan multi-turn, aplikasi Anda harus mengelola dan menyediakan histori percakapan dengan setiap permintaan.
Melakukan percakapan dengan menggunakan konteks inline	POST	/v1/projects/*/locations/*:chat	Mengirim pesan chat stateless dengan memberikan semua konteks langsung dalam permintaan, tanpa menggunakan agen data tersimpan. Untuk percakapan multi-turn, aplikasi Anda harus mengelola dan menyediakan histori percakapan dengan setiap permintaan.
Mendapatkan percakapan	GET	/v1/projects/*/locations/*/conversations/*	Mengambil detail percakapan tertentu.
Membuat daftar percakapan	GET	/v1/projects/*/locations/*/conversations	Mencantumkan percakapan dalam project tertentu.
Mencantumkan pesan dalam percakapan	GET	/v1/projects/*/locations/*/conversations/*/messages	Mencantumkan pesan dalam percakapan tertentu.
Menghapus percakapan	DELETE	/v1/projects/*/locations/*/conversations/*	Menghapus percakapan tertentu. Peran Identity and Access Management Admin Topik atau minimal izin Identity and Access Management cloudaicompanion.topics.delete diperlukan untuk memanggil endpoint ini.
Data kueri	POST	/v1beta/projects/*/locations/*/conversations:queryData	Mengueri data dari database AlloyDB, GoogleSQL untuk Spanner, Cloud SQL, dan Cloud SQL untuk PostgreSQL menggunakan bahasa alami.

Dukungan dan masukan

Untuk mendapatkan bantuan atau melaporkan masalah, hubungi Customer Care. Ikuti panduan di Membuat dan mengelola kasus dukungan untuk membuka kasus dukungan Anda. Gunakan panduan berikut saat membuat kasus Anda:

• Untuk mendapatkan dukungan terkait Conversational Analytics API dengan BigQuery, di daftar Select a product, pilih BigQuery, dan di kolom Feature, pilih AI and Machine Learning::Conversational Analytics API in BigQuery.
• Untuk mendapatkan dukungan terkait Conversational Analytics API dengan Looker, di daftar Select a product, pilih Looker (original), dan di kolom Feature, pilih Gemini in Looker::Conversational Analytics API.

Catatan: Dukungan untuk Conversational Analytics API mencakup masalah teknis terkait penggunaan layanan API. Proses debug kode umum dan kustom berada di luar cakupan. Pelanggan bertanggung jawab untuk men-debug kode kustom mereka sendiri.

Jika Anda memiliki masukan atau pertanyaan umum tentang Conversational Analytics API, kirim email ke [e-mail]. Kami tidak menjamin respons terhadap komunikasi email, tetapi kami membaca email dan merujuk pada masukan ini selama perencanaan peta jalan.

Anda juga dapat mengajukan permintaan fitur untuk fungsionalitas Conversational Analytics API baru.