Sesi mewakili percakapan antara agen Agen Percakapan (Dialogflow CX) dan pengguna akhir. Anda membuat sesi di awal percakapan dan menggunakannya untuk setiap giliran percakapan. Setelah percakapan berakhir, Anda tidak akan lagi menggunakan sesi.
Anda tidak boleh menggunakan sesi yang sama untuk percakapan serentak dengan pengguna akhir yang berbeda. Sesi tetap aktif dan datanya disimpan selama 30 menit setelah permintaan terakhir dikirim untuk sesi tersebut.
Setiap sesi ditentukan secara unik oleh ID sesi yang dihasilkan oleh sistem Anda. Anda membuat sesi baru dengan memberikan ID sesi baru dalam permintaan intent deteksi dan metode sesi lainnya. ID sesi adalah string dengan ukuran maksimal 36 byte. Sistem Anda bertanggung jawab untuk membuat ID sesi unik. ID ini dapat berupa angka acak, ID pengguna akhir yang di-hash, atau nilai lain yang mudah Anda buat.
Periksa dokumentasi Regionalisasi untuk mengetahui informasi tentang nilai ID Lokasi dalam nama sesi.
Sesi yang tahan lama
Secara default, Agen Percakapan (Dialogflow CX) mempertahankan data sesi selama 30 menit. Ada dua cara untuk memperpanjang masa aktif sesi:
- (Direkomendasikan) Tetapkan TTL sesi menggunakan
QueryParameters.session_ttl
. Nilai maksimum yang diizinkan adalah 24 jam. Anda dapat menghidupkan kembali status sesi sebelumnya dengan menetapkan
QueryParameters.current_page
danQueryParameters.parameters
diDetectIntentRequest
.Contoh alur kerja terlihat seperti:
- Pengguna akhir berbicara dengan agen dalam sesi A.
- Kode Anda mencatat status yang terkait dengan sesi A yang ditampilkan dalam respons API, yaitu
QueryResult.current_page
danQueryResult.parameters
. - Pengguna akhir berhenti berinteraksi dengan agen setelah 50 menit.
- Pengguna akhir berbicara lagi dengan agen.
- Kode Anda mengirimkan input pengguna akhir, bersama dengan
QueryParameters.current_page
danQueryParameters.parameters
yang direkam sebelumnya dalam permintaan, untuk mendeteksi intent dengan status sesi sebelumnya. Anda tidak perlu menggunakan ID sesi yang sama dengan yang digunakan oleh sesi A.
Referensi
Untuk mengetahui informasi tentang harga sesi, lihat halaman harga.
Untuk informasi selengkapnya tentang sesi:
Pilih protokol dan versi untuk referensi Sesi:
Protokol | V3 | V3beta1 |
---|---|---|
REST | Resource sesi | Resource sesi |
RPC | Antarmuka sesi | Antarmuka sesi |
C++ | SessionsClient | Tidak tersedia |
C# | SessionsClient | Tidak tersedia |
Go | SessionsClient | Tidak tersedia |
Java | SessionsClient | SessionsClient |
Node.js | SessionsClient | SessionsClient |
PHP | Tidak tersedia | Tidak tersedia |
Python | SessionsClient | SessionsClient |
Ruby | Tidak tersedia | Tidak tersedia |