Ngữ cảnh người dùng

Truyền thông tin người dùng để cá nhân hóa hội thoại AI

Gói Standard, Pro và Enterprise

Tổng quan

Ngữ cảnh người dùng cho phép bạn truyền thông tin về người dùng đã đăng nhập cho AI. Khi cung cấp ngữ cảnh người dùng, AI có thể chào người dùng bằng tên, tham chiếu chi tiết tài khoản và cung cấp phản hồi được cá nhân hóa mà không cần hỏi thông tin bạn đã có.

Điều này tạo trải nghiệm liền mạch nơi AI đã "biết" về người dùng - gói đăng ký, trạng thái đơn hàng, điểm tích lũy hoặc bất kỳ dữ liệu liên quan nào bạn chọn chia sẻ.

Cách hoạt động

Bật Ngữ cảnh người dùng trong cài đặt bảng điều khiển của bạn
Thêm JavaScript vào trang web của bạn để thiết lập dữ liệu người dùng
AI nhận ngữ cảnh với mỗi tin nhắn người dùng gửi
AI cá nhân hóa phản hồi sử dụng thông tin được cung cấp

Trợ lý AI

Đơn hàng của tôi ở đâu?

Chào Sarah! Tôi vừa kiểm tra đơn hàng #8847 của bạn — đơn hàng đang được FedEx giao và sẽ đến trước 5 giờ chiều hôm nay.

Tôi có thể nâng cấp gói không?

Tất nhiên! Bạn hiện đang dùng gói Basic với 847 lượt gọi API còn lại. Tôi có thể giúp bạn nâng cấp lên Pro để có thêm tính năng và giới hạn cao hơn.

Triển khai

Chọn phương pháp phù hợp với thiết lập của bạn:

Xuất dữ liệu người dùng trực tiếp từ mẫu phía máy chủ:

<!-- 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>

Đặt ngữ cảnh sau khi ứng dụng tải dữ liệu người dùng:

// 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;

Chỉ lấy dữ liệu người dùng khi khung chat mở (tốt nhất cho hiệu năng):

// 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

Tốt nhất cho hiệu suất: Widget phát hiện fetchUserContext và gọi tự động khi trò chuyện mở, nên dữ liệu chỉ được tải khi cần.

Bạn quyết định chia sẻ những gì. Chỉ truyền dữ liệu liên quan đến trường hợp sử dụng của bạn - tên khách hàng, trạng thái đơn hàng, gói đăng ký, nội dung giỏ hàng hoặc bất kỳ thông tin nào giúp AI hỗ trợ người dùng tốt hơn. Dùng nhãn mô tả rõ ràng để AI hiểu ngữ cảnh.

Ví dụ các trường hợp sử dụng

Thương mại điện tử

"Tôi thấy đơn hàng #4521 của bạn hiện đang trên đường vận chuyển và sẽ đến vào thứ Sáu."

SaaS

"Bạn còn 847 lượt gọi API tháng này trên gói Pro."

Hỗ trợ

"Tôi thấy bạn là thành viên Gold với 3 phiếu hỗ trợ đang mở. Tôi có thể giúp gì cho bạn?"

Giáo dục

"Bạn đã hoàn thành 78% khóa học JavaScript. Sẵn sàng bắt đầu Module 8 chưa?"

Khách sạn

"Lượt đặt phòng của bạn ngày 17 tháng 9 đã được xác nhận. Giờ nhận phòng bắt đầu lúc 3 giờ chiều."

Y tế

"Lịch hẹn tiếp theo của bạn với Bác sĩ Smith là vào thứ Ba lúc 10 giờ sáng."

Lưu ý quan trọng

Tùy chọn - Trò chuyện hoạt động hoàn hảo mà không cần ngữ cảnh người dùng. Đây là cải tiến cho người dùng đã đăng nhập.

Thời gian thực - Ngữ cảnh được gửi với mỗi tin nhắn, nên bạn có thể cập nhật động khi dữ liệu người dùng thay đổi.

Bảo mật - Không bao giờ bao gồm mật khẩu, số thẻ tín dụng hoặc dữ liệu nhạy cảm khác. Chỉ truyền thông tin không nhạy cảm.

Giới hạn kích thước - Ngữ cảnh người dùng giới hạn 2.000 ký tự trên Standard và 10.000 ký tự trên Pro. Nếu vượt quá, sẽ bị cắt bớt cho vừa. Giữ ngữ cảnh ngắn gọn.

Không phải là kiểm soát truy cập - 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.

Trạng thái tích hợp

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

Ngữ cảnh có được nhận hay không
Tin nhắn mới nhất có ngữ cảnh
Xem trước dữ liệu ngữ cảnh đang được gửi

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

Tài liệu