Halaman ini diterjemahkan oleh Cloud Translation API.

Catatan rilis Conversational Analytics API

Catatan rilis ini ditujukan untuk update pada Conversational Analytics API.

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 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 Conversational Analytics API, lihat halaman dokumentasi Memberi 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.

Memandu perilaku agen dengan konteks yang dibuat untuk sumber data BigQuery: Pelajari lebih lanjut cara menulis petunjuk sistem untuk sumber data BigQuery.

Memandu perilaku agen dengan konteks yang dibuat untuk sumber data Looker: Pelajari lebih lanjut cara menulis petunjuk sistem untuk sumber data Looker.

15 Juli 2025

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