Powrót do panelu

Dokumentacja

Dowiedz się, jak korzystać z Asyntai

Kontekst użytkownika

Przekazuj informacje o użytkowniku, aby personalizować rozmowy z AI

Skonfiguruj kontekst użytkownika
Plany Standard i Pro

Przegląd

Kontekst użytkownika pozwala przekazywać informacje o zalogowanych użytkownikach do AI. Gdy podasz kontekst użytkownika, AI może witać użytkowników po imieniu, odwoływać się do szczegółów ich konta i udzielać spersonalizowanych odpowiedzi bez pytania o informacje, które już posiadasz.

Tworzy to płynne doświadczenie, w którym AI już "wie" o użytkowniku — jego planie subskrypcji, statusie zamówienia, punktach lojalnościowych lub innych istotnych danych, które zdecydujesz się udostępnić.

Jak to działa

  1. Włącz Kontekst użytkownika w ustawieniach panelu
  2. Add JavaScript to your website that sets user data
  3. AI otrzymuje kontekst z każdą wiadomością wysłaną przez użytkownika
  4. AI personalizuje odpowiedzi na podstawie dostarczonych informacji
Asystent AI
Gdzie jest moje zamówienie?
Cześć Sarah! Właśnie sprawdziłem Twoje zamówienie #8847 — jest w drodze z FedEx i powinno dotrzeć dzisiaj do 17:00.
Czy mogę ulepszyć swój plan?
Oczywiście! Jesteś obecnie na planie Basic z 847 pozostałymi wywołaniami API. Mogę pomóc Ci przejść na plan Pro, aby uzyskać dodatkowe funkcje i wyższe limity.

Implementacja

Wybierz podejście, które pasuje do Twojej konfiguracji:

Wyprowadź dane użytkownika bezpośrednio z szablonu po stronie serwera:

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

Ustaw kontekst po załadowaniu danych użytkownika przez aplikację:

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

Najlepsze dla wydajności: Widżet wykrywa fetchUserContext i wywołuje ją automatycznie po otwarciu czatu, dzięki czemu dane są ładowane tylko wtedy, gdy są potrzebne.

Ty decydujesz, czym się podzielić. Przekazuj tylko dane istotne dla Twojego zastosowania — imię klienta, status zamówienia, poziom subskrypcji, zawartość koszyka lub inne informacje, które pomagają AI lepiej obsługiwać Twoich użytkowników. Używaj opisowych etykiet, aby AI rozumiało kontekst.

Przykładowe zastosowania

E-commerce

"Widzę, że Twoje zamówienie #4521 jest obecnie w drodze i powinno dotrzeć do piątku."

SaaS

"W tym miesiącu pozostało Ci 847 wywołań API w ramach planu Pro."

Wsparcie

"I see you're a Gold member with 3 open tickets. How can I help?"

Edukacja

"Ukończyłeś 78% kursu JavaScript. Gotowy, aby rozpocząć Moduł 8?"

Hotelarstwo

"Your booking for September 17th is confirmed. Check-in starts at 3 PM."

Opieka zdrowotna

"Twoja następna wizyta u dr. Smitha jest zaplanowana na wtorek o 10:00."

Ważne uwagi

Opcjonalne - Czat działa doskonale bez kontekstu użytkownika. To ulepszenie dla zalogowanych użytkowników.
Czas rzeczywisty - Kontekst jest wysyłany z każdą wiadomością, więc możesz go dynamicznie aktualizować w miarę zmian danych użytkownika.
Bezpieczeństwo - Nigdy nie dołączaj haseł, numerów kart kredytowych ani innych wrażliwych danych. Przekazuj tylko informacje niewrażliwe.
Limity rozmiaru - Kontekst użytkownika jest ograniczony do 2000 znaków w planie Standard i 10 000 znaków w planie Pro. Po przekroczeniu zostanie obcięty. Utrzymuj kontekst zwięzły.

Status integracji

Po wdrożeniu odwiedź stronę ustawień kontekstu użytkownika, aby zweryfikować, czy integracja działa. Karta statusu pokaże:

  • Czy kontekst jest odbierany
  • Najnowsza wiadomość z kontekstem
  • Podgląd wysyłanych danych kontekstu