Quay lại bảng điều khiển

Tài liệu

Tìm hiểu cách sử dụng Asyntai

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

Cấu hình ngữ cảnh người dùng
Gói Standard & Pro

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

  1. Enable User Context in your dashboard settings
  2. Add JavaScript to your website that sets user data
  3. AI nhận ngữ cảnh với mỗi tin nhắn người dùng gửi
  4. 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 — đang được giao bởi FedEx và sẽ đến hôm nay trước 5 giờ chiều.
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;

Lấy dữ liệu người dùng chỉ khi trò chuyện mở (tốt nhất cho hiệu suất):

// 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 - tên khách hàng, trạng thái đơn hàng, cấp đă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. Sử dụng nhãn mô tả để 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ợ

"I see you're a Gold member with 3 open tickets. How can I help?"

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

"Your booking for September 17th is confirmed. Check-in starts at 3 PM."

Y tế

"Lịch hẹn tiếp theo với Bác sĩ Smith được lên lịch 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.

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

Sau khi triển khai, truy cập trang cài đặt Ngữ cảnh người dùng để xác minh tích hợp đang hoạt động. Thẻ trạng thái sẽ hiển thị:

  • 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