Zpět na přehled

Dokumentace

Naučte se používat Asyntai

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. Povolte uživatelský kontext v nastavení svého dashboardu
  2. Přidejte JavaScript na svůj web, který nastavuje uživatelská 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;

Načítejte uživatelská data pouze při otevření chatu (nejlepší pro 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

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
  • Poslední zpráva s kontextem
  • Náhled odesílaných kontextových dat

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.