Konteks Pengguna

Hantar maklumat pengguna untuk memperibadikan perbualan AI

Pelan Standard, Pro dan Enterprise

Gambaran Keseluruhan

Konteks Pengguna membolehkan anda menghantar maklumat tentang pengguna yang telah log masuk kepada AI. Apabila anda menyediakan konteks pengguna, AI boleh menyapa pengguna dengan nama, merujuk butiran akaun mereka, dan memberikan respons yang diperibadikan tanpa meminta maklumat yang anda sudah ada.

Ini mencipta pengalaman yang lancar di mana AI sudah "mengetahui" tentang pengguna - pelan langganan mereka, status pesanan, mata kesetiaan, atau sebarang data berkaitan lain yang anda pilih untuk dikongsi.

Cara Ia Berfungsi

Aktifkan Konteks Pengguna dalam tetapan papan pemuka anda
Tambah JavaScript ke laman web anda yang menetapkan data pengguna
AI menerima konteks dengan setiap mesej yang dihantar pengguna
AI memperibadikan respons menggunakan maklumat yang diberikan

Pembantu AI

Di manakah pesanan saya?

Hai Sarah! Saya baru menyemak pesanan anda #8847 — ia sedang dalam penghantaran dengan FedEx dan dijangka tiba hari ini sebelum 5 petang.

Bolehkah saya naik taraf pelan saya?

Sudah tentu! Anda kini berada pada pelan Basic dengan 847 panggilan API yang tinggal. Saya boleh membantu anda naik taraf ke Pro untuk ciri tambahan dan had yang lebih tinggi.

Pelaksanaan

Pilih pendekatan yang sesuai dengan persediaan anda:

Keluarkan data pengguna terus dari templat bahagian pelayan anda:

<!-- After your Asyntai widget script -->
<script>
window.Asyntai = window.Asyntai || {};
window.Asyntai.userContext = {
    "Customer name": "<?php echo $user->name; ?>",
    "Email": "<?php echo $user->email; ?>",
    "Subscription plan": "<?php echo $user->plan; ?>",
    "Order status": "<?php echo $user->latest_order_status; ?>"
};
</script>

Tetapkan konteks selepas aplikasi anda memuatkan data pengguna:

// After user logs in or data loads
window.Asyntai = window.Asyntai || {};
window.Asyntai.userContext = {
    "Customer name": currentUser.name,
    "Email": currentUser.email,
    "Subscription plan": currentUser.subscription.planName,
    "Cart total": cart.total,
    "Loyalty points": currentUser.loyaltyPoints
};

// You can update it anytime - changes apply to the next message
window.Asyntai.userContext["Cart total"] = newTotal;

Ambil data pengguna hanya apabila sembang dibuka (terbaik untuk prestasi):

// Define a function to fetch user context
window.Asyntai = window.Asyntai || {};
window.Asyntai.fetchUserContext = function() {
    return fetch('/api/your-user-context-endpoint/')
        .then(function(response) { return response.json(); })
        .then(function(data) {
            window.Asyntai.userContext = data;
        });
};

// The widget automatically calls this when the chat opens

Terbaik untuk prestasi: Widget mengesan fetchUserContext dan memanggilnya secara automatik apabila sembang dibuka, jadi data hanya dimuatkan apabila diperlukan.

Anda memutuskan apa yang hendak dikongsi. Hantar hanya data yang berkaitan dengan kes penggunaan anda - nama pelanggan, status pesanan, peringkat langganan, kandungan troli, atau sebarang maklumat lain yang membantu AI membantu pengguna anda dengan lebih baik. Gunakan label deskriptif supaya AI memahami konteks.

Contoh Kes Penggunaan

E-dagang

"Saya dapat melihat pesanan anda #4521 sedang dalam transit dan dijangka tiba menjelang hari Jumaat."

SaaS

"Anda mempunyai 847 panggilan API yang tinggal bulan ini pada pelan Pro anda."

Sokongan

"Saya nampak anda ahli Gold dengan 3 tiket terbuka. Bagaimana saya boleh membantu?"

Pendidikan

"Anda telah 78% melalui kursus JavaScript. Bersedia untuk memulakan Modul 8?"

Hospitaliti

"Tempahan anda untuk 17 September telah disahkan. Daftar masuk bermula pada jam 3 petang."

Penjagaan Kesihatan

"Temu janji seterusnya anda dengan Dr. Smith dijadualkan pada hari Selasa jam 10 pagi."

Nota Penting

Pilihan - Sembang berfungsi dengan sempurna tanpa konteks pengguna. Ia adalah peningkatan untuk pengguna yang telah log masuk.

Masa nyata - Konteks dihantar dengan setiap mesej, jadi anda boleh mengemas kininya secara dinamik apabila data pengguna berubah.

Keselamatan - Jangan sekali-kali memasukkan kata laluan, nombor kad kredit, atau data sensitif lain. Hanya hantar maklumat yang tidak sensitif.

Had Saiz - Konteks pengguna dihadkan kepada 2,000 aksara pada Standard dan 10,000 aksara pada Pro. Jika melebihi had, ia akan dipotong untuk dimuat. Pastikan konteks anda ringkas.

Bukan kawalan akses - User context is set by your page in the visitor's browser, so it must never be what stands between a visitor and restricted content. To restrict which knowledge items a visitor can retrieve at all, use Access Tags (Enterprise) — enforced on our servers with a claim signed by your own back end.

Status Integrasi

After implementing, visit the User Context settings page to verify your integration is working. The status card will show:

Sama ada konteks sedang diterima
Mesej terkini dengan konteks
Pratonton data konteks yang dihantar

Platform Guides

Using a specific CMS or e-commerce platform? We have step-by-step setup instructions for each — pick yours below to jump straight to the guide.

Custom / Other Shopify WooCommerce BigCommerce Ecwid OpenCart Magento PrestaShop Odoo WordPress Drupal Joomla Ghost Wix Squarespace Webflow Bubble

Dokumentasi