Nazaj na nadzorno ploščo

Dokumentacija

Naučite se uporabljati Asyntai

Kontekst uporabnika

Posredujte uporabniške podatke za personalizacijo AI pogovorov

Konfigurirajte uporabniški kontekst
Načrta Standard in Pro

Pregled

Uporabniški kontekst vam omogoča, da posredujete podatke o prijavljenih uporabnikih AI-ju. Ko zagotovite uporabniški kontekst, lahko AI pozdravi uporabnike po imenu, se sklicuje na podrobnosti njihovega računa in zagotavlja personalizirane odgovore, ne da bi spraševal za informacije, ki jih že imate.

To ustvari brezhibno izkušnjo, kjer AI že "ve" o uporabniku - njihov naročniški načrt, status naročila, točke zvestobe ali kateri koli drugi ustrezni podatki, ki jih izberete za deljenje.

Kako deluje

  1. Enable User Context in your dashboard settings
  2. Add JavaScript to your website that sets user data
  3. AI prejme kontekst z vsakim sporočilom, ki ga uporabnik pošlje
  4. AI personalizira odgovore z uporabo zagotovljenih informacij
Pomočnik UI
Kje je moje naročilo?
Živjo, Sarah! Pravkar sem preveril vaše naročilo #8847 — je na poti z dostavo FedEx in bi moralo prispeti danes do 17:00.
Ali lahko nadgradim svoj načrt?
Seveda! Trenutno ste na načrtu Basic z 847 preostalimi API klici. Pomagam vam lahko nadgraditi na Pro za dodatne funkcije in višje omejitve.

Implementacija

Izberite pristop, ki ustreza vaši nastavitvi:

Izpišite uporabniške podatke neposredno iz vaše strežniške predloge:

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

Nastavite kontekst po tem, ko vaša aplikacija naloži uporabniške podatke:

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

Najboljše za zmogljivost: Pripomoček zazna fetchUserContext in jo samodejno pokliče, ko se klepet odpre, tako da se podatki naložijo le, ko so potrebni.

Vi se odločite, kaj delite. Posredujte samo podatke, ki so relevantni za vaš primer uporabe - ime stranke, status naročila, raven naročnine, vsebino košarice ali katere koli druge informacije, ki pomagajo AI-ju bolje pomagati vašim uporabnikom. Uporabite opisne oznake, da AI razume kontekst.

Primeri uporabe

E-trgovina

"Vidim, da je vaše naročilo #4521 trenutno na poti in bi moralo prispeti do petka."

SaaS

"Ta mesec imate na načrtu Pro še 847 preostalih API klicev."

Podpora

"Vidim, da ste Zlati član s 3 odprtimi zahtevki. Kako vam lahko pomagam?"

Izobraževanje

"78% ste opravili tečaj JavaScript. Ste pripravljeni začeti modul 8?"

Gostinstvo

"Vaša rezervacija za 17. september je potrjena. Prijava se začne ob 15:00."

Zdravstvo

"Vaš naslednji termin pri dr. Smithu je načrtovan za torek ob 10:00."

Pomembne opombe

Neobvezno - Klepet deluje popolnoma brez uporabniškega konteksta. Je izboljšava za prijavljene uporabnike.
V realnem času - Kontekst se pošlje z vsakim sporočilom, zato ga lahko dinamično posodabljate, ko se uporabniški podatki spremenijo.
Varnost - Nikoli ne vključujte gesel, številk kreditnih kartic ali drugih občutljivih podatkov. Posredujte samo neobčutljive informacije.
Omejitve velikosti - Uporabniški kontekst je omejen na 2.000 znakov v načrtu Standard in 10.000 znakov v načrtu Pro. Če je presežen, bo skrajšan. Ohranite kontekst jedrnat.

Status integracije

Po implementaciji obiščite stran z nastavitvami uporabniškega konteksta, da preverite, ali vaša integracija deluje. Kartica stanja bo prikazala:

  • Ali se kontekst prejema
  • Najnovejše sporočilo s kontekstom
  • Predogled podatkov konteksta, ki se pošiljajo