Conversational Analytics API adalah alat canggih yang memungkinkan Anda membuat kueri data menggunakan bahasa alami. Halaman ini memberikan panduan tentang cara memformat pertanyaan yang efektif untuk mendapatkan output yang ideal. Halaman ini mencakup praktik terbaik untuk tindakan berikut:
- Mengajukan pertanyaan umum
- Mengajukan pertanyaan multi-bagian untuk analisis yang lebih kompleks
- Mengajukan pertanyaan dengan kondisi data
- Meminta agregasi data
- Mengajukan pertanyaan lanjutan
- Meminta hasil yang diformat
Mengajukan pertanyaan umum
Saat mengajukan pertanyaan umum, Anda harus spesifik dan memberikan konteks. Daripada mengajukan pertanyaan yang luas, sebaiknya persempit cakupannya dengan menyertakan detail yang relevan, seperti tanggal, kategori tertentu, atau filter numerik.
Agen data yang menggunakan sumber data Looker dapat mengajukan pertanyaan lanjutan untuk mengklarifikasi ambiguitas dalam kueri asli. Misalnya, jika ada beberapa kolom dengan nama yang mirip, agen data dapat meminta Anda untuk mengklarifikasi kolom mana yang paling sesuai untuk digunakan dalam memproses kueri Anda. Pertanyaan ini akan muncul dalam respons Perlu Klarifikasi.
Contoh
Pertanyaan asli: "Berapa banyak invoice yang dibuat secara manual dan sistematis setiap tahun?"
Pertanyaan yang disempurnakan: "Berikan jumlah invoice yang dibuat secara manual dan sistematis setiap tahun. Dengan asumsi dibutuhkan waktu 15 menit untuk membuat 1 invoice manual, hitung dan berikan ringkasan total waktu yang dibutuhkan dalam jam untuk memproses semua invoice manual."
Alasan pertanyaan ini efektif: Pertanyaan yang disempurnakan menambahkan persyaratan perhitungan tertentu (waktu yang dihabiskan untuk invoice manual) dan menentukan format output, yaitu ringkasan.
Mengajukan pertanyaan multi-bagian untuk analisis yang lebih kompleks
Pecah pertanyaan kompleks menjadi beberapa bagian untuk membantu Conversational Analytics API memproses setiap komponen secara akurat.
Contoh
Pertanyaan asli: "Berapa rata-rata waktu penyelesaian dalam hari untuk pembayaran tunai saat pengiriman dan pelunasan pembayaran untuk setiap jenis piutang (PHA, rabat koperasi, kartu kredit, media retail) dan berapa persentase pelunasan manual? Dengan asumsi kita menghabiskan waktu 15 menit untuk setiap piutang yang dilunasi secara manual, berapa banyak waktu yang kita habiskan untuk aplikasi tunai dan pelunasan untuk setiap jenis piutang setiap tahun?"
Pertanyaan yang disempurnakan, bagian 1: "Berapa rata-rata waktu penyelesaian dalam hari untuk setiap jenis piutang antara 05-05-2025 dan 01-06-2025?"
Pertanyaan yang disempurnakan, bagian 2: "Berapa persentase pelunasan manual antara 05-05-2025 dan 01-06-2025 untuk setiap jenis piutang?"
Pertanyaan yang disempurnakan, bagian 3: "Dengan asumsi kita menghabiskan waktu 15 menit untuk setiap piutang yang dilunasi secara manual, berapa banyak waktu yang kita habiskan untuk aplikasi tunai dan pelunasan untuk setiap jenis piutang setiap tahun?"
Alasan pertanyaan ini efektif: Dengan mengajukan pertanyaan secara terpisah, Conversational Analytics API dapat menangani setiap metrik tertentu (rata-rata waktu penyelesaian, persentase pelunasan manual, total waktu yang dihabiskan) dengan filter yang sesuai, untuk mendapatkan hasil yang lebih akurat.
Mengajukan pertanyaan dengan kondisi data
Saat mengajukan pertanyaan dengan kondisi data, nyatakan dengan jelas semua filter dan kondisi yang diperlukan dalam pertanyaan Anda, termasuk tanggal yang tepat, batas angka, dan kategori tertentu. Pastikan Conversational Analytics API menerapkan filter yang benar (rentang tanggal, N hasil teratas, kategori tertentu, misalnya).
Contoh
Pertanyaan berikut menentukan kriteria filter dengan benar:
"Tampilkan tanggal invoice dari 02-05-2025 hingga 03-06-2025 beserta rata-rata usia invoice yang belum dibayar." Pertanyaan ini menentukan rentang tanggal dengan jelas.
"Berikan nama pelanggan, jumlah saldo terutang, rata-rata usia, dan jenis piutang untuk catatan yang berusia lebih dari 46 hari. Batasi hasil hingga 5 catatan berdasarkan saldo terutang." Pertanyaan ini menentukan usia catatan, memberikan batas, dan memberikan persyaratan pengurutan.
"Berikan industri teratas berdasarkan jumlah varians dalam saldo piutang pelanggan beserta jumlah untuk 2025FP1 dibandingkan dengan akhir tahun sebelumnya." Pertanyaan ini menentukan "industri teratas" dan periode untuk perbandingan.
Meminta agregasi data
Saat mengajukan pertanyaan untuk menggabungkan data, tentukan jenis agregasi ("jumlah saldo terutang" atau "rata-rata usia", misalnya) dan dimensi yang ingin Anda gabungkan ("nama pelanggan", "jenis piutang", atau "industri", misalnya).
Contoh
Pertanyaan berikut secara efektif menentukan persyaratan yang jelas untuk agregasi data:
"Berikan nama pelanggan, jumlah saldo terutang, rata-rata usia, dan jenis piutang untuk catatan yang berusia lebih dari 46 hari."
Mengajukan pertanyaan lanjutan
Saat mengajukan pertanyaan lanjutan, lihat konteks yang telah ditetapkan sebelumnya, tetapi nyatakan perubahan atau penambahan dengan jelas. Misalnya, jika Anda ingin mengubah rentang tanggal atau batas, nyatakan parameter baru dengan jelas.
Contoh
Pertanyaan asli: "Berikan nama pelanggan, jumlah saldo terutang, rata-rata usia, dan jenis piutang untuk catatan yang berusia lebih dari 46 hari. Batasi hasil hingga 5 catatan berdasarkan saldo terutang."
Pertanyaan lanjutan: "Berikan metrik sebelumnya untuk catatan yang berusia lebih dari 90 hari dan batasi hingga 10 catatan teratas."
Alasan pertanyaan ini efektif: Pertanyaan lanjutan menentukan perubahan pada filter "berusia lebih dari" dan batas hasil dengan jelas, sambil merujuk metrik yang sama dengan pertanyaan sebelumnya untuk konteks.
Meminta hasil yang diformat
Saat Anda mengajukan pertanyaan yang tidak menentukan format hasil, Conversational Analytics API akan menentukan format yang paling sesuai dengan kriteria tertentu dan istilah utama yang diberikan dalam pertanyaan.
Anda dapat memandu Conversational Analytics API untuk memberikan hasil dalam format berikut dengan menyertakan istilah utama dalam pertanyaan Anda:
Memandu Conversational Analytics API untuk menampilkan hasil dalam tabel
Pertanyaan berikut menyiratkan bahwa hasil harus ditampilkan dalam format tabel, karena menentukan nama kolom dimensi dan metrik:
"Berikan nama pelanggan, jumlah saldo terutang, rata-rata usia, dan jenis piutang untuk catatan yang berusia lebih dari 46 hari."
Memandu Conversational Analytics API untuk menampilkan hasil sebagai teks
Menggunakan istilah utama seperti "ringkasan", atau mengajukan pertanyaan yang hanya memerlukan respons langsung, akan memandu Conversational Analytics API untuk memberikan hasil sebagai teks.
Pertanyaan berikut menyiratkan bahwa hasil harus ditampilkan dalam output teks:
"Hitung dan berikan ringkasan total waktu yang dibutuhkan dalam jam untuk memproses semua invoice manual."
"Berapa total waktu yang dibutuhkan untuk memproses invoice manual pada minggu lalu?"
Memandu Conversational Analytics API untuk menampilkan hasil sebagai diagram garis
Menggunakan istilah utama seperti "tren", "perubahan", atau "perubahan delta" dalam pertanyaan akan memandu Conversational Analytics API untuk memberikan hasil sebagai diagram garis.
Pertanyaan berikut menyiratkan bahwa hasil harus ditampilkan sebagai diagram garis:
"Bagaimana tren bulanan saldo akhir untuk setiap industri pada tahun 2024?"
"Berapa perubahan delta harian dalam rata-rata usia invoice yang belum dibayar untuk hari ini dibandingkan hari sebelumnya antara 02-05-2025 dan 03-06-2025?"
Memandu Conversational Analytics API untuk menampilkan hasil sebagai diagram batang atau perbandingan
Menggunakan istilah utama seperti "bandingkan" dan "varians" akan memandu Conversational Analytics API untuk memberikan hasil sebagai diagram batang atau perbandingan.
Pertanyaan berikut menyiratkan bahwa hasil harus ditampilkan sebagai diagram batang atau perbandingan:
"Berikan industri teratas berdasarkan jumlah varians dalam saldo piutang pelanggan beserta jumlah untuk 2025FP1, dibandingkan dengan akhir tahun sebelumnya."
Hasil untuk pertanyaan ini akan ditampilkan sebagai diagram batang yang menampilkan varians untuk setiap industri.
Referensi lainnya
Untuk mengetahui tips pemecahan masalah tambahan dan jawaban atas pertanyaan umum, lihat halaman Pertanyaan umum tentang Conversational Analytics API.
Untuk mengetahui informasi selengkapnya tentang error API dan potensi solusinya, lihat panduan Memecahkan masalah error Conversational Analytics API.