Kontext uživatele

Předejte informace o uživateli pro personalizaci AI konverzací

Konfigurace uživatelského kontextu
Plány Standard a Pro

Přehled

Uživatelský kontext vám umožňuje předávat informace o přihlášených uživatelích umělé inteligenci. Když poskytnete uživatelský kontext, AI může pozdravit uživatele jménem, odkazovat na podrobnosti jejich účtu a poskytovat personalizované odpovědi, aniž by se ptala na informace, které již máte.

Tím se vytvoří plynulý zážitek, kdy AI již "ví" o uživateli – o jeho předplatném, stavu objednávky, věrnostních bodech nebo jakýchkoli dalších relevantních datech, která se rozhodnete sdílet.

Jak to funguje

  1. Enable User Context in your dashboard settings
  2. Add JavaScript to your website that sets user data
  3. AI obdrží kontext s každou zprávou, kterou uživatel odešle
  4. AI personalizuje odpovědi pomocí poskytnutých informací
AI asistent
Kde je moje objednávka?
Ahoj Sarah! Právě jsem zkontroloval vaši objednávku #8847 – je na cestě s FedEx a měla by dorazit dnes do 17:00.
Mohu upgradovat svůj plán?
Samozřejmě! Momentálně jste na plánu Basic s 847 zbývajícími API voláními. Mohu vám pomocí s upgradem na Pro pro další funkce a vyšší limity.

Implementace

Vyberte přístup, který vyhovuje vašemu nastavení:

Vypište uživatelská data přímo ze šablony na straně serveru:

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

Nastavte kontext po tom, co vaše aplikace načte uživatelská data:

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

Nejlepší pro výkon: Widget detekuje fetchUserContext a zavolá ji automaticky při otevření chatu, takže data se načtou pouze v případě potřeby.

Rozhodujete se, co sdílet. Předávejte pouze data relevantní pro váš případ použití – jméno zákazníka, stav objednávky, úroveň předplatného, obsah košíku nebo jakékoli další informace, které pomohou AI lépe pomáhat vašim uživatelům. Používejte popisné štítky, aby AI rozuměla kontextu.

Příklady použití

E-commerce

"Vidím, že vaše objednávka #4521 je momentálně na cestě a měla by dorazit do pátku."

SaaS

"Na vašem plánu Pro vám tento měsíc zbývá 847 API volání."

Podpora

"Vidím, že jste Gold člen se 3 otevřenými tikety. Jak vám mohu pomoci?"

Vzdělávání

"Máte dokončeno 78 % kurzu JavaScript. Jste připraveni začít modul 8?"

Pohostinství

"Vaše rezervace na 17. září je potvrzena. Check-in začíná ve 15:00."

Zdravotnictví

"Vaše příští schůzka s Dr. Smith je naplánována na úterý v 10:00."

Důležité poznámky

Volitelné - Chat funguje perfektně i bez uživatelského kontextu. Jedná se o vylepšení pro přihlášené uživatele.
V reálném čase - Kontext se odesílá s každou zprávou, takže jej můžete dynamicky aktualizovat při změně uživatelských dat.
Zabezpečení - Nikdy nezahrnujte hesla, čísla kreditních karet ani jiná citlivá data. Předávejte pouze necitlivé informace.
Limity velikosti - Uživatelský kontext je omezen na 2 000 znaků na plánu Standard a 10 000 znaků na plánu Pro. Při překročení bude zkrácen. Udržujte svůj kontext stručný.

Stav integrace

Po implementaci navštivte stránku nastavení uživatelského kontextu a ověřte, že vaše integrace funguje. Stavová karta zobrazí:

  • Zda je kontext přijímán
  • Pošlední zpráva s kontextem
  • Náhled odesílaných kontextových dat