ユーザー情報を渡してAIの会話をパーソナライズします
ユーザーコンテキストを使うと、ログイン中のユーザーに関する情報をAIに渡すことができます。ユーザーコンテキストを提供すると、AIはユーザーを名前で挨拶し、アカウントの詳細を参照し、すでにお持ちの情報を尋ねることなくパーソナライズされた応答を提供できます。
これにより、AIがユーザーについてすでに「知っている」シームレスな体験が生まれます。サブスクリプションプラン、注文状況、ポイント、その他の共有を選択した関連データなどです。
お使いの環境に合ったアプローチをお選びください：
サーバーサイドテンプレートからユーザーデータを直接出力します：
<!-- 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;
Fetch user data only when the chat opens (best for performance):
// 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は現在配送中で、金曜日までに届く予定です。"
"今月のProプランでAPIコールが847回残っています。"
"I see you're a Gold member with 3 open tickets. How can I help?"
"You're 78% through the JavaScript course. Ready to start Module 8?"
"9月17日のご予約が確認されました。チェックインは午後3時からです。"
"Dr. Smithとの次のご予約は火曜日の午前10時に予定されています。"
実装後、ユーザーコンテキスト設定ページにアクセスして連携が正しく動作しているか確認してください。ステータスカードには以下が表示されます：