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 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 permintaan deteksi intent.
- Dialogflow mengirimkan pesan respons deteksi intent ke layanan Anda. Pesan ini berisi informasi tentang intent yang cocok, tindakan, parameter, dan respons yang ditentukan untuk intent.
- 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 harus menyiapkan project GCP dan autentikasi. Anda dapat mengikuti langkah-langkah di Panduan memulai penyiapan.
Pembuatan agen
Dalam sebagian besar kasus, Anda harus menggunakan konsol Dialogflow ES (kunjungi dokumentasi, buka konsol) untuk membuat 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 yang berfokus pada penggunaan konsol untuk membuat 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 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 giliran percakapan. Setelah percakapan berakhir, Anda berhenti menggunakan sesi tersebut.
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 dibuat oleh sistem Anda. Anda membuat sesi baru dengan memberikan ID sesi baru dalam a permintaan deteksi intent. ID sesi adalah string dengan ukuran maksimal 36 byte. Sistem Anda bertanggung jawab untuk membuat ID sesi unik. ID sesi 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.
Layanan Anda melakukan tindakan sesuai kebutuhan
(misalnya, kueri database atau panggilan API eksternal)
dan mengirimkan pesan kepada pengguna akhir.
Proses ini berlanjut hingga percakapan berakhir.
Anda dapat menemukan contoh panggilan deteksi intent di halaman panduan memulai API dan halaman panduan.