Späť na panel

Dokumentácia

Naučte sa používať Asyntai

Kontext používateľa

Odovzdajte informácie o používateľovi na personalizáciu AI konverzácií

Konfigurovať kontext používateľa
Tarify Standard, Pro a Enterprise

Prehľad

Kontext pouzivatela vam umoznuje odovzdat informacie o prihlasenych pouzivateloch AI. Ked poskytnete kontext pouzivatela, AI moze pozdravit pouzivatelov menom, odkazovat na ich udaje o ucte a poskytovat personalizovane odpovede bez toho, aby sa pytala na informacie, ktore uz mate.

Toto vytvara bezproblomovy zazitok, kde AI uz "pozna" pouzivatela - ich predplatitelsky plan, stav objednavky, vernostne body alebo akekolvek ine relevantne udaje, ktore sa rozhodnete zdielat.

Ako to funguje

  1. Povoliť kontext používateľa v nastaveniach vášho panela
  2. Pridajte JavaScript na svoju webovú stránku, ktorý nastavuje údaje používateľa
  3. AI prijima kontext s kazdou spravou, ktoru pouzivatel posle
  4. AI personalizuje odpovede pomocou poskytnutych informacii
AI asistent
Kde je moja objednávka?
Ahoj Sarah! Prave som skontrolovala vasu objednavku #8847 — je na ceste s FedEx a mala by dorazit dnes do 17:00.
Môžem si zvýšiť plán?
Samozrejme! Momentalne ste na plane Basic s 847 zostavajucimi API volaniami. Mozem vam pomoct prejst na Pro pre dalsie funkcie a vyssie limity.

Implementácia

Vyberte si prístup, ktorý vyhovuje vášmu nastaveniu:

Vypíšte údaje používateľa priamo z vašej serverovej šablóny:

<!-- 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, čo vaša aplikácia načíta údaje používateľa:

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

Načítajte údaje používateľa až keď sa chat otvorí (najlepšie pre výkon):

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

Najlepšie pre výkon: Widget detekuje fetchUserContext a zavola ho automaticky pri otvoreni chatu, takze udaje sa nacitaju az ked su potrebne.

Vy rozhodujete, čo budete zdieľať. Odovzdajte iba udaje relevantne pre vas pripad pouzitia - meno zakaznika, stav objednavky, uroven predplatneho, obsah kosika alebo akekolvek ine informacie, ktore pomozu AI lepsie obsluzit vasich pouzivatelov. Pouzite popisne oznacenia, aby AI rozumela kontextu.

Príklady použitia

E-commerce

"Vidim, ze vasa objednavka #4521 je momentalne na ceste a mala by dorazit do piatku."

SaaS

"Tento mesiac vám na pláne Pro zostáva 847 API volaní."

Podpora

"Vidím, že ste zlatý člen s 3 otvorenými tiketmi. Ako vám môžem pomôcť?"

Vzdelávanie

"Máte dokončených 78% kurzu JavaScriptu. Ste pripravení začať Modul 8?"

Hotelierstvo

"Vaša rezervácia na 17. septembra je potvrdená. Check-in začína o 15:00."

Zdravotníctvo

"Vaša ďalšia návšteva u Dr. Smitha je naplánovaná na utorok o 10:00."

Dôležité poznámky

Voliteľné - Chat funguje perfektne aj bez kontextu pouzivatela. Je to vylepsenie pre prihlasenych pouzivatelov.
V reálnom čase - Kontext sa odosiela s kazdou spravou, takze ho mozete dynamicky aktualizovat, ked sa zmenia udaje pouzivatela.
Bezpečnosť - Nikdy nezahrnajte hesla, cisla kreditnych kariet ani ine citlive udaje. Odovzdavajte iba necitlive informacie.
Limity veľkosti - Kontext pouzivatela je obmedzeny na 2 000 znakov na Standard a 10 000 znakov na Pro. Ak sa prekroci, bude skrateny. Udrzujte svoj kontext strucny.
Nie je to riadenie prístupu - 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.

Stav integrácie

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

  • Či sa kontext prijíma
  • Posledná správa s kontextom
  • Náhľad odosielaných kontextových údajov

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.