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

Catatan rilis ini ditujukan untuk update pada Conversational Analytics API.

16 April 2026

Update Conversational Analytics API:

Fitur

Conversational Analytics API kini mendukung kueri tabel Lakehouse yang terhubung ke katalog REST Apache Iceberg atau digabungkan ke katalog eksternal. Jika Anda menggunakan tabel Lakehouse, gunakan sintaksis project.catalog.namespace.table (P.C.N.T) empat bagian. Untuk mengetahui informasi selengkapnya, lihat Mengautentikasi dan menghubungkan ke sumber data.

30 Maret 2026

Update Conversational Analytics API:

Fitur

Conversational Analytics API kini mendukung AlloyDB for PostgreSQL, Cloud SQL for MySQL, Cloud SQL for PostgreSQL, dan Spanner sebagai sumber data. Fitur ini memungkinkan pengguna membuat kueri data operasional mereka menggunakan bahasa alami dan menerjemahkan dialog manusia yang kompleks menjadi kueri database yang akurat untuk memberikan insight yang dapat ditindaklanjuti. Fitur ini berada dalam Pratinjau. Untuk informasi selengkapnya, lihat referensi berikut:

• Ringkasan analisis percakapan untuk AlloyDB
• Ringkasan analisis percakapan untuk Cloud SQL for MySQL
• Ringkasan analisis percakapan untuk Cloud SQL for PostgreSQL
• Ringkasan analisis percakapan untuk Spanner

Fitur

Pembaruan pada Conversational Analytics API untuk sumber data BigQuery mencakup fitur dan peningkatan berikut:

• Conversational Analytics API kini terintegrasi dengan Cloud Storage melalui fungsi ObjectRef. Hal ini memungkinkan API menjawab pertanyaan tentang data tidak terstruktur di bucket Cloud Storage, seperti gambar dan PDF, dengan mereferensikan kolom ObjectRef di tabel mana pun.
• API ini kini mendukung serangkaian fungsi BigQuery ML, termasuk AI.FORECAST, AI.DETECT_ANOMALIES, dan AI.GENERATE. API dapat menggunakan fungsi ini untuk menjawab berbagai pertanyaan yang lebih luas, seperti untuk tugas perkiraan, deteksi anomali, dan AI generatif.
• Conversational Analytics API kini dapat menggunakan partisi tabel BigQuery. API dapat mengoptimalkan kueri SQL dengan menggunakan kolom berpartisi, seperti rentang tanggal, pada tabel berpartisi tanggal, yang dapat meningkatkan performa kueri dan mengurangi biaya.

• Tugas BigQuery yang dimulai oleh Conversational Analytics API kini menyertakan label yang memungkinkan Anda mengidentifikasinya dalam Histori Tugas BigQuery di konsol Google Cloud . Label ini dapat membantu memantau biaya, mengaudit aktivitas agen, dan menganalisis performa kueri. Karena label ini tidak terlihat langsung di tabel histori tugas BigQuery Studio, Anda dapat mengidentifikasinya dengan membuat kueri INFORMATION_SCHEMA.JOBS untuk label yang mirip dengan {'ca-bq-job': 'true'}:

  SELECT
    COUNT(*) AS job_count
  FROM
    `PROJECT_ID`.`region-LOCATION`.INFORMATION_SCHEMA.JOBS
  WHERE
    EXISTS (
      SELECT 1
      FROM UNNEST(labels) AS label
      WHERE label.key = 'ca-bq-job' AND label.value = 'true'
    );

  Dalam kueri contoh, Anda akan mengganti nilai contoh sebagai berikut:

  • PROJECT_ID: Google Cloud Project ID Anda.
  • LOCATION: lokasi tugas BigQuery Anda.

Fitur

