Dokumentasi

Kesadaran Halaman

Kesadaran Halaman memungkinkan agen AI Anda mengetahui halaman mana yang sedang dilihat pengunjung. Ini memungkinkan jawaban yang lebih relevan dan sadar-konteks serta memberikan konteks yang lebih kaya saat eskalasi ke agen manusia.

Kesadaran Halaman hanya bekerja dengan web widget. Telegram dan channel pesan lainnya tidak memiliki konsep "halaman saat ini".

Ikhtisar#

Ketika diaktifkan, widget secara otomatis mengumpulkan URL halaman saat ini, judul, dan deskripsi dari pengunjung. Konteks ini disuntikkan ke dalam system prompt AI, memungkinkan AI menyesuaikan jawaban berdasarkan tempat pengguna menjelajah.

Konteks Halaman

Agen melihat URL halaman saat ini, judul, dan deskripsi meta

Konteks Eskalasi

Agen manusia menerima info halaman saat ini dari pengunjung saat eskalasi

Cara Kerjanya#

Widget menangkap konteks halaman secara otomatis — tidak diperlukan perubahan kode di situs Anda. Berikut yang dikumpulkan dengan setiap pesan:

DataSumberContoh
URL Halamanwindow.location.hrefhttps://example.com/pricing
Judul Halamandocument.titlePricing — Acme Corp
Pathwindow.location.pathname/pricing
Deskripsimeta[name=description]Bandingkan paket kami
Referrerdocument.referrerhttps://google.com

Contoh: Apa yang dilihat agen#

Ketika pengunjung di /pricing bertanya "Berapa harganya?", system prompt agen menyertakan:

Disuntikkan ke dalam system prompttext
PAGE CONTEXT (di mana pengguna berada saat ini):
- Page: Pricing — Acme Corp
- Path: /pricing
- Description: Bandingkan paket dan harga kami

Gunakan konteks halaman ini untuk memberikan jawaban yang lebih relevan dan spesifik-halaman.

Penyiapan#

Kesadaran Halaman adalah fitur opt-in. Untuk mengaktifkannya:

  1. Buka Channels dan pilih channel Widget Anda
  2. Pada panel pengaturan/appearance channel, aktifkan Page awareness ("Widget memberi tahu agen halaman mana yang sedang dilihat pengunjung")
  3. Simpan perubahan Anda
Tidak diperlukan perubahan pada kode embed widget Anda. Widget secara otomatis mengirim konteks halaman setelah fitur diaktifkan pada agen.

Konteks Eskalasi#

Ketika percakapan dieskalasi ke agen manusia, email notifikasi eskalasi secara otomatis menyertakan konteks halaman saat ini dari pengunjung. Agen manusia melihat persis di mana pengunjung menjelajah tanpa harus bertanya.

Email eskalasi menyertakan:

Email eskalasi

Subject: [YourBrand] Conversation Escalated

Heading: "Case #123 needs a human" (atau "A customer needs a human" jika tidak ada nomor kasus)

Body: "A customer has been transferred to a human agent. Please review and respond." — diikuti blok kutipan dengan pesan terakhir pelanggan dan namanya

Tabel fakta: Channel: Widget · Page: Pricing — Acme Corp · Page URL: https://example.com/pricing

Open conversation — tombol yang menautkan langsung ke percakapan di dashboard

Konteks halaman eskalasi disertakan secara otomatis setiap kali Kesadaran Halaman diaktifkan — tidak ada toggle terpisah.

Pemecahan Masalah#

Jika Kesadaran Halaman tampaknya tidak bekerja, periksa hal berikut:

Agen memberikan jawaban umum, mengabaikan halaman saat ini

Pastikan Page awareness diaktifkan untuk channel Widget Anda (Channels → Widget → panel pengaturan/appearance) dan perubahan telah disimpan. Fitur ini dinonaktifkan secara default.

Email eskalasi tidak memiliki bagian konteks halaman

Pastikan Page awareness diaktifkan pada channel Widget Anda dan disimpan. Konfirmasikan juga toggle Escalation alerts diaktifkan di pengaturan agen (nonaktif secara default). Email peringatan dikirim ke anggota tim workspace Anda — anggota tim yang ditugaskan atau tim penugasan — berdasarkan preferensi notifikasi masing-masing anggota tim; tidak ada alamat email eskalasi terpisah untuk dikonfigurasi.

Judul halaman menampilkan nilai yang salah

Widget membaca document.title pada saat pengguna mengirim pesan. Jika situs Anda memperbarui judul setelah render awal (misalnya async), widget menangkap apa pun yang disetel pada saat pengiriman.