Catatan rilis 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.

Catatan rilis ini ditujukan untuk update pada Conversational Analytics API.

15 Desember 2025

Update Conversational Analytics API:

Aliran respons API untuk sumber data Looker dan BigQuery mencakup pesan systemMessage.text tambahan dengan textType = THOUGHT. Pesan ini memberikan insight langkah demi langkah tentang proses penalaran dan pengambilan keputusan agen saat berupaya menjawab kueri Anda. Untuk menjalankan contoh chat yang menunjukkan penalaran ini, lihat notebook Colaboratory HTTP dan Python SDK. Untuk panduan tentang cara merender pesan THOUGHT dengan sumber data Looker, lihat Merender respons agen untuk sumber data Looker. Ini adalah pengumuman awal tentang fitur eksperimental yang tersedia berdasarkan permintaan. Untuk meminta akses ke fitur ini, kirim email ke [e-mail].

Untuk sumber data Looker, agen menggunakan metode yang lebih terperinci untuk mengambil skema Jelajah dan nilai data. Saat agen menelusuri nilai data tertentu, aliran API juga menyertakan pesan systemMessage.text dengan textType = PROGRESS, yang memberikan info terbaru tentang status dan hasil penelusuran. Untuk panduan tentang cara merender pesan PROGRESS, lihat Merender respons agen untuk sumber data Looker. Ini adalah pengumuman awal tentang fitur eksperimental yang tersedia berdasarkan permintaan. Untuk meminta akses ke fitur ini, kirim email ke [e-mail].

Integrasi Conversational Analytics API dengan Kontrol Layanan VPC masih dalam Pratinjau. Integrasi ini siap untuk pengujian dan penggunaan yang lebih luas, tetapi tidak sepenuhnya didukung untuk lingkungan produksi. Untuk mengetahui detail selengkapnya, lihat daftar produk yang didukung.

Masalah terkait big_query_max_billed_bytes yang tidak diterapkan dengan benar telah diperbaiki.

Masalah terkait cara API menangani sumber data Looker telah diperbaiki, termasuk masalah berikut:

• Pemformatan nilai yang lebih baik dalam respons teks
• Pemfilteran yang lebih baik untuk kecocokan persis
• Peningkatan dukungan pengukuran period-over-period (PoP)
• Peningkatan dukungan always_filter

Pembaruan library klien:

Library klien berikut telah ditambahkan:

• Node.js (v1beta)
• Java (v1beta)
• Go (v1beta)
• Ruby (v1beta)

21 Oktober 2025

Update Conversational Analytics API:

Dukungan untuk metode API deleteConversation telah ditambahkan ke REST API dan SDK.

25 September 2025

Update Conversational Analytics API:

API baru, ListAccessibleDataAgents, kini tersedia untuk mencantumkan agen data yang dapat diakses oleh pengguna dalam project. Agen data dianggap dapat diakses jika pengguna yang memanggil API 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 pembuatnya.
• CREATOR_ONLY: Hanya menampilkan agen data yang dibuat oleh pengguna.
• NOT_CREATOR_ONLY: Hanya menampilkan agen data yang dibuat oleh pengguna lain.

Enum systemMessage.text.textType kini tersedia dengan nilai FINAL_RESPONSE dan THOUGHT, yang membantu klien membedakan berbagai jenis pesan teks. Conversational Analytics API kini menggunakan pesan systemMessage.text dengan textType = THOUGHT untuk menghasilkan langkah-langkah pemikiran.

API kini mendukung hingga lima sumber data Eksplorasi Looker dalam konteks. Permintaan chat menghasilkan kueri di Jelajahi yang paling relevan. Untuk mengetahui informasi selengkapnya, lihat dokumentasi tentang cara menghubungkan ke data Looker dengan HTTP dan dengan Python SDK.

Kolom systemMessage.data.generatedLookerQuery sekarang adalah systemMessage.data.query.looker.

25 Agustus 2025

Conversational Analytics API kini tersedia dalam Pratinjau Publik.

Pembaruan library klien:

Library klien berikut kini tersedia untuk beberapa bahasa:

• PHP (v1beta)
• DotNet (v1beta)
• Python (v1beta)

Update Conversational Analytics API:

Dukungan untuk endpoint v1beta untuk HTTP REST kini tersedia.

Dukungan untuk metode API GetLocation dan ListLocations telah ditambahkan ke REST API dan SDK.

Anda kini dapat membagikan agen data menggunakan metode API GetIamPolicy dan SetIamPolicy.

Anda kini dapat membuat agen data dari sumber data Looker yang didasarkan pada instance Looker (Google Cloud core) yang menggunakan jaringan IP pribadi. (Conversational Analytics API tidak mendukung sumber data berdasarkan instance Looker (Google Cloud core) yang berada di dalam perimeter Virtual Private Cloud.)

Konteks terstruktur untuk sumber data BigQuery kini tersedia. Hal ini mencakup kemampuan untuk menambahkan contoh pasangan pertanyaan/kueri, deskripsi tabel, sinonim, dan tag di tingkat tabel dan kolom menggunakan API.

API lokasi dan operasi kini didukung. Peran Identity and Access Management DataAgentCreator dan DataAgentEditor kini akan memiliki izin untuk API operasi.

Peningkatan telah dilakukan untuk penyimpanan otomatis Last Published Context di lapisan server setiap kali konteks yang dipublikasikan agen data diperbarui.

