Conversational Analytics API adalah alat canggih yang memungkinkan Anda membuat kueri untuk 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:
- Ajukan 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, bersikaplah spesifik dan berikan konteks. Daripada mengajukan pertanyaan yang terlalu luas, persempit cakupan dengan menyertakan detail yang relevan, seperti tanggal, kategori tertentu, atau filter numerik.
Contoh
Pertanyaan asli: "Berapa banyak invoice yang dibuat secara manual dan sistematis setiap tahun?"
Pertanyaan yang lebih spesifik: "Berikan jumlah invoice yang dibuat secara manual dan sistematis setiap tahun. Dengan asumsi perlu waktu 15 menit untuk membuat 1 invoice manual, hitung dan berikan ringkasan total waktu yang diperlukan dalam jam untuk memproses semua invoice manual."
Alasan ini berhasil: Pertanyaan yang lebih baik menambahkan persyaratan penghitungan tertentu (waktu yang dihabiskan untuk invoice manual) dan menentukan format output, yaitu ringkasan.
Ajukan pertanyaan multi-bagian untuk analisis yang lebih kompleks
Pecah pertanyaan yang 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 pencairan dana tunai saat pengiriman dan pembayaran untuk setiap jenis piutang (PHA, rabat koperasi, kartu kredit, media retail) dan berapa persentase pencairan dana manual? Dengan asumsi kita menghabiskan waktu 15 menit untuk setiap piutang yang diselesaikan secara manual, berapa banyak waktu yang kita habiskan untuk aplikasi kas dan penyelesaian untuk setiap jenis piutang setiap tahun?"
Pertanyaan yang lebih spesifik, bagian 1: "Berapa rata-rata waktu penyelesaian dalam hari untuk setiap jenis piutang antara 05-05-2025 dan 01-06-2025?"
Pertanyaan yang lebih spesifik, bagian 2: "Berapa persentase penyelesaian manual antara 05-05-2025 dan 01-06-2025 untuk setiap jenis piutang?"
Pertanyaan yang lebih baik, bagian 3: "Dengan asumsi kita menghabiskan waktu 15 menit untuk setiap piutang yang diselesaikan secara manual, berapa banyak waktu yang kita habiskan untuk aplikasi tunai dan penyelesaian untuk setiap jenis piutang setiap tahun?"
Alasan cara ini berhasil: Dengan mengajukan pertanyaan secara terpisah, Conversational Analytics API dapat menangani setiap metrik tertentu (waktu penyelesaian rata-rata, persentase pembersihan manual, total waktu yang dihabiskan) dengan filter yang sesuai, sehingga memberikan hasil yang lebih akurat.
Mengajukan pertanyaan dengan kondisi data
Saat Anda 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, hasil N 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 dengan jelas menentukan rentang tanggal.
"Berikan nama pelanggan, jumlah saldo terutang, usia rata-rata, dan jenis piutang untuk data yang telah melampaui 46 hari. Batasi hasil hingga 5 data berdasarkan saldo terutang." Pertanyaan ini menentukan usia rekaman, memberikan batas, dan memberikan persyaratan pengurutan.
"Berikan industri teratas berdasarkan jumlah selisih dalam saldo piutang pelanggan beserta jumlah untuk 2025FP1 dibandingkan dengan akhir tahun sebelumnya." Pertanyaan ini menentukan "industri teratas" dan periode untuk perbandingan.
Meminta penggabungan data
Saat mengajukan pertanyaan untuk menggabungkan data, tentukan jenis penggabungan ("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, usia rata-rata, dan jenis piutang untuk data yang telah melampaui 46 hari."
Mengajukan pertanyaan lanjutan
Saat mengajukan pertanyaan lanjutan, rujuk konteks yang telah ditetapkan sebelumnya, tetapi jelaskan perubahan atau tambahan secara eksplisit. Misalnya, jika Anda ingin mengubah rentang tanggal atau batas, nyatakan parameter baru dengan jelas.
Contoh
Pertanyaan asli: "Berikan nama pelanggan, jumlah saldo terutang, usia rata-rata, dan jenis piutang untuk catatan yang telah melampaui 46 hari. Batasi hasil hingga 5 data berdasarkan saldo terutang."
Pertanyaan lanjutan: "Berikan metrik sebelumnya untuk data yang berusia lebih dari 90 hari dan batasi hingga 10 data teratas."
Alasan ini berhasil: Pertanyaan lanjutan dengan jelas menentukan perubahan pada filter "melebihi", dan batas hasil, sambil mereferensikan 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:
Mengarahkan 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, usia rata-rata, dan jenis piutang untuk data yang telah melampaui 46 hari."
Mengarahkan 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 diperlukan dalam jam untuk memproses semua invoice manual."
"Berapa total waktu yang diperlukan untuk memproses invoice manual dalam seminggu terakhir?"
Mengarahkan 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:
"Apa tren bulanan saldo akhir untuk setiap industri pada tahun 2024."
"Berapa perubahan delta harian pada usia rata-rata faktur yang belum dibayar untuk hari ini dibandingkan hari sebelumnya antara 02-05-2025 dan 03-06-2025?"
Mengarahkan Conversational Analytics API untuk menampilkan hasil sebagai diagram batang atau perbandingan
Penggunaan istilah utama seperti "bandingkan" dan "perbedaan" 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 selisih 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 tips pemecahan masalah tambahan dan jawaban atas pertanyaan umum (FAQ), lihat halaman Pertanyaan umum (FAQ) tentang Conversational Analytics API.
Untuk mengetahui informasi selengkapnya tentang error API dan kemungkinan solusinya, lihat panduan Memecahkan masalah error Conversational Analytics API.