用户上下文

传递用户信息以个性化 AI 对话

配置用户上下文

标准版和专业版套餐

概述

用户上下文允许您将已登录用户的信息传递给 AI。当您提供用户上下文时，AI 可以按姓名问候用户、引用其账户详情，并提供个性化回复，而无需再次询问您已有的信息。

这将创造一种无缝体验，让 AI 已经"了解"用户的信息——他们的订阅计划、订单状态、积分或您选择分享的任何其他相关数据。

工作原理

在仪表板设置中启用用户上下文
在您的网站上添加 JavaScript 来设置用户数据
AI 接收上下文——随用户发送的每条消息一起
AI 个性化回复——利用提供的信息

AI 助手

我的订单在哪里？

您好 Sarah！我刚查了您的订单 #8847——已由 FedEx 派送，预计今天下午 5 点前送达。

我可以升级套餐吗？

当然可以！您目前使用的是 Basic 套餐，还剩 847 次 API 调用。我可以帮您升级到 Pro 套餐，获得更多功能和更高的限额。

实现方式

选择适合您的实现方式：

直接从服务端模板输出用户数据：

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

在应用加载用户数据后设置上下文：

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

仅在聊天打开时获取用户数据（最佳性能）：

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

最佳性能方案： 小组件会检测 fetchUserContext 并在聊天打开时自动调用它，因此数据仅在需要时才会加载。

由您决定共享哪些信息。 仅传递与您的使用场景相关的数据——客户姓名、订单状态、订阅级别、购物车内容或任何有助于 AI 更好地服务用户的信息。使用描述性标签以便 AI 理解上下文。

示例用例

电子商务

"我可以看到您的订单 #4521 目前正在运输中，预计周五送达。"

SaaS

"您本月 Pro 套餐还剩 847 次 API 调用。"

支持

"我看到您是金牌会员，有 3 个待处理工单。有什么可以帮您的吗？"

教育

"您已完成 JavaScript 课程的 78%。准备好开始第 8 单元了吗？"

酒店餐饮

"您 9 月 17 日的预订已确认。下午 3 点开始办理入住。"

医疗保健

"您与 Smith 医生的下次预约安排在周二上午 10 点。"

重要提示

可选 - 聊天功能在没有用户上下文的情况下也能正常工作。这是针对已登录用户的增强功能。

实时 - 上下文随每条消息一起发送，因此您可以在用户数据变化时动态更新。

安全 - 切勿包含密码、信用卡号或其他敏感数据。仅传递非敏感信息。

大小限制 - 用户上下文在 Standard 套餐中限制为 2,000 个字符，Pro 套餐中为 10,000 个字符。超出限制将被截断。请保持上下文简洁。

集成状态

实施完成后，请访问用户上下文设置页面以验证您的集成是否正常工作。状态卡片将显示：

是否正在接收上下文
包含上下文的最新消息
正在发送的上下文数据预览

文档