ユーザーコンテキスト

ユーザー情報を渡してAIの会話をパーソナライズします

Standard・Pro・Enterprise プラン

概要

ユーザーコンテキストを使うと、ログイン中のユーザーに関する情報をAIに渡すことができます。ユーザーコンテキストを提供すると、AIはユーザーを名前で挨拶し、アカウントの詳細を参照し、すでにお持ちの情報を尋ねることなくパーソナライズされた応答を提供できます。

これにより、AIがユーザーについてすでに「知っている」シームレスな体験が生まれます。サブスクリプションプラン、注文状況、ポイント、その他の共有を選択した関連データなどです。

仕組み

ダッシュボードの設定でユーザーコンテキストを有効化します
ユーザーデータを設定するJavaScriptを追加します
ユーザーがメッセージを送信するたびにAIがコンテキストを受信します
提供された情報を使ってAIが応答をパーソナライズします

AIアシスタント

注文状況を教えてください

Sarahさん、こんにちは！注文 #8847を確認しました。FedExで配送中で、本日午後5時までに届く予定です。

プランをアップグレードできますか？

もちろんです！現在Basicプランをご利用で、APIコールが847回残っています。追加機能とより高い制限のために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がコンテキストを理解できるように、わかりやすいラベルを使用してください。

活用例

Eコマース

"注文 #4521は現在配送中で、金曜日までに届く予定です。"

SaaS

"今月のProプランでAPIコールが847回残っています。"

サポート

"ゴールドメンバーで3件の未対応チケットがありますね。どのようにお手伝いできますか？"

教育

"You're 78% through the JavaScript course. Ready to start Module 8?"

ホスピタリティ

"9月17日のご予約が確認されました。チェックインは午後3時からです。"

ヘルスケア

"Smith先生との次のご予約は火曜日の午前10時に予定されています。"

重要な注意事項

オプション - チャットはユーザーコンテキストなしでも完全に動作します。これはログインユーザー向けの機能強化です。

リアルタイム - コンテキストは各メッセージとともに送信されるため、ユーザーデータの変更に応じて動的に更新できます。

セキュリティ - パスワード、クレジットカード番号、その他の機密データは絶対に含めないでください。機密でない情報のみを渡してください。

サイズ制限 - ユーザーコンテキストはStandardで2,000文字、Proで10,000文字に制限されています。超過した場合は切り捨てられます。コンテキストは簡潔に保ってください。

アクセス制御ではありません - 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.

連携ステータス

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

コンテキストが受信されているかどうか
コンテキスト付きの最新メッセージ
送信されているコンテキストデータのプレビュー

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

ドキュメント