Jika 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 mengirim ekspresi pengguna akhir dan menerima kecocokan intent. Diagram berikut menunjukkan alur pemrosesan saat berinteraksi dengan API.
- Pengguna akhir mengetik atau mengucapkan ekspresi.
- Layanan Anda mengirimkan ekspresi pengguna akhir ini ke Dialogflow dalam pesan deteksi permintaan intent.
- Dialogflow akan mengirimkan pesan respons intent deteksi ke layanan Anda. Pesan ini berisi informasi tentang intent yang cocok, tindakan, parameter, dan respons yang ditentukan untuk intent 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 responsnya.
Penyiapan dan autentikasi project
Sebelum memanggil API, Anda perlu menyiapkan project dan autentikasi GCP. Anda dapat mengikuti langkah-langkah di Panduan memulai penyiapan.
Pembuatan agen
Umumnya, Anda harus menggunakan Konsol Dialogflow ES (buka 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 membangun agen untuk skenario lanjutan. Banyak halaman konsep yang berfokus pada penggunaan konsol untuk membangun agen, tetapi halaman tersebut 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 tentang 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 pergantian percakapan. Setelah percakapan berakhir, Anda akan berhenti menggunakan sesi.
Anda tidak boleh menggunakan sesi yang sama untuk percakapan serentak dengan pengguna akhir yang berbeda. Dialogflow mempertahankan konteks aktif yang saat ini aktif untuk setiap sesi yang aktif. Data sesi disimpan oleh Dialogflow selama 20 menit.
Setiap sesi ditentukan secara unik oleh ID sesi yang dibuat oleh sistem Anda. Anda membuat sesi baru dengan memberikan ID sesi baru dalam permintaan intent deteksi. ID sesi adalah string yang berukuran maksimal 36 byte. Sistem Anda bertanggung jawab untuk membuat ID sesi yang unik. Parameter ini dapat berupa angka acak, ID pengguna akhir yang di-hash, atau nilai lain yang mudah Anda buat.
Mendeteksi intent
Ketika Anda menggunakan API untuk interaksi, layanan Anda berinteraksi secara 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 akan 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 mengirimkan pesan ke pengguna akhir.
Proses ini berlanjut hingga percakapan berakhir.
Anda dapat menemukan contoh intent deteksi panggilan di halaman panduan memulai API dan halaman petunjuk.