Untuk agen data yang menggunakan sumber data Looker atau BigQuery, Anda kini dapat menentukan nilai thinkingMode sebesar FAST dalam permintaan chat untuk mengaktifkan mode berpikir "Cepat". Berpikir cepat dapat membantu meningkatkan latensi dengan mengurangi waktu berpikir secara keseluruhan. Namun, mode ini membuat jawaban menjadi kurang transparan karena tidak ada pesan dengan nilai TextType sebesar THOUGHT yang ditampilkan dalam aliran respons. Selain itu, penggunaan mode ini dapat memengaruhi akurasi respons.

Fitur

Untuk agen data yang menggunakan sumber data Looker, agen kini dapat mengajukan pertanyaan lanjutan untuk mengklarifikasi ambiguitas dalam kueri, seperti saat ada beberapa kolom dengan nama yang serupa. Pertanyaan ini ditampilkan sebagai respons TextMessage dengan awalan Clarification needed:. Untuk mengetahui informasi selengkapnya, lihat Mengajukan pertanyaan yang efektif.

Fitur

Untuk agen data yang menggunakan sumber data BigQuery, agen kini dapat mengajukan pertanyaan lanjutan untuk mengklarifikasi ambiguitas dalam kueri, seperti saat ada beberapa kolom dengan nama yang serupa. Pertanyaan ini ditampilkan sebagai respons TextMessage.

Diubah

Untuk agen data yang menggunakan sumber data Looker, beberapa peningkatan telah dilakukan untuk mengurangi latensi, termasuk panggilan alat paralel dan penggunaan cache Looker yang lebih baik.

26 Maret 2026

Update Conversational Analytics API:

Fitur

Untuk Conversational Analytics API dengan sumber data Looker, Anda dapat menggunakan kunci enkripsi yang dikelola pelanggan (CMEK) untuk membantu melindungi resource DataAgent dan Conversation dalam penyimpanan. CMEK di Conversational Analytics API tersedia dalam Pratinjau. Untuk mengetahui informasi selengkapnya, lihat Kunci enkripsi yang dikelola pelanggan (CMEK).

11 Februari 2026

Update Conversational Analytics API:

Fitur

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.

Fitur

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

Diubah

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

6 Februari 2026

Update Conversational Analytics API:

Fitur

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:

Fitur

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.

Fitur

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:

Fitur

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 [e-mail].

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.

Fitur

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

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.

Fitur

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.

Tetap

Masalah terkait big_query_max_billed_bytes yang tidak diterapkan dengan benar telah diperbaiki.

Tetap

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:

Fitur

Library klien berikut telah ditambahkan:

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

21 Oktober 2025

Update Conversational Analytics API:

Fitur

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

25 September 2025

Update Conversational Analytics API:

Fitur

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.

Fitur

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.

Fitur

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.

Diubah

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

25 Agustus 2025

Pengumuman

Conversational Analytics API kini tersedia dalam Pratinjau Publik.

Pembaruan library klien:

Fitur

Library klien berikut kini tersedia untuk beberapa bahasa:

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

Update Conversational Analytics API:

Fitur

Dukungan untuk endpoint v1beta untuk HTTP REST kini tersedia.

Fitur

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

Fitur

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

Fitur

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

Fitur

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.

Diubah

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

Diubah

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

Diubah

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 Conversational Analytics API.

Diubah

Colaboratory versi 1.1 kini tersedia.

Tetap

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

Tetap

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

Pembaruan dokumentasi:

Fitur

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

Fitur

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.

Fitur

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

Fitur

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.

Fitur

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

Fitur

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

Fitur

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

Fitur

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

Fitur

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

Fitur

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

Fitur

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

15 Juli 2025

Fitur

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.

Fitur

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:

Fitur

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

25 Juni 2025

Update API:

Fitur

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 Memberikan peran dan izin IAM Conversational Analytics API.

5 Juni 2025

Pengumuman

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

Fitur

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

• Notebook Colab HTTP
• Notebook Colab Python SDK

Update API:

Fitur

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

Fitur

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.

Fitur

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

Diubah

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.