Catatan rilis Conversational Analytics API

Catatan rilis ini ditujukan untuk update pada Conversational Analytics API.

11 Februari 2026

Update Conversational Analytics API:

Permintaan chat dengan sumber data BigQuery kini memberikan lebih banyak insight tentang proses penalaran agen. Meskipun skema API tidak berubah, Anda akan melihat perilaku baru berikut dalam aliran respons:

  • Aliran respons API kini menyertakan pesan systemMessage.text tambahan dengan textType = THOUGHT. Pesan ini memberikan insight langkah demi langkah tentang proses penalaran dan pengambilan keputusan agen.
  • Setelah pesan THOUGHT, API akan menampilkan jawaban sebagai urutan pesan, seperti pesan kueri, tugas, teks, hasil data, dan diagram. Untuk mengetahui informasi selengkapnya tentang jenis pesan, lihat SystemMessage.
  • Pesan skema tidak lagi disertakan dalam aliran respons untuk sumber data BigQuery.

Tersedia metode pengelolaan agen sinkron. Metode ini memungkinkan Anda membuat, memperbarui, dan menghapus agen data secara sinkron sebagai alternatif untuk metode asinkron yang ada:

  • CreateDataAgentSync
  • UpdateDataAgentSync
  • DeleteDataAgentSync

Opsi analisis Python (options.analysis.python.enabled) tidak lagi didukung untuk sumber data BigQuery.

6 Februari 2026

Update Conversational Analytics API:

Untuk agen data yang menggunakan sumber data Looker, Anda kini dapat menentukan kueri Looker yang optimal sebagai konteks terstruktur.

26 Januari 2026

Update Conversational Analytics API:

Transparansi penalaran yang ditingkatkan, yang memberikan insight langkah demi langkah tentang proses penalaran dan pengambilan keputusan agen dengan pesan textType = THOUGHT, tidak lagi memerlukan daftar yang diizinkan dan tersedia untuk semua pengguna untuk sumber data Looker.

Pengambilan data terperinci untuk sumber data Looker, yang memberikan update tentang penelusuran nilai data dengan pesan textType = PROGRESS, tidak lagi memerlukan daftar yang diizinkan dan tersedia untuk semua pengguna.

15 Desember 2025

Update Conversational Analytics API:

Aliran respons API untuk sumber data Looker 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 conversational-analytics-api-feedback@google.com.

Catatan: Mulai 26 Januari 2026, fitur ini tidak lagi memerlukan daftar yang diizinkan dan tersedia untuk semua pengguna untuk sumber data Looker; lihat entri untuk 26 Januari 2026.

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 conversational-analytics-api-feedback@google.com.

Catatan: Mulai 26 Januari 2026, fitur ini tidak lagi memerlukan daftar yang diizinkan dan tersedia untuk semua pengguna untuk sumber data Looker; lihat entri untuk 26 Januari 2026.

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:

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:

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 Gemini Data Analytics" dan "Pembuat Agen Data Gemini Data Analytics". 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 API Analisis Percakapan.

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:

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