Jika Anda tidak menggunakan salah satu opsi integrasi, Anda harus menulis kode yang berinteraksi langsung dengan pengguna akhir. Anda juga harus berinteraksi langsung dengan API Dialogflow untuk setiap giliran percakapan guna mengirimkan ekspresi pengguna akhir dan menerima kecocokan maksud. Diagram berikut menunjukkan alur pemrosesan saat berinteraksi dengan API.
- Pengguna mengetik atau mengucapkan ekspresi.
- Layanan Anda mengirimkan ekspresi pengguna akhir ini ke Dialogflow dalam pesan permintaan deteksi maksud.
- Dialogflow mengirimkan pesan respons deteksi intent ke layanan Anda. Pesan ini berisi informasi tentang maksud yang cocok, tindakan, parameter, dan respons yang ditentukan untuk maksud tersebut.
- Layanan Anda melakukan tindakan sesuai kebutuhan, seperti kueri database atau panggilan API eksternal.
- Layanan Anda mengirimkan respons kepada pengguna akhir.
- Pengguna akhir melihat atau mendengar respons.
Penyiapan dan autentikasi project
Sebelum memanggil API, Anda perlu menyiapkan project dan autentikasi GCP. Anda dapat mengikuti langkah-langkah di Mulai cepat penyiapan.
Pembuatan agen
Dalam sebagian besar kasus, Anda harus menggunakan konsol Dialogflow ES (kunjungi dokumentasi, buka konsol) untuk membangun agen. Anda dapat mengikuti langkah-langkah di halaman panduan memulai konsol untuk membuat agen. Anda juga dapat menggunakan Dialogflow API untuk membuat agen untuk skenario lanjutan. Banyak halaman konsep berfokus pada penggunaan konsol untuk membangun agen, tetapi juga menyediakan link ke jenis API yang relevan.
REST, gRPC, dan library klien
Anda dapat mengakses Dialogflow API melalui REST, gRPC, atau salah satu library klien yang disediakan. Untuk mengetahui detail opsi ini, lihat Ringkasan penggunaan API.
Sesi
Sesi mewakili percakapan antara agen Dialogflow dan pengguna akhir. Anda membuat sesi di awal percakapan dan menggunakannya untuk setiap giliran percakapan. Setelah percakapan berakhir, Anda berhenti menggunakan sesi.
Anda tidak boleh menggunakan sesi yang sama untuk percakapan serentak dengan pengguna akhir yang berbeda. Dialogflow mempertahankan konteks yang saat ini aktif untuk setiap sesi aktif. Data sesi disimpan oleh Dialogflow selama 20 menit.
Setiap sesi ditentukan unik oleh ID sesi yang dihasilkan oleh sistem Anda. Anda membuat sesi baru dengan memberikan ID sesi baru dalam permintaan deteksi niat. ID sesi adalah string berukuran maksimal 36 byte. Sistem Anda bertanggung jawab untuk membuat ID sesi unik. Nilai ini dapat berupa angka acak, ID pengguna akhir yang di-hash, atau nilai lain yang mudah Anda buat.
Mendeteksi intent
Saat Anda menggunakan API untuk interaksi,
layanan Anda berinteraksi langsung dengan pengguna akhir.
Untuk setiap giliran percakapan,
layanan Anda mengirimkan ekspresi pengguna akhir ke Dialogflow dengan memanggil metode
detectIntent atau streamingDetectIntent dari jenis
Sessions.
Dialogflow merespons dengan informasi tentang intent yang cocok,
tindakan, parameter, dan respons yang ditentukan untuk intent tersebut.
Layanan Anda melakukan tindakan sesuai kebutuhan
(misalnya, kueri database atau panggilan API eksternal)
dan mengirim pesan kepada pengguna akhir.
Proses ini berlanjut hingga percakapan berakhir.
Anda dapat menemukan contoh pemanggilan deteksi maksud di halaman panduan memulai API dan halaman cara penggunaan.