Nama tampilan untuk peran Identity and Access Management telah diperbarui menjadi "Pengguna Chat Stateless Analisis Data Gemini" dan "Pembuat Agen Data Analisis Data Gemini". Untuk mengetahui informasi selengkapnya tentang peran Identity and Access Management yang digunakan dengan API, lihat halaman dokumentasi Memberikan peran dan izin Identity and Access Management Conversational Analytics API.

Colaboratory versi 1.1 kini tersedia.

Penanganan error telah diperbarui untuk menangani error internal 500 terkait percakapan untuk chat stateful.

Pesan penanganan pengecualian yang lebih baik telah diterapkan untuk error klien 400.

Pembaruan dokumentasi:

Anda kini dapat menggunakan Aplikasi Panduan Memulai Streamlit baru di GitHub untuk menyiapkan demo Conversational Analytics API dalam hitungan menit.

Demo Emas Conversational Analytics API kini tersedia di GitHub. Dengan Demo Emas Conversational Analytics API, Anda dapat melihat contoh untuk mengintegrasikan Conversational Analytics API ke dalam aplikasi web serta demo produksi lengkap di TypeScript. Project ini hanya ditujukan untuk tujuan demonstrasi. Fitur ini tidak dimaksudkan untuk digunakan di lingkungan produksi.

Contoh kode payload permintaan telah ditambahkan untuk REST API dan SDK.

Arsitektur, alur kerja, dan peran Conversational Analytics API: Pelajari lebih lanjut konsep utama untuk menggunakan Conversational Analytics API, termasuk cara kerja agen data, alur kerja agen data umum, mode percakapan, peran Pengelolaan Identitas dan Akses, serta cara mendesain sistem yang menggunakan beberapa agen data.

Batasan umum Conversational Analytics API: Pelajari lebih lanjut batasan pada jumlah sumber data, gaya visualisasi, dan ukuran set data.

Memecahkan masalah error Conversational Analytics API: Pelajari lebih lanjut potensi masalah atau error pada Conversational Analytics API, serta solusi yang diusulkan.

Memantau dan mengelola biaya BigQuery untuk agen Conversational Analytics API Anda: Pelajari lebih lanjut cara menerapkan kontrol biaya untuk agen Conversational Analytics API Anda.

Metode SetIAMPolicy dan GetIAMPolicy tersedia di halaman dokumentasi Ringkasan Conversational Analytics API untuk digunakan dalam berbagi agen data.

Halaman dokumentasi baru yang berisi jawaban atas pertanyaan umum (FAQ) tentang Conversational Analytics API kini tersedia.

Menentukan konteks agen data untuk sumber data BigQuery: Pelajari lebih lanjut cara menulis petunjuk sistem untuk sumber data BigQuery.

Menentukan konteks agen data untuk sumber data Looker: Pelajari lebih lanjut cara menulis petunjuk sistem untuk sumber data Looker.

15 Juli 2025

Anda kini dapat mengundang pengguna untuk berkolaborasi pada agen data tertentu dengan menetapkan peran IAM yang telah ditentukan sebelumnya. Untuk mengetahui detailnya, lihat Peran dan izin IAM Conversational Analytics API.

Panduan praktik terbaik baru membantu Anda memberikan konteks bisnis dan data yang efektif kepada agen Anda. Untuk mengetahui informasi selengkapnya, lihat Memandu perilaku agen dengan konteks yang dibuat.

Update SDK:

Sekarang Anda dapat menginstal Python SDK dari Python Package Index (PyPI).

25 Juni 2025

Update API:

Peran IAM bawaan baru mengontrol akses untuk membuat, mengelola, dan berinteraksi dengan agen data:

• geminidataanalytics.dataAgentCreator
• geminidataanalytics.dataAgentOwner
• geminidataanalytics.dataAgentEditor
• geminidataanalytics.dataAgentUser
• geminidataanalytics.dataAgentViewer
• geminidataanalytics.dataAgentStatelessUser

Untuk mengetahui daftar lengkap peran dan izinnya, lihat Memberi peran dan izin IAM Conversational Analytics API.

5 Juni 2025

Pratinjau Pribadi awal Conversational Analytics API memperkenalkan kemampuan untuk membuat dan berinteraksi dengan agen data.

Notebook Colaboratory interaktif berikut tersedia untuk mulai menggunakan REST dan Python SDK:

• Notebook Colab HTTP
• Notebook Colab Python SDK

Update API:

Layanan Agen Data memungkinkan Anda membuat, mengonfigurasi, dan mengelola agen AI persisten yang sadar konteks secara terprogram dengan Looker, Looker Studio, dan BigQuery.

Layanan Chat Data memungkinkan Anda memulai percakapan dengan agen menggunakan beberapa mode chat. Mode ini mencakup mode stateful tempat Google mengelola histori percakapan, opsi stateful tempat aplikasi Anda mengelola percakapan, dan mode stateless tempat aplikasi Anda memberikan konteks lengkap dengan setiap permintaan.

API ini mendukung analisis lanjutan menggunakan Python dan otomatis mencoba ulang kueri yang gagal.

Conversational Analytics API (geminidataanalytics.googleapis.com) menggantikan Data QnA API (dataqna.googleapis.com) yang tidak digunakan lagi. Hal ini mencakup migrasi dari DataQuestionService ke DataChatService yang baru. Untuk mengetahui petunjuk mendetail tentang cara memperbarui permintaan, lihat panduan migrasi.