Twój koszyk jest obecnie pusty!
Jak zainstalować wtyczkę?
Zapisz plik virtual-ai-consultant.zip na swoim komputerze. Zainstaluj przez: WordPress → Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer
.
Wejdź w: Wtyczki → Zainstalowane wtyczki → Virtual AI Consultant
i kliknij „Aktywuj” lub „Włącz”
Po aktywacji pojawi się nowa pozycja w panelu bocznym: Virtual AI Consultant
Przejdź do License i wypełnij pola rejestracyjne. Po wysłaniu otrzymasz licencję i będziesz mógł używać Virtual AI Consultant.
Skrócona wersja ustawień konfiguracyjnych
Przewodnik ustawień konfiguracyjnych:
Settings
AI Knowledge Base
- Wybór wersji modelu AI
- Instrukcje integracji z modelem AI i API Key
– OpenAI
– Claude
– Gemini - Welcome Message in Widget
- Widget title
- Show main widget button automatically?
- AI Button Color
- Button Text Color
- Button Hover Color
- Email to receive conversations
- Voice response (TTS
- Microphone (Speech Recognition)
- RAG – Similarity Threshold
- RAG – Number of Chunks
- Query limit (per session)
- Hide widget button on these pages
- Google Analytics Integration
- System Prompt for Assistant
- Product data source
- Use XML Embeddings?
- Max number of matched products
Skrócona wersja ustawień konfiguracyjnych
Krok 1: API i model AI
Przejdź do Virtual AI Consultant → Settings
i uzupełnij:
- Klucz API do OpenAI (dla GPT-4 lub GPT-3.5)
- Lub klucze do Claude (Anthropic) albo Gemini (Google)
- Wybierz model AI, np. GPT-4o lub Claude Sonnet
Krok 2: Wiadomość powitalna
- Ustaw tekst powitalny widoczny w widżecie.
- Możesz ustawić również tytuł widżetu.
Krok 3: Dodanie przycisku AI do strony
- Automatycznie – zaznacz „Show main widget button automatically”.
- Lub ręcznie – użyj shortcode: wklej
[ai_chat_widget]
na swojej stronie
Krok 4: Kolory przycisku
- Dobierz kolory przycisku, tekstu i efektu „hover”, aby dopasować do Twojej strony.
Krok 5: Źródło danych produktowych
- Wybierz, skąd Konsultant ma pobierać informacje o produktach:
- WooCommerce
- Pliki JSON (Baza wiedzy)
- Plik XML z embeddingami
- Tryby hybrydowe (łączne)
Krok 6: Ustawienia Bazy Wiedzy
Przejdź do Virtual AI Consultant → Knowledge Base
:
- Wprowadź dane w 6 polach: informacje o firmie, produkty, ceny, FAQ itd.
- (opcjonalnie) Dodaj ścieżkę do pliku XML z produktami.
- Kliknij „Save Knowledge Base”
- Możesz ręcznie wygenerować embeddingi dla pliku XML przyciskiem „Generate Embeddings”.
Krok 7: Harmonogram działania Konsultanta
W zakładce Assistant Schedule
:
- Wprowadź harmonogram w formacie JSON (dzień tygodnia + godziny).
- Przykład: { „mon”: [[„08:00”, „12:00”], [„14:00”, „18:00”]], }
- Pozostaw pole nie wypełnione jezeli chcesz, aby Konsultant AI był włączony
- Wpisz, jeżeli ma być włączony tylko w podane zakresy
Krok 8: Testowanie
- Po aktywacji przycisku pojawi się formularz z imieniem, mailem i firmą.
- Wpisz dane i rozpocznij rozmowę z AI.
- Zadawaj pytania i analizuj odpowiedzi. Zmodyfikuj instrukcje dla Konsultanta.
Instrukcje integracji z modelem AI
Jak wygenerować klucz API w OpenAI
Krok 1: Zaloguj się do OpenAI
- Wejdź na stronę: https://platform.openai.com
- Kliknij Log in i zaloguj się na swoje konto (lub kliknij Sign up, jeśli nie masz jeszcze konta).
Krok 2: Wejdź do panelu użytkownika
- Po zalogowaniu przejdź do: https://platform.openai.com/account/api-keys
- Zobaczysz stronę „API keys”.
Krok 3: Wygeneruj nowy klucz
- Kliknij + Create new secret key (lub Utwórz nowy klucz, jeśli masz taki interfejs).
- Nadaj nazwę kluczowi (np.
Moja integracja z WordPress
) – to tylko dla Ciebie. - Kliknij Create secret key.
Krok 4: Skopiuj klucz
- Po utworzeniu klucz zostanie wyświetlony tylko raz – skopiuj go teraz i zapisz, np. w menedżerze haseł.
- Jeśli go zgubisz, będziesz musiał wygenerować nowy.
Uwaga:
- Traktuj klucz jak hasło – nie udostępniaj go nikomu i nie wklejaj w kod front-endu (np. JavaScript na stronie).
- W razie potrzeby możesz klucz usunąć lub dezaktywować z tej samej strony (
API Keys
).
Krok po kroku: Dodawanie projektu i wybór modelu w OpenAI
Krok 1: Wejdź do panelu OpenAI
- Otwórz stronę: https://platform.openai.com
- Zaloguj się, jeśli jeszcze tego nie zrobiłeś.
Krok 2: Przejdź do ustawień organizacji i projektów
- Kliknij w prawym górnym rogu na swoje imię / nazwę konta.
- Wybierz „Settings” (Ustawienia).
- W menu po lewej wybierz „Projects”.
- Kliknij „New Project”.
- Wpisz nazwę projektu (np.
AI Chat dla strony
). - Kliknij Create.
Krok 3: Ustaw projekt jako aktywny
- Po utworzeniu projektu kliknij w niego.
- Kliknij przycisk „Make active” – teraz będzie to Twój domyślny projekt dla klucza API.
? Ważne:
Jeśli korzystasz z funkcji płatnych, upewnij się, że Twój projekt ma dodaną metodę płatności (Billing). Uzupełnij pola dotyczące płatności.
Jak wygenerować klucz API w Claude (Anthropic)
Krok 1: Zaloguj się do Anthropic Console
- Wejdź na stronę: https://console.anthropic.com
- Kliknij Sign in i zaloguj się na swoje konto (można zalogować się przez Google lub e-mail).
- Jeśli nie masz konta, kliknij Sign up i załóż konto.
Krok 2: Przejdź do ustawień organizacji
- Po zalogowaniu kliknij ikonę profilu w prawym górnym rogu.
- Wybierz opcję Team Settings lub API Keys (w zależności od wersji panelu).
- Upewnij się, że jesteś w zakładce organizacji, dla której chcesz wygenerować klucz.
Krok 3: Wygeneruj nowy klucz API
- Kliknij przycisk Create API Key lub + New Key.
- Wpisz nazwę klucza (np.
Claude integracja WordPress
). - Kliknij Create Key.
- Klucz zostanie wygenerowany i wyświetlony – skopiuj go teraz i zapisz (np. w menedżerze haseł).
Krok 4: Ustaw limit lub kontrolę zużycia (opcjonalne)
- Możesz nadać kluczowi ograniczenia (np. dzienny limit kosztów lub dostęp do określonych modeli).
- Wybierz odpowiednie opcje przed zapisaniem, jeśli są dostępne.
Uwaga:
- Klucz API to poufna informacja – traktuj go jak hasło.
- Nie udostępniaj go osobom trzecim i nie umieszczaj go w publicznym kodzie JavaScript.
- W razie potrzeby możesz usunąć klucz z poziomu tego samego panelu.
Jak wygenerować klucz API do Gemini (Google AI)
Krok 1: Zaloguj się do Google Cloud Console
- Wejdź na stronę: https://console.cloud.google.com
- Zaloguj się na swoje konto Google (najlepiej firmowe lub developerskie).
- Upewnij się, że masz aktywną usługę Cloud Billing (wymagane do korzystania z API Gemini).
Krok 2: Utwórz nowy projekt
- W prawym górnym rogu kliknij Wybierz projekt.
- Kliknij Nowy projekt.
- Wpisz nazwę projektu (np.
Gemini AI Chat
) i kliknij Utwórz. - Wybierz projekt z listy i kliknij Otwórz.
Krok 3: Włącz API Gemini (Generative Language API)
- Będąc w projekcie, przejdź do: https://console.cloud.google.com/apis/library
- Wyszukaj „Generative Language API” (lub Gemini API).
- Kliknij na wynik i naciśnij Włącz.
Krok 4: Utwórz dane logowania (klucz API)
- Przejdź do: https://console.cloud.google.com/apis/credentials
- Kliknij Utwórz dane logowania → Klucz API.
- Klucz zostanie wygenerowany – skopiuj go teraz i zapisz.
Krok 5: Ogranicz dostęp klucza (zalecane)
- Po utworzeniu możesz kliknąć Edytuj i ograniczyć zakres IP lub przypisać dostęp tylko do określonych API.
- To zwiększa bezpieczeństwo Twojego klucza.
Uwaga:
- Klucz API do Gemini działa globalnie w ramach wybranego projektu Google Cloud.
- Klucz jest powiązany z systemem płatności – upewnij się, że masz aktywną metodę rozliczeniową.
- Nie umieszczaj klucza w publicznym kodzie źródłowym – traktuj go jak hasło.
Wybór wersji modelu AI – przewodnik dla użytkowników
Data opracowania: 25 marzec 2025r.
Modele OpenAI (GPT)
GPT-3.5 Turbo
- Szybki i tani model tekstowy.
- Idealny do prostych chatbotów, FAQ, formularzy kontaktowych.
- Wersja darmowa dostępna przez OpenAI Playground (z limitem).
- Polecany dla małych firm oraz testów.
GPT-3.5 Turbo 16k
- Rozszerzona wersja GPT-3.5 z większym kontekstem (do 16 000 tokenów).
- Umożliwia dłuższe rozmowy lub analizę większej ilości danych tekstowych.
- Działa bardzo szybko i ekonomicznie.
- Dobry wybór dla sklepów z rozbudowaną ofertą.
GPT-4
- Bardzo dokładny model, ale droższy i wolniejszy od nowszych wersji.
- Nie zalecany do użycia w czasie rzeczywistym (chat na stronie).
- Brak darmowej wersji.
GPT-4 Turbo
- Ulepszona wersja GPT-4 – tańsza i szybsza.
- Nadaje się do zastosowań komercyjnych z naciskiem na jakość.
- Brak darmowej wersji.
GPT-4o
- Najnowszy model OpenAI łączący jakość GPT-4 i szybkość GPT-3.5.
- Obsługuje tekst, obraz i dźwięk.
- Świetny balans jakości i wydajności.
- Najlepszy wybór ogólny dla większości użytkowników.
- Można testować w darmowej wersji ChatGPT (przy ograniczeniach czasowych).
Modele Claude (Anthropic)
Claude 3 Haiku
- Najszybszy i najtańszy model Claude.
- Odpowiedni do prostych zadań, formularzy, automatyzacji obsługi klienta.
- Często dostępny w darmowych testach na koncie Anthropic.
- Dobry wybór do sklepów i lead generation.
Claude 3 Sonnet
- Model pośredni – optymalny balans między szybkością a jakością.
- Bardzo dobre zrozumienie języka i kontekstu.
- Polecany jako domyślny model dla firm każdej wielkości.
- Brak oficjalnej wersji darmowej, ale dostępny na kontach z limitem startowym.
Claude 3 Opus
- Najmocniejszy model Claude – bardzo dokładny, używany do złożonych analiz.
- Polecany dla firm potrzebujących najwyższej jakości (np. analiza danych, wsparcie techniczne).
- Model płatny.
Claude 2.1 i starsze
- Starsze wersje modeli.
- Można używać testowo, ale nie zalecane do nowych wdrożeń.
Modele Gemini (Google)
Gemini 1.5 Flash
- Szybki, lekki model do czatu i prostych automatyzacji.
- Dostępny w wersji darmowej w ramach konta Google Cloud (z limitem miesięcznym).
- Idealny do małych projektów lub testów.
Gemini 1.5 Pro
- Dokładniejszy model z dużym kontekstem.
- Sprawdza się w sklepach, aplikacjach doradczych, firmach średniej wielkości.
- Wymaga aktywnej usługi billingowej Google Cloud.
- Brak darmowej wersji po wykorzystaniu limitu testowego.
Gemini Pro Vision
- Model z obsługą obrazów – np. analiza grafik, zdjęć produktów.
- Polecany dla sklepów internetowych i firm e-commerce.
- Wymaga płatnej aktywacji.
Gemini Ultra
- Najmocniejszy model Google, do zaawansowanych projektów.
- Wysoka precyzja i koszt.
- Używany przez duże firmy, banki, instytucje.
Gemini 1.0 Pro
- Starsza wersja, dostępna w niektórych regionach.
- Można używać do testów lub lekkich integracji.
Podsumowanie
Jeśli nie wiesz, co wybrać – zacznij od GPT-4o lub Claude 3 Sonnet.
Oba modele oferują świetne połączenie jakości i szybkości, sprawdzają się w firmach każdej wielkości.
Dla prostych wdrożeń (np. formularze, leady, czat w sklepie) możesz zacząć od GPT-3.5 Turbo lub Gemini Flash, które oferują darmowe limity.
Tabela porównawcza modeli AI
Model | Szybkość | Jakość | Koszt | Darmowa wersja | Zastosowanie |
---|---|---|---|---|---|
GPT-3.5 Turbo | Szybka | Średnia | Niski | Tak (ograniczona) | Chat, formularze, małe firmy |
GPT-3.5 Turbo 16k | Szybka | Średnia | Niski | Nie | Dłuższe treści, e-commerce |
GPT-4 Turbo | Średnia | Bardzo wysoka | Średni | Nie | Firmy średnie i duże, jakość + kontekst |
GPT-4o | Bardzo szybka | Bardzo wysoka | Średni | Tak (czasowo) | Uniwersalne, wszystkie branże |
Claude 3 Haiku | Bardzo szybka | Średnia | Niski | Tak (testy) | Obsługa klienta, leady, czat |
Claude 3 Sonnet | Szybka | Wysoka | Średni | Tak (limit testowy) | Sklepy, doradztwo, FAQ |
Claude 3 Opus | Średnia | Bardzo wysoka | Wysoki | Nie | Zaawansowana analiza, dokumenty |
Gemini Flash 1.5 | Bardzo szybka | Średnia | Niski | Tak (limit Google) | Małe projekty, blogi, szybki czat |
Gemini Pro 1.5 | Średnia | Wysoka | Średni | Tak (na start) | Sklepy, aplikacje, średnie firmy |
Gemini Vision | Średnia | Wysoka | Średni | Nie | Obrazy, zdjęcia produktów, katalogi |
Gemini Ultra | Średnia | Bardzo wysoka | Wysoki | Nie | Duże firmy, zaawansowane rozwiązania |
Jak napisać skuteczny tekst powitalny w widżecie AI
Tekst powitalny w widżecie to pierwsze zdanie, które użytkownik zobaczy w oknie rozmowy z Konsultantem AI. Jego celem jest zachęcenie do zadania pytania, wywołanie interakcji i zbudowanie zaufania.
Dobrze napisany komunikat powinien:
- pasować do branży,
- być uprzejmy i naturalny,
- jasno wskazywać, co użytkownik może zrobić (np. zadać pytanie, poprosić o ofertę),
- nie być zbyt długi – najlepiej 1–2 zdania.
Dobre praktyki:
- Unikaj zbyt ogólnych tekstów typu „W czym mogę pomóc?” – zamiast tego zastosuj bardziej konkretne zaproszenie.
- Zastosuj język pasujący do grupy docelowej (np. formalny lub bardziej swobodny).
- Możesz dodać przykład pytania, które użytkownik może zadać.
- Jeśli firma działa lokalnie (np. salon), wspomnij o rezerwacji lub konsultacji.
Przykładowe teksty powitalne w zależności od branży:
Uniwersalny tekst: Cześć! Jestem Twoim Wirtualnym Konsultantem. Napisz, jeśli masz pytanie o ofertę, produkty lub dostępność usług.
Salon fryzjerski / kosmetyczny: Witaj! Chcesz umówić się na wizytę lub dowiedzieć się więcej o naszych zabiegach? Napisz do mnie – pomogę Ci w kilka sekund.
Salon samochodowy / dealer: Dzień dobry! Chętnie pomogę w wyborze auta, dostępności modeli lub oferty finansowania. Zadaj pytanie, a odpowiem natychmiast.
Sklep internetowy: Cześć! Szukasz konkretnego produktu lub chcesz poznać szczegóły oferty? Napisz tutaj – jestem dostępny od razu.
Firma B2B / produkcja: Witaj! Potrzebujesz wyceny, informacji o dostępności lub danych technicznych? Napisz, a przygotuję odpowiedź w kilka chwil.
Szkoła / kursy / edukacja: Cześć! Chętnie pomogę dobrać kurs lub przedstawię szczegóły zapisów. Zadaj pytanie, a wszystko Ci wyjaśnię.
Jak ustawić Welcome Message:
- Wejdź do panelu administracyjnego WordPressa.
- Przejdź do: Virtual AI Consultant → Settings.
- W polu „Welcome Message” wpisz wybrany tekst powitalny.
- Zapisz zmiany – tekst pojawi się przy pierwszym otwarciu widżetu na stronie.
Podsumowanie:
Tekst powitalny powinien być przyjazny, konkretny i dostosowany do Twojej branży. To pierwsza linia kontaktu z użytkownikiem – zbuduj zaufanie już od pierwszego zdania.
Jak ustawić skuteczny tytuł widżetu (Widget Title)
Tytuł widżetu to tekst widoczny w przycisku „widget”. Pojawia się jako nagłówek – zanim użytkownik rozpocznie rozmowę.
Jest to pierwsza rzecz, którą odwiedzający zobaczy klikając przycisk asystenta. Tytuł powinien być prosty, zachęcający i dopasowany do branży lub stylu Twojej firmy.
Czym powinien się charakteryzować dobry tytuł:
- Jest krótki (najlepiej 2–5 słów),
- Informuje, z kim użytkownik ma do czynienia,
- Może być neutralny („Wirtualny Asystent”), branżowy („Doradca zakupów”), lub personalizowany („Konsultant AWIH”),
- Pasuje do tonu komunikacji strony (formalny lub nieformalny).
Dobre praktyki:
- Unikaj zbyt ogólnych i technicznych nazw typu „AI Bot”.
- Możesz dodać imię lub funkcję (np. „Doradca Monika”, „Ekspert ds. zamówień”).
- Dla stron wielojęzycznych warto dobrać tytuł w języku użytkownika.
- Jeśli prowadzisz firmę lokalną – warto nawiązać do regionu, np. „Doradca z Krakowa”.
Przykładowe tytuły:
Uniwersalne:
- Wirtualny Asystent
- Twój Konsultant AI
- Doradca Online
Dla sklepu:
- Doradca zakupów
- Zapytaj o produkt
- Pomoc w wyborze
Dla salonu usługowego:
- Rezerwacje i pytania
- Twój doradca wizyt
- Zaplanuj wizytę
Dla firmy B2B:
- Konsultant XYZ
- Ekspert ds. oferty
- Doradca klienta biznesowego
Dla branży edukacyjnej:
- Doradca kursów
- Zapisy i pytania
- Wirtualne biuro szkoły
Jak ustawić Widget Title:
- Zaloguj się do panelu WordPress.
- Przejdź do: Virtual AI Consultant → Settings.
- W polu „Widget Title” wpisz swój tytuł widżetu.
- Zapisz zmiany – nagłówek pojawi się nad formularzem startowym lub czatem.
Podsumowanie:
Tytuł widżetu to pierwszy komunikat widoczny dla odwiedzającego – traktuj go jak powitanie. Dopasuj ton, długość i styl do swojej firmy i zachęć użytkownika do rozmowy.
Opcja „Show main widget button” – co to jest i jak jej używać
Show main widget button to opcja w ustawieniach wtyczki, która pozwala automatycznie wyświetlić przycisk uruchamiający okno rozmowy z Konsultantem AI na każdej stronie Twojej witryny.
To najprostszy sposób na dodanie chatu AI do swojej strony bez konieczności umieszczania shortcode.
Co robi ta opcja?
Po jej zaznaczeniu:
- Na stronie pojawi się przycisk (domyślnie „Wirtualny Asystent AI”) widoczny w dolnym rogu ekranu.
- Kliknięcie w ten przycisk otwiera formularz startowy, a następnie okno rozmowy z Konsultantem AI.
- Przyciski i widżet dopasowują się do wybranego harmonogramu i ustawień widoczności.
Kiedy używać?
Ta opcja jest idealna, gdy:
- Chcesz, aby asystent AI był dostępny globalnie na całej stronie.
- Nie korzystasz z kreatorów stron typu Elementor lub nie chcesz ręcznie dodawać chatu do wybranych podstron.
- Zależy Ci na szybkim wdrożeniu i maksymalnej widoczności asystenta.
Jak włączyć?
- Zaloguj się do panelu administracyjnego WordPress.
- Przejdź do: Virtual AI Consultant → Settings.
- Zaznacz pole „Show main widget button automatically”.
- Zapisz zmiany.
Jak wyłączyć?
Jeśli nie chcesz, aby przycisk był widoczny globalnie:
- Odznacz tę opcję i zapisz ustawienia.
- Następnie możesz dodać widżet ręcznie, wstawiając shortcode
[ai_chat_widget]
na wybranych podstronach.
Uwagi:
- Możesz ustawić na jakich stronach przycisk nie ma się pojawiać – wystarczy wpisać URL-e w osobnym polu w panelu ustawień.
- Kolor, pozycję i nazwę przycisku ustawisz w tym samym miejscu (sekcja „Widget button settings”).
Podsumowanie:
Opcja „Show main widget button” pozwala błyskawicznie wdrożyć widoczny przycisk AI chatu na całej stronie. To najlepsze rozwiązanie dla użytkowników, którzy chcą maksymalnej widoczności i gotowego przycisku bez kodowania.
AI Button Color – jak ustawić kolor przycisku Konsultanta
AI Button Color to ustawienie, które pozwala dostosować wygląd głównego przycisku otwierającego Konsultanta AI, tak aby pasował do stylu Twojej strony internetowej.
Przycisk ten pojawia się w prawym dolnym rogu ekranu (jeśli włączona jest opcja „Show main widget button”) i jest pierwszym elementem, który widzi użytkownik.
Jak ustawić kolor przycisku?
- Zaloguj się do panelu WordPress.
- Przejdź do: Virtual AI Consultant → Settings.
- W sekcji Widget button settings znajdziesz pole AI Button Color.
- Kliknij na pole koloru, a następnie wybierz kolor z palety lub wpisz ręcznie kod koloru (np.
#0073e6
). - Zapisz zmiany.
Co jeszcze można zmienić?
Oprócz koloru przycisku możesz ustawić także:
- Kolor tekstu na przycisku (AI Button Text Color),
- Kolor efektu po najechaniu (AI Button Hover Color),
- Tekst wyświetlany na przycisku (AI Button Text).
Dobre praktyki:
- Wybierz kolor, który pasuje do Twojego motywu strony – np. kolor akcentu, brandu lub CTA (Call to Action).
- Zadbaj o kontrast – tekst na przycisku powinien być dobrze widoczny (np. biały tekst na ciemnym tle).
- Unikaj kolorów zbyt jasnych lub trudnych do odczytania.
Przykładowe ustawienia:
- Niebieski przycisk z białym tekstem:
AI Button Color:#0073e6
AI Button Text Color:#ffffff
- Zielony przycisk pasujący do motywu ekologicznego:
AI Button Color:#3bb273
AI Button Text Color:#ffffff
Podsumowanie:
Pole AI Button Color pozwala szybko i wygodnie dopasować kolor przycisku Konsultanta AI do wyglądu Twojej strony. Dzięki temu widżet wygląda spójnie i profesjonalnie – a użytkownicy chętniej z niego korzystają.
Button Text Color – jak ustawić kolor tekstu na przycisku
Button Text Color to ustawienie pozwalające dostosować kolor napisu na głównym przycisku uruchamiającym Konsultanta AI. Dzięki temu możesz zadbać o czytelność oraz spójność wizualną przycisku z resztą Twojej strony.
Kolor tekstu powinien być dobrze widoczny na tle przycisku (AI Button Color), dlatego zaleca się stosowanie kontrastujących barw.
Jak ustawić kolor tekstu na przycisku?
- Zaloguj się do panelu WordPress.
- Przejdź do: Virtual AI Consultant → Settings.
- W sekcji Widget button settings znajdź pole Button Text Color.
- Kliknij w próbnik koloru i wybierz kolor z palety lub wpisz ręcznie kod koloru (np.
#ffffff
). - Zapisz zmiany.
Dobre praktyki:
- Jeśli przycisk ma ciemne tło (np. granatowe, czarne, zielone), tekst powinien być jasny – np. biały (
#ffffff
) lub jasnożółty (#ffffcc
). - Jeśli tło przycisku jest jasne (np. pastelowe, beżowe), tekst powinien być ciemny – np. grafitowy (
#333333
) lub czarny (#000000
). - Upewnij się, że tekst pozostaje czytelny na urządzeniach mobilnych.
Przykładowe ustawienia:
- Ciemnoniebieski przycisk (
#0055aa
) z białym tekstem (#ffffff
) - Zielony przycisk (
#3bb273
) z czarnym tekstem (#000000
) - Jasnoszary przycisk (
#e0e0e0
) z grafitowym tekstem (#333333
)
Podsumowanie:
Button Text Color to mały, ale ważny detal wpływający na czytelność i estetykę Twojego widżetu AI. W połączeniu z dobrze dobranym tłem tworzy profesjonalny i spójny element interfejsu, który zachęca użytkowników do kliknięcia.
Button Hover Color – jak ustawić kolor przycisku po najechaniu myszką
Button Hover Color to ustawienie, które pozwala określić, jak będzie wyglądał przycisk uruchamiający Konsultanta AI, gdy użytkownik najedzie na niego kursorem. To efekt wizualny, który zwiększa interaktywność i pomaga użytkownikowi zorientować się, że przycisk jest aktywny.
Zmiana koloru po najechaniu to standardowy element nowoczesnych stron internetowych – sprawia, że interfejs jest bardziej responsywny i profesjonalny.
Jak ustawić kolor hover przycisku?
- Zaloguj się do panelu WordPress.
- Przejdź do: Virtual AI Consultant → Settings.
- W sekcji Widget button settings znajdź pole Button Hover Color.
- Kliknij w pole koloru i wybierz kolor z palety lub wpisz kod koloru ręcznie (np.
#0055cc
). - Zapisz zmiany.
Dobre praktyki:
- Kolor hover powinien być wyraźnie odróżnialny od koloru podstawowego przycisku, ale wciąż pasować do motywu strony.
- Najczęściej stosuje się delikatne przyciemnienie lub rozjaśnienie przycisku po najechaniu.
- Upewnij się, że kolor tekstu nadal będzie dobrze widoczny (Button Text Color) po zmianie tła.
Przykładowe kombinacje:
- Przyciski w kolorze niebieskim (
#0073e6
) mogą mieć efekt hover w ciemniejszym odcieniu (#005bb5
). - Zielony przycisk (
#3bb273
) może zmienić się na bardziej nasycony odcień (#329a5e
). - Jasne przyciski (
#e0e0e0
) mogą ciemnieć przy hoverze (#c2c2c2
).
Podsumowanie:
Ustawienie koloru efektu hover to prosty sposób, aby poprawić wrażenia użytkownika i zwiększyć estetykę widżetu AI. Przycisk reagujący na ruch kursora wygląda profesjonalnie i bardziej zachęca do interakcji.
Email to receive conversations – jak ustawić adres e-mail do odbioru rozmów
Email to receive conversations to pole w ustawieniach wtyczki, które pozwala wskazać adres e-mail, na który będą trafiać zapisane rozmowy prowadzone z użytkownikami Twojej strony. Może to być skrzynka firmowa, działu obsługi klienta lub Twoja prywatna.
Funkcja jest szczególnie przydatna, jeśli chcesz:
- otrzymywać wszystkie zapytania klientów w czasie rzeczywistym,
- archiwizować konwersacje w skrzynce e-mail,
- filtrować rozmowy testowe lub przypisywać je do konkretnych osób.
Jak ustawić adres e-mail do odbioru rozmów?
- Zaloguj się do panelu WordPress.
- Przejdź do: Virtual AI Consultant → Settings.
- Znajdź pole Email to receive conversations.
- Wpisz pełny adres e-mail, na który mają być przesyłane rozmowy (np.
biuro@firma
.com). - Zapisz zmiany.
Co zawiera wiadomość e-mail?
- Dane użytkownika (imię i nazwisko, e-mail, firma, telefon),
- Czas rozpoczęcia rozmowy,
- Pełna historia rozmowy z Konsultantem AI,
- Informacja o tym, czy rozmowa została oznaczona jako testowa (np. jeśli w formularzu podano słowo „test”).
Dobre praktyki:
- Użyj adresu, który jest monitorowany na bieżąco – np. działu obsługi klienta lub handlowca.
- Możesz podać kilka adresów, korzystając z aliasów lub przekierowań (np.
kontakt@firma.pl
→ kilku odbiorców). - Jeśli chcesz odfiltrowywać testowe rozmowy, poproś testerów o wpisanie „Test” w polu firmy – pozwoli to łatwo je zidentyfikować w CRM lub skrzynce odbiorczej.
Podsumowanie:
Pole „Email to receive conversations” pozwala na natychmiastowy odbiór rozmów prowadzonych przez Konsultanta AI bez konieczności logowania do WordPressa. To doskonałe rozwiązanie dla zespołów sprzedaży, obsługi lub osób analizujących konwersje i potrzeby klientów.
Voice Response (TTS) – jak działa funkcja głosowych odpowiedzi
Voice Response (TTS) to opcja, która pozwala Konsultantowi AI odczytywać swoje odpowiedzi użytkownikowi na głos. Dzięki temu użytkownik nie musi czytać wiadomości – może je po prostu usłyszeć.
To przydatna funkcja, szczególnie w sytuacjach, gdy:
- użytkownik korzysta z urządzenia mobilnego,
- chcesz zwiększyć dostępność strony dla osób niedowidzących,
- zależy Ci na bardziej „ludzkim” charakterze rozmowy z AI.
Jak działa TTS?
- Po włączeniu opcji, każda odpowiedź AI zostaje automatycznie odczytana przez syntezator mowy.
- Użytkownik może wyłączyć lub włączyć głos w trakcie rozmowy (jeśli taka opcja jest aktywna w ustawieniach widżetu).
- Głos, język i akcent dostosowują się do ustawień przeglądarki użytkownika lub języka odpowiedzi.
Jak włączyć Voice Response?
- Zaloguj się do panelu WordPress.
- Przejdź do: Virtual AI Consultant → Settings.
- W sekcji Voice options zaznacz pole Enable Text-to-Speech (TTS).
- Zapisz zmiany.
Dobre praktyki:
- Upewnij się, że treść odpowiedzi Konsultanta jest zrozumiała, ponieważ będzie wypowiadana na głos – unikaj skrótów, linków w środku zdania, zbędnych znaków.
- Nie stosuj TTS w trybie testowym lub na stronach wymagających ciszy (np. w środowisku edukacyjnym), jeśli użytkownik nie ma kontroli nad dźwiękiem.
Przykładowe zastosowania:
- Na stronie salonu fryzjerskiego – AI może odczytać propozycję terminu.
- W sklepie internetowym – głosowe odczytanie oferty lub ceny produktu.
- W firmie produkcyjnej – AI może odczytać informacje o czasie realizacji.
Podsumowanie:
Funkcja Voice Response (TTS) pozwala uczynić rozmowę z Konsultantem AI bardziej dynamiczną, interaktywną i dostępną. Jest szczególnie przydatna na stronach mobilnych oraz dla użytkowników ceniących szybkość i wygodę.
Microphone (Speech Recognition) – jak działa rozpoznawanie mowy
Funkcja mikrofonu (Speech Recognition) umożliwia użytkownikowi zadawanie pytań głosowo – wystarczy kliknąć ikonę mikrofonu i mówić. Wypowiedź zostanie automatycznie przekształcona na tekst, a następnie przetworzona przez Konsultanta AI.
To rozwiązanie zwiększa wygodę użytkowników, szczególnie na telefonach, a także poprawia dostępność serwisu.
Jak działa rozpoznawanie mowy?
- Użytkownik klika ikonę mikrofonu w oknie widżetu.
- Przeglądarka prosi o zgodę na dostęp do mikrofonu.
- Po wyrażeniu zgody – wszystko, co użytkownik powie, zostanie przekształcone w tekst i wysłane do Konsultanta AI.
- Obsługiwane są języki zgodne z ustawieniami przeglądarki.
Jak włączyć mikrofon (Speech Recognition)?
- Zaloguj się do panelu WordPress.
- Przejdź do: Virtual AI Consultant → Settings.
- W sekcji Voice options zaznacz pole Enable Speech Recognition (Microphone).
- Zapisz zmiany.
Wymagania techniczne:
- Mikrofon musi być dostępny i aktywny na urządzeniu użytkownika.
- Funkcja działa w większości nowoczesnych przeglądarek (np. Chrome, Edge).
- Wymagana jest zgoda użytkownika na korzystanie z mikrofonu (pop-up przeglądarki).
Przykładowe zastosowania:
- Użytkownik mówi: „Potrzebuję 500 toreb z nadrukiem” → AI przetwarza zapytanie natychmiast.
- Na stronie mobilnej – klient może zadać pytanie bez pisania.
- W branży medycznej lub edukacyjnej – zwiększona dostępność dla osób niedowidzących lub mających trudności z pisaniem.
Podsumowanie:
Funkcja mikrofonu (Speech Recognition) sprawia, że kontakt z Konsultantem AI staje się szybszy, łatwiejszy i bardziej nowoczesny. To idealne rozwiązanie dla użytkowników mobilnych oraz wszystkich, którzy wolą mówić niż pisać.
RAG – Similarity Threshold – jak ustawić próg trafności dopasowania wiedzy
RAG – Similarity Threshold to pole w ustawieniach wtyczki Virtual AI Consultant, które pozwala ustalić minimalny próg trafności (ang. similarity score), przy którym fragment wiedzy (tzw. chunk) zostanie uznany za istotny i przekazany do AI w odpowiedzi.
Wartość mieści się w przedziale od 0.0 do 1.0, gdzie:
- 0.0 oznacza pełną tolerancję (wszystko może pasować),
- 1.0 oznacza bardzo rygorystyczne dopasowanie (tylko niemal identyczne sformułowania są brane pod uwagę).
Rekomendowana wartość: 0.7 – 0.75 (domyślnie: 0.7)
Funkcja jest przydatna, jeśli chcesz:
- precyzyjnie kontrolować, jak dokładnie AI dopasowuje informacje z bazy wiedzy,
- ograniczyć odpowiedzi do tych, które mają silne powiązanie z pytaniem użytkownika,
- uniknąć nieistotnych lub przypadkowych fragmentów w odpowiedziach AI.
Jak ustawić próg dopasowania Similarity Threshold?
- Zaloguj się do panelu WordPress.
- Przejdź do: Virtual AI Consultant → Knowledge Base.
- Znajdź pole RAG – Similarity Threshold.
- Wpisz wartość od 0.0 do 1.0, np. 0.75.
- Zapisz zmiany.
Przykłady:
- 0.4–0.5 – AI korzysta z bardzo szerokiego zakresu wiedzy, co zwiększa liczbę wyników, ale zmniejsza ich trafność.
- 0.7–0.8 – AI dopasowuje tylko te fragmenty, które naprawdę pasują do pytania – idealne dla precyzyjnych odpowiedzi.
Dobre praktyki:
- Dla ogólnych zapytań klientów – ustaw wartość 0.7.
- Dla czatów technicznych, B2B lub produktów z podobnymi opisami – lepiej sprawdzi się 0.75–0.8.
- Jeśli AI ignoruje zbyt wiele informacji – spróbuj obniżyć próg do 0.6.
Podsumowanie:
Pole „RAG – Similarity Threshold” pozwala określić, jak dokładnie Konsultant AI analizuje i dopasowuje wiedzę do pytania użytkownika. Dzięki temu możesz zwiększyć trafność odpowiedzi lub poszerzyć zakres kontekstu – zależnie od swoich celów.
RAG – Number of Chunks – ile fragmentów wiedzy ma otrzymać AI
RAG – Number of Chunks to pole konfiguracyjne, które określa ile najbardziej dopasowanych fragmentów wiedzy (chunks) może zostać przekazanych do AI w trakcie jednego zapytania.
Domyślnie: 5
Funkcja jest przydatna, jeśli chcesz:
- zwiększyć precyzję odpowiedzi (mniej, ale bardziej trafnych fragmentów),
- ograniczyć koszt tokenów przesyłanych do API,
- mieć wpływ na długość i dokładność kontekstu przekazywanego AI.
Jak ustawić liczbę fragmentów (chunks)?
- Zaloguj się do panelu WordPress.
- Przejdź do: Virtual AI Consultant → Knowledge Base.
- Znajdź pole RAG – Number of Chunks.
- Wpisz liczbę od 1 do 20 (zalecane: 3 – 5).
- Zapisz zmiany.
Przykłady:
- 3 – AI otrzyma tylko najbardziej trafne informacje – szybka i precyzyjna odpowiedź.
- 5 – domyślna wartość, dobra równowaga między trafnością a kontekstem.
- 10 lub więcej – większy kontekst, ale wyższe koszty API i dłuższe czasy odpowiedzi.
Dobre praktyki:
- Ustaw 3–5, jeśli korzystasz z OpenAI (GPT-4, GPT-3.5) i chcesz zredukować koszty.
- Zwiększ do 7–10, jeśli baza wiedzy jest bardzo rozbudowana i zawiera opisy techniczne lub warianty podobnych produktów.
- Nie przekraczaj 20 – większa liczba fragmentów może spowodować rozmycie odpowiedzi.
Podsumowanie:
Pole „RAG – Number of Chunks” kontroluje, ile fragmentów wiedzy zostanie uwzględnionych przez AI podczas udzielania odpowiedzi. To proste ustawienie pozwala precyzyjnie balansować między jakością a kosztem i szybkością działania chatu.
Query Limit (per session) – jak ustawić limit odpowiedzi Konsultanta
Query Limit (per session) to funkcja umożliwiająca określenie, ile odpowiedzi może udzielić Konsultant AI jednemu użytkownikowi podczas jednej wizyty na stronie (tzw. sesji).
To przydatne narzędzie, jeśli chcesz:
- ograniczyć nadużycia lub testowanie bota,
- zarządzać kosztami integracji z AI.
Jak działa limit zapytań?
- Każda wiadomość użytkownika do Konsultanta liczy się jako jedno zapytanie.
- Gdy użytkownik osiągnie ustalony limit, widżet:
- wyświetla komunikat z informacją o limicie,
- zasugeruje dalszy kontakt mailowy lub telefoniczny, w zależności co napiszesz w instrukcji dla konsultanta.
Jak ustawić limit zapytań?
- Zaloguj się do panelu WordPress.
- Przejdź do: Virtual AI Consultant → Settings.
- Znajdź sekcję Query Limit per Session.
- Wpisz maksymalną liczbę zapytań, np.
5
lub10
. - Zapisz zmiany.
Przykład:
Jeśli ustawisz limit na 5
, użytkownik po wysłaniu piątego pytania otrzyma wiadomość np.:
„Dziękujemy za rozmowę! Niestety wyczerpałeś limit odpowiedzi.”
Dobre praktyki:
- Nie ustawiaj zbyt niskiego limitu – sugerowana wartość to minimum 3–5 zapytań.
- Możesz testować różne wartości limitu i sprawdzać w statystykach, które ustawienie konwertuje najlepiej.
Podsumowanie:
Query Limit per Session to praktyczne rozwiązanie, które zwiększa efektywność pracy Konsultanta AI i jednocześnie pomaga w zbieraniu leadów. Dobrze ustawiony limit pozwala na naturalną rozmowę, a po jego wyczerpaniu – na kontynuację przez kontakt bezpośredni.
Hide widget button on these pages – jak ukryć przycisk Konsultanta na wybranych stronach
Hide widget button on these pages to funkcja, która umożliwia ukrycie przycisku uruchamiającego Konsultanta AI na wybranych podstronach Twojej witryny.
Dzięki temu możesz w prosty sposób:
- nie pokazywać Konsultanta na stronach technicznych (np. koszyk, regulamin, polityka prywatności),
- wyłączyć przycisk na landing page’ach, gdzie używasz chatu tylko ręcznie (np. przez shortcode),
- zachować czystość wizualną na stronach z innymi elementami interaktywnymi.
Jak to działa?
- Po włączeniu opcji „Show main widget button” (czyli automatycznego przycisku), możesz wskazać strony, na których nie ma się on pojawiać.
- Wystarczy podać adresy URL (lub ich fragmenty), a system automatycznie wyłączy przycisk na tych podstronach.
Jak skonfigurować?
- Zaloguj się do panelu WordPress.
- Przejdź do: Virtual AI Consultant → Settings.
- W sekcji Hide widget button on these pages wpisz listę podstron, na których chcesz ukryć przycisk.
- Każdy adres wpisz w osobnej linii lub oddziel przecinkami.
- Zapisz zmiany.
Przykładowe wpisy:
/koszyk
/regulamin
/polityka-prywatnosci
/dziekujemy-za-zamowienie
Lub z pełnym adresem:
https://twojastrona.pl/koszyk
https://twojastrona.pl/polityka-prywatnosci
Dobre praktyki:
- Wystarczy wpisać fragment adresu, który jednoznacznie identyfikuje stronę.
- Nie używaj adresów dynamicznych (np. z parametrami GET), jeśli nie są stałe.
- Możesz ukryć widżet na stronach testowych lub ukrytych przed użytkownikiem końcowym.
Podsumowanie:
Funkcja „Hide widget button on these pages” daje Ci pełną kontrolę nad widocznością przycisku AI. Dzięki temu możesz dostosować jego obecność do kontekstu strony i nie przeszkadzać użytkownikowi w w kluczowych momentach (np. podczas płatności).
Google Analytics Integration – jak włączyć śledzenie działań użytkowników przez GA4
Google Analytics Integration to funkcja, która umożliwia integrację wtyczki Virtual AI Consultant z Twoim kontem Google Analytics 4. Dzięki temu możesz śledzić aktywność użytkowników związaną z Konsultantem AI – np. rozpoczęcie rozmowy, wysłanie wiadomości, zakończenie sesji i inne interakcje.
Dzięki temu możesz:
- analizować skuteczność Konsultanta AI w Google Analytics,
- ocenić, jak często użytkownicy korzystają z chatu na stronie,
- mierzyć konwersje wywołane przez rozmowę z AI,
- łatwo tworzyć lejki i raporty w GA4 na podstawie zdarzeń.
Jak to działa?
Wtyczka osadza automatycznie kod śledzący Google Analytics 4 tylko wtedy, gdy:
- użytkownik wyraził zgodę na cookies (np. przez baner RODO),
- zaznaczysz opcję „Enable Google Analytics integration”,
- wprowadzisz prawidłowy Measurement ID (np. G-XXXXXXX).
Wszystko działa w pełni zgodnie z przepisami o prywatności – bez zgody użytkownika żadne dane nie są wysyłane.
Jak skonfigurować?
- Zaloguj się do panelu WordPress.
- Przejdź do: Virtual AI Consultant → Settings.
- Zaznacz checkbox „Enable Google Analytics integration”.
- W polu „Google Analytics 4 ID” wpisz swój identyfikator (np.
G-ABC123XYZ9
). - Zapisz zmiany.
Skąd wziąć swój identyfikator?
- Zaloguj się na swoje konto Google Analytics.
- Przejdź do: Administracja → Strumienie danych.
- Wybierz swoją witrynę.
- Skopiuj Measurement ID (np.
G-XXXXXXX
).
Dobre praktyki:
- Zawsze testuj, czy integracja działa (np. przez GA Debugger lub podgląd w Google Tag Manager).
- Upewnij się, że Twoja polityka prywatności informuje o korzystaniu z GA4.
- Możesz łączyć dane z Konsultanta z innymi danymi ze strony (np. koszyk, zamówienia).
- Nie wpisuj ID testowego – używaj tylko oficjalnych danych produkcyjnych.
Podsumowanie:
Funkcja „Google Analytics Integration” pozwala połączyć Twojego Konsultanta AI z profesjonalnym systemem analitycznym Google. To idealne rozwiązanie, jeśli chcesz mierzyć realny wpływ AI na sprzedaż, zachowania klientów i skuteczność automatyzacji.
System Prompt for Assistant – jak ustawić charakter i zasady działania AI
System Prompt for Assistant to jedno z najważniejszych ustawień Konsultanta AI. Pozwala ono określić, jak ma się zachowywać, w jaki sposób odpowiadać oraz na czym opierać swoje wypowiedzi.
To właśnie ten prompt definiuje, jak AI będzie się komunikować z użytkownikami: czy ma być formalny, pomocny, rzeczowy, czy może bardziej swobodny i kreatywny.
Czym jest „System Prompt”?
- To tekst, który Konsultant otrzymuje przed każdą rozmową z użytkownikiem.
- Zawiera instrukcje, jak powinien działać, do czego ma dostęp i jakie zasady ma stosować.
- Nie jest widoczny dla użytkownika końcowego.
Jak ustawić prompt?
- Zaloguj się do WordPressa.
- Przejdź do: Virtual AI Consultant → Settings.
- W sekcji System Prompt for Assistant wpisz tekst opisujący zachowanie Konsultanta.
- Zapisz zmiany.
Przykładowy system prompt (uniwersalny):
Jesteś uprzejmym, pomocnym i konkretnym asystentem AI. Odpowiadasz jasno, bez zbędnych informacji. Zawsze kierujesz się danymi z Bazy Wiedzy lub katalogu XML, jeśli są dostępne. Jeśli czegoś nie wiesz, informujesz o tym i proponujesz kontakt z działem obsługi. Używasz języka dostosowanego do branży ... Jeśli to możliwe, podajesz linki do produktów lub dokumentów. Gdy rozmowa dotyczy zamówienia, zachęcasz do kontaktu przez formularz lub do zakupu w sklepie.
Wskazówki przy pisaniu własnego promptu:
- Opisz charakter asystenta (formalny, bezpośredni, wesoły, rzeczowy itp.).
- Wskaż źródła, z których może korzystać (pliki tekstowe Bazy wiedzy, XML, WooCommerce lub ich połączenia).
- Określ styl odpowiedzi (krótkie, konkretne, z linkami, bez dygresji).
- Dodaj reakcję na brak danych („Nie mam tych informacji, ale mogę pomóc w inny sposób”).
- Możesz też zdefiniować język, który ma być domyślnie używany.
- Dodaj zastrzeżenie, że ma używać wyłącznie wiedzy z Bazy danych.
Dobre praktyki:
- Unikaj zbyt ogólnych opisów typu „Bądź pomocny” – AI potrzebuje konkretnych wytycznych.
- Zadbaj o spójność z wizerunkiem Twojej firmy – inaczej będzie mówić doradca w salonie kosmetycznym, a inaczej konsultant w sklepie B2B.
- Testuj różne wersje promptu i sprawdzaj, która daje najlepsze rezultaty.
- Pomocna jest analiza rozmów i testowanie.
Podsumowanie:
System Prompt to serce Twojego Konsultanta AI – to właśnie tam definiujesz jego osobowość, sposób działania i priorytety. Dobrze sformułowany prompt sprawia, że rozmowy są trafniejsze, bardziej użyteczne i lepiej dopasowane do potrzeb Twojej firmy.
Product data source – jak ustawić, skąd Konsultant AI pobiera informacje o produktach
Pole Product data source pozwala zdecydować, skąd Konsultant AI będzie czerpał wiedzę o Twojej ofercie: o produktach, cenach, wariantach i terminach realizacji.
To jedno z kluczowych ustawień, które wpływa na trafność odpowiedzi AI – szczególnie, gdy użytkownik pyta o konkretny produkt, wariant lub usługę.
Dostępne opcje:
- Tylko WooCommerce
Konsultant korzysta wyłącznie z danych dostępnych w produktach WooCommerce (nazwa, opis, cena, kategorie).
Idealne, jeśli masz pełną ofertę w sklepie online.
Konsultant widzi produkty, które mogą być wyszukane w sklepie w polu „wyszukaj” - Tylko pliki tekstowe (product_info.json i inne)
- Źródłem wiedzy są ręcznie wprowadzony pliki tekstowe.
- Sprawdza się, jeśli Twoja oferta jest niestandardowa lub chcesz przekazać dodatkowe informacje, np. w pliku tekstowym pokazujesz produkty z nadrukiem (tabela cennika, opis sposobu obliczania, opis produktów)
- Tylko XML
- Konsultant wykorzystuje dane z pliku XML (np. wygenerowanego z zewnętrznego systemu) oraz analizuje treść za pomocą tzw. embeddingów (wektorów semantycznych). Plik XML możesz wygenerować z WooCommerce i podac ścieżke. Plik XML jest aktualizowany automatycznie po każdej zmianie w sklepie.
- Dobrze działa przy dużych katalogach, gdzie istotne są opisy techniczne lub cechy produktów.
- Pliki tekstowe + XML
- Konsultant łączy dane z plików tekstowych i pliku XML, aby odpowiadać trafniej.
- To tryb rekomendowany dla firm z rozbudowaną ofertą.
- WooCommerce + Pliki tekstowe
- AI korzysta zarówno z bazy WooCommerce, jak i ręcznie wprowadzonych danych z plików tekstowych.
- Praktyczne, gdy część informacji masz w sklepie, a inne np. w cennikach lub opisach ofertowych.
- WooCommerce + Pliki tekstowe + XML (tryb hybrydowy)
- Pełne połączenie trzech źródeł: dane sklepu, baza wiedzy JSON i katalog XML.
- Rekomendowany dla firm z różnymi kanałami sprzedaży, gdzie każdy klient może pytać w inny sposób.
Jak wybrać źródło?
- Zaloguj się do WordPress.
- Przejdź do: Virtual AI Consultant → Settings lub Knowledge Base.
- Znajdź sekcję Product Data Source.
- Z rozwijanej listy wybierz odpowiedni tryb.
- Zapisz zmiany.
Dobre praktyki:
- Jeśli prowadzisz sklep WooCommerce – zacznij od trybu „WooCommerce” lub „WooCommerce + JSON”.
- Jeśli masz tylko XML – wybierz „Tylko XML + Pliki tekstowe”. Dla sklepów polecamy tą wersję. Korzystamy z wygenerowanego z WooCommerce pliku XML i plików tekstowych – to jest najbardziej precyzyjne i wydajne wyszukiwanie
- Dla maksymalnej dokładności – używaj trybu hybrydowego (JSON + XML lub pełnego połączenia).
- Plik
tekstowe
orazXML
możesz edytować i aktualizować w zakładce Knowledge Base.
Podsumowanie:
Dobrze dobrane źródło danych produktowych decyduje o tym, jak trafnie i szczegółowo AI będzie odpowiadać klientom na pytania o produkty. Wtyczka pozwala łączyć różne źródła, aby maksymalnie dopasować się do specyfiki Twojej firmy.
Use XML Embeddings? – jak wykorzystać dane produktowe z pliku XML
Opcja Use XML Embeddings? pozwala Konsultantowi AI przeszukiwać dane z pliku XML za pomocą technologii embeddingów, czyli tzw. wektorów semantycznych. To zaawansowane rozwiązanie, które umożliwia bardziej trafne i kontekstowe odpowiedzi na pytania o produkty.
Dzięki embeddingom Konsultant nie przeszukuje pliku „słowo w słowo”, tylko analizuje jego sens – rozpoznaje, co użytkownik ma na myśli, i potrafi dopasować odpowiedni produkt, nawet jeśli pytanie jest nieprecyzyjne.
Jak działa?
- Plik XML z ofertą jest przetwarzany i zamieniany na zestaw wektorów (embeddingów).
- Podczas rozmowy AI porównuje treść pytania użytkownika z tymi embeddingami.
- Konsultant zwraca najbardziej trafne fragmenty opisu produktu, ceny, dostępności itp.
- Nie musisz ręcznie pisać reguł ani tworzyć zapytań SQL.
Jak włączyć opcję XML Embeddings?
- Zaloguj się do panelu WordPress.
- Przejdź do: Virtual AI Consultant → Knowledge Base.
- Zaznacz opcję Use XML Embeddings.
- W polu Ścieżka do pliku XML wskaż lokalizację pliku (np. z feeda WooCommerce lub systemu ERP).
- Kliknij Zapisz zmiany.
- Kliknij Generate Embeddings, aby przetworzyć dane z pliku XML na embeddingi.
Kiedy warto używać?
- Gdy masz obszerny katalog produktów w formacie XML (np. eksport z systemu).
- Gdy chcesz, aby AI potrafił trafnie odpowiadać na pytania typu: „Czy macie torby papierowe 26x12x34 w kolorze czarnym?”.
- Gdy dane w XML są bardziej aktualne niż w bazie WooCommerce.
Wymagania:
- Plik XML nie powinien przekraczać limitu 10 MB.
- Musi zawierać czytelne opisy, nazwy produktów, ceny, opcjonalnie: terminy, linki.
- Wtyczka automatycznie tworzy embeddingi po kliknięciu przycisku lub według harmonogramu.
Dobre praktyki:
- Aktualizuj XML codziennie lub przy każdej zmianie w ofercie, jeżeli plik XML nie aktualizuje sie automatycznie.
- Używaj pliku XML jako głównego lub uzupełniającego źródła wiedzy (możesz łączyć z plikami tekstowymi).
- Unikaj nazw kolumn typu
a1
,cena_1
, zamiast tego używaj opisowych nazw (title
,price
,description
,link
).
Podsumowanie:
Use XML Embeddings? to bardzo efektywne i nowoczesne rozwiązanie do obsługi zapytań produktowych w sklepach i firmach z rozbudowaną ofertą. Dzięki embeddingom Konsultant AI może trafnie odpowiadać nawet na skomplikowane pytania – tak, jakby naprawdę „rozumiał” dane produktowe.
Max number of matched products – ile produktów może zaproponować Konsultant AI
Max number of matched products to ustawienie, które pozwala ograniczyć liczbę produktów, jakie Konsultant AI może przedstawić użytkownikowi w jednej odpowiedzi.
Funkcja ta jest szczególnie przydatna, gdy:
- masz dużą bazę produktów,
- chcesz uniknąć przeładowania odpowiedzi zbyt długą listą,
- zależy Ci na szybkich i konkretnych sugestiach.
- chcesz ograniczyć koszty integracji z modelem AI
Jak to działa?
- Gdy użytkownik zada pytanie, np. „Jakie torby macie w rozmiarze 26x12x34?”, Konsultant przeszuka bazę danych i wybierze maksymalnie np. 1 lub 2 najlepiej pasujących produktów.
- Produkty są prezentowane w formie listy lub krótkich opisów, często z linkami do szczegółów.
Jak ustawić maksymalną liczbę produktów?
- Zaloguj się do WordPressa.
- Przejdź do: Virtual AI Consultant → Settings.
- Znajdź sekcję Max number of matched products.
- Wprowadź wartość liczbową, np.
1
,2
,3
. - Zapisz zmiany.
Rekomendowane wartości:
- 1 – jeśli chcesz dawać krótką, konkretną odpowiedź.
- 2 – dobry kompromis między szczegółowością a długością odpowiedzi.
- 5 – dla dużych katalogów i użytkowników oczekujących większego wyboru.
Dobre praktyki:
- Im większa liczba produktów, tym dłuższa odpowiedź – zadbaj o czytelność.
- Jeśli oferujesz podobne produkty w wielu wariantach (np. kolor, format), warto ograniczyć liczbę wyników, by uniknąć chaosu.
- Możesz połączyć to z komunikatem typu: „Poniżej najtrafniejsze propozycje – jeśli potrzebujesz więcej, zapraszam do katalogu”.
Przykładowa odpowiedź:
Znaleziono 3 torby pasujące do zapytania: – Torba Eco 26x12x34 cm, czarna – [zobacz produkt]
– Torba Lux 26x12x34 cm, biała z uchwytem – [zobacz produkt]
– Torba z nadrukiem własnym, 26x12x34 cm – [więcej informacji]
Podsumowanie:
Dzięki polu Max number of matched products masz kontrolę nad tym, jak obszerną odpowiedź generuje AI przy pytaniach produktowych. To pomaga zachować równowagę między trafnością a przejrzystością – i zwiększa szansę, że użytkownik kliknie w proponowaną ofertę.
Company information (company_info.json) – jak wprowadzić dane o firmie
Pole Company information (company_info.json) służy do ręcznego wpisania najważniejszych informacji o firmie, które Konsultant AI ma wykorzystywać w swoich odpowiedziach. Dane te są automatycznie uwzględniane w odpowiedziach, gdy użytkownik zapyta np. o lokalizację firmy, dane kontaktowe, historię, certyfikaty czy inne ogólne informacje.
To bardzo ważny element bazy wiedzy, zwłaszcza jeśli zależy Ci na spójnej i profesjonalnej prezentacji firmy podczas rozmów.
Jak dodać informacje o firmie?
- Zaloguj się do panelu WordPress.
- Przejdź do: Virtual AI Consultant → Knowledge Base.
- Znajdź sekcję Company information (company_info.json).
- Wprowadź dane w formacie tekstowym – mogą to być pełne akapity lub punktory.
- Zapisz dane klikając Save Knowledge Base.
Jakie informacje warto podać?
- Nazwa firmy (pełna i skrócona)
- Rok założenia
- Branża i główne usługi / produkty
- Adres siedziby i oddziałów
- Adresy e-mail i numery telefonów kontaktowych
- Godziny pracy biura i działu obsługi
- Certyfikaty, nagrody, uprawnienia
- Obszar działania (lokalny, ogólnopolski, międzynarodowy)
Przykład danych (do wpisania w polu):
XYZ to polska firma z siedzibą w Warszawie, specjalizująca się w produkcji opakowań papierowych z nadrukiem. Działamy od 2010 roku, obsługując klientów B2B i detalicznych. Nasz zakład produkcyjny znajduje się pod Warszawą. Obsługujemy klientów z całej Polski i krajów UE. Wyróżnia nas szybki czas realizacji i wysoka jakość nadruku. Biuro obsługi klienta pracuje od poniedziałku do piątku, w godzinach 8:00–16:00. Nasze certyfikaty: FSC®, ISO 9001.
Dobre praktyki:
- Używaj zwięzłych, ale treściwych opisów – AI nie potrzebuje pełnej historii firmy, tylko kluczowych danych.
- Zadbaj o aktualność – jeśli zmieniają się godziny pracy, numery kontaktowe, adresy, zaktualizuj pole.
- Jeśli firma ma kilka oddziałów lub marek – podaj wszystkie, aby AI rozróżniał odpowiedzi.
Kiedy Konsultant korzysta z tych danych?
- Gdy użytkownik pyta: „Gdzie znajduje się Wasza firma?”, „Kiedy pracujecie?”, „Od kiedy działacie?”, „Jak się z Wami skontaktować?”,
- Gdy trzeba dodać kontekst do zamówienia lub zapytania (np. „czy jesteście producentem czy pośrednikiem?”).
Podsumowanie:
Dzięki danym w company_info.json Konsultant AI może wiarygodnie i profesjonalnie reprezentować Twoją firmę w rozmowach z klientami. To pierwszy krok do zbudowania spójnego i zaufanego wizerunku marki.
Pricelists (price_lists.json) – jak wprowadzić dane o cenach
Pole Pricelists (price_lists.json) służy do wpisania cenników lub zasad wyceny, które Konsultant AI może wykorzystywać podczas rozmów z użytkownikami. Pozwala to na szybkie i automatyczne udzielanie informacji o kosztach, wariantach i minimalnych zamówieniach bez potrzeby przeszukiwania całej strony.
To szczególnie przydatne, jeśli:
- nie używasz WooCommerce,
- masz indywidualne lub hurtowe warunki cenowe,
- oferujesz produkty, których cena zależy od wielu czynników (np. format, ilość, nadruk).
Jak dodać cenniki?
- Zaloguj się do panelu WordPress.
- Przejdź do: Virtual AI Consultant → Knowledge Base.
- Znajdź sekcję Pricelists (price_lists.json).
- Wpisz dane tekstowe – mogą to być gotowe tabele, listy cen lub zasady wyceny.
- Zapisz zmiany klikając Save Knowledge Base.
Co warto wpisać?
- Przedziały ilościowe i ceny jednostkowe
- Minimalne zamówienia
- Koszty dodatkowe (np. nadruk, przygotowalnia, transport)
- Informacje o rabatach, promocjach
- Czas realizacji zależny od ilości
Przykład danych (do wpisania w polu):
Torby papierowe (format 26x12x34 cm):
- 50–100 szt.: 3,90 zł/szt.
- 101–500 szt.: 3,50 zł/szt.
- 501–1000 szt.: 2,90 zł/szt.
- Powyżej 1000 szt.: indywidualna wycena
Nadruk: 1 kolor: 0,78 zł, lub tabela ilościowa
Koszt przygotowalni: 150 zł netto
Czas realizacji: 5–10 dni roboczych od zatwierdzenia projektu graficznego
Kiedy Konsultant korzysta z tych danych?
- Gdy użytkownik pyta: „Ile kosztuje 500 sztuk?”, „Jaki jest koszt torby z nadrukiem?”, „Czy są rabaty?”,
- Gdy AI analizuje podaną ilość i dopasowuje do odpowiedniego progu cenowego.
Dobre praktyki:
- Podawaj ceny w przejrzystej formie (listy punktowane, tabele tekstowe).
- Nie wpisuj dużej ilości szczegółów w jednym ciągu – AI lepiej działa, gdy dane są jasno rozdzielone.
- Jeśli masz wiele formatów, możesz podzielić dane na sekcje.
Podsumowanie:
Dzięki polu price_lists.json Konsultant AI może szybko i trafnie odpowiadać na pytania o ceny – bez potrzeby kontaktu z biurem. To oszczędność czasu dla Ciebie i wygoda dla klienta.
FAQ (faq.json) – jak wprowadzić najczęstsze pytania i odpowiedzi
Pole FAQ (faq.json) pozwala dodać listę najczęściej zadawanych pytań (Frequently Asked Questions) wraz z odpowiedziami. Dzięki temu Konsultant AI może szybko i trafnie odpowiadać na powtarzające się zapytania użytkowników, bez potrzeby analizy całej bazy wiedzy.
Funkcja ta oszczędza czas i poprawia jakość obsługi klienta – użytkownicy dostają gotową, sprawdzoną odpowiedź.
Jak uzupełnić FAQ?
- Zaloguj się do panelu WordPress.
- Przejdź do: Virtual AI Consultant → Knowledge Base.
- Znajdź pole FAQ (faq.json).
- Wpisz listę pytań i odpowiedzi – najlepiej w formacie:
- Pytanie 1 → Odpowiedź 1
- Pytanie 2 → Odpowiedź 2
- Kliknij Save Knowledge Base, aby zapisać zmiany.
Co warto wpisać?
Najlepiej sprawdzają się pytania i odpowiedzi typu:
- Jakie są godziny pracy firmy?
- Jak długo trwa realizacja zamówienia?
- Czy oferujecie nadruk na produktach?
- Jakie są minimalne ilości zamówienia?
- Czy mogę zamówić próbki?
- Czy są zwroty?
- Czy jest darmowa dostawa?
Przykład wpisu:
Pytanie: Jakie są godziny pracy firmy?
Odpowiedź: Nasze biuro jest otwarte od poniedziałku do piątku, w godzinach 8:00–16:00.
Pytanie: Jaki jest czas realizacji zamówienia?
Odpowiedź: Standardowy czas realizacji to 5–10 dni roboczych od momentu zatwierdzenia projektu graficznego.
Pytanie: Czy torby są ekologiczne?
Odpowiedź: Tak, nasze torby są wykonane z papieru kraftowego z certyfikatem FSC®.
Dobre praktyki:
- Każde pytanie i odpowiedź wpisz w osobnej sekcji – unikaj bloków tekstu.
- Używaj prostego, jasnego języka – AI przetwarza dane szybciej i skuteczniej.
- Ogranicz liczbę odpowiedzi do 10–20 – wybierz te, które naprawdę się powtarzają.
- Regularnie aktualizuj wpisy w razie zmian (np. ceny, terminy, warunki realizacji).
Kiedy AI korzysta z FAQ?
- Gdy pytanie użytkownika dokładnie lub częściowo pokrywa się z zapisanym pytaniem w bazie.
- Gdy w innych źródłach (WooCommerce, JSON, XML) nie ma dopasowanej odpowiedzi.
- Gdy użytkownik zaczyna od ogólnego pytania typu: „Jak to działa?”, „Ile kosztuje?” itp.
Podsumowanie:
Pole faq.json to szybki sposób na zwiększenie skuteczności Konsultanta AI w odpowiadaniu na powtarzalne pytania.
Order fulfillment terms (order_terms.json) – warunki realizacji zamówień
Pole Order fulfillment terms (order_terms.json) służy do wpisania wszystkich zasad i informacji związanych z realizacją zamówień – takich jak czas produkcji, warunki dostawy, formy płatności, minimalne ilości, akceptacja projektów, reklamacje itp.
Dzięki temu Konsultant AI może trafnie i spójnie informować klientów o tym, jak przebiega proces realizacji zamówienia.
Jak uzupełnić warunki realizacji?
- Zaloguj się do panelu WordPress.
- Przejdź do: Virtual AI Consultant → Knowledge Base.
- Znajdź pole Order fulfillment terms (order_terms.json).
- Wpisz warunki w formacie tekstowym – najlepiej jako listę lub podzielone akapity.
- Kliknij Save Knowledge Base, aby zapisać zmiany.
Co warto uwzględnić?
- Warunki przygotowania pliku do druku
- Koszty transportu i opcje dostawy
- Formy płatności (przedpłata, faktura z terminem, pobranie)
- Zasady reklamacji i zwrotów
- Godziny kontaktu z działem zamówień
Przykład treści do wpisania:
Czas realizacji: 5–10 dni roboczych od momentu zatwierdzenia projektu graficznego.
Dostawa: Kurier DPD lub odbiór własny. Koszt transportu ustalany indywidualnie.
Płatność: przelew przedpłata, faktura terminowa dla stałych klientów.
Projekty graficzne: Wymagany plik PDF w wersji wektorowej (CMYK). Na życzenie przygotujemy projekt graficzny (koszt: 120 zł netto).
Reklamacje: Tylko w przypadku niezgodności z zatwierdzonym projektem. Termin zgłoszenia: do 3 dni od otrzymania towaru.
Kiedy Konsultant używa tych danych?
- Gdy użytkownik pyta: „Ile trwa realizacja?”, „Jaka jest minimalna ilość?”, „Jak wysyłacie produkty?”, „Czy mogę zapłacić przy odbiorze?”.
- Gdy nie ma tych informacji w bazie WooCommerce, ale są kluczowe w procesie zakupowym.
Dobre praktyki:
- Używaj jasnego języka – bez skrótów i wewnętrznych oznaczeń.
- Unikaj zbyt dużych bloków tekstu – podziel informacje według tematów.
- Regularnie aktualizuj dane – np. czas realizacji, formy płatności.
Podsumowanie:
Pole order_terms.json zapewnia Konsultantowi AI wszystkie niezbędne informacje dotyczące warunków realizacji zamówień. To kluczowy element profesjonalnej obsługi klienta – szczególnie przy zapytaniach B2B lub zamówieniach niestandardowych.
XML Product File Path for Embeddings – jak podłączyć plik XML z ofertą produktową
XML Product File Path for Embeddings to pole, w którym podajesz pełną ścieżkę lub adres URL do pliku XML zawierającego dane o Twoich produktach. Ten plik jest używany do generowania embeddingów – tzn. przetwarzany na wektory semantyczne, które Konsultant AI wykorzystuje do rozpoznawania i dopasowywania treści zapytań użytkowników.
Jak działa integracja z XML?
- Wtyczka pobiera plik XML z podanego adresu (lokalnego lub zdalnego).
- Analizuje dane w nim zawarte (np. nazwa, opis, cena, link).
- Tworzy embeddingi, które są wykorzystywane do precyzyjnych odpowiedzi AI na pytania o produkty.
- Aktualizacja danych odbywa się ręcznie (przycisk „Generate Embeddings”) lub automatycznie.
Jak wprowadzić ścieżkę do pliku XML?
- Zaloguj się do WordPressa.
- Przejdź do: Virtual AI Consultant → Knowledge Base.
- Znajdź pole XML Product File Path for Embeddings.
- Wklej pełny adres URL (np.
https://twojastrona.pl/feed/produkty.xml
) lub ścieżkę lokalną (np./wp-content/uploads/feed.xml
). - Zapisz zmiany klikając Save Knowledge Base.
- Kliknij Generate Embeddings, aby rozpocząć przetwarzanie danych.
Przykładowy adres:
https://www.twojafirma.com/xml-feed/produkty.xml
Wymagania techniczne dla pliku XML:
- Maksymalny rozmiar: 10 MB
- Struktura zgodna z logiką produktową (np. elementy:
<product>
,<title>
,<description>
,<price>
,<url>
) - Każdy produkt w osobnym węźle XML
- Czytelne dane tekstowe – AI analizuje treść, a nie tylko nazwy pól
Dobre praktyki:
- Upewnij się, że plik jest zawsze dostępny pod tym samym adresem.
- Używaj automatycznej aktualizacji przez
wp_cron
, jeśli oferta często się zmienia. - Możesz wygenerować plik XML np. w narzędziu „Product Feed PRO for WooCommerce”.
- Nie wpisuj tu linków do plików PDF ani niekompletnych feedów – embeddingi muszą mieć czysty tekst.
Kiedy Konsultant używa tych danych?
- Gdy użytkownik pyta o konkretne produkty, cechy, warianty, ceny, dostępność itp.
- Gdy inne źródła (WooCommerce, JSON) nie zawierają wystarczającej ilości informacji.
- Gdy masz bardzo szczegółowy katalog produktów eksportowany z zewnętrznego systemu (ERP, CRM).
Podsumowanie:
Dzięki polu XML Product File Path for Embeddings możesz zintegrować z Konsultantem AI pełną, aktualną ofertę produktową bez potrzeby ręcznego przepisywania danych. To rozwiązanie idealne dla firm, które posiadają własne feedy produktowe lub korzystają z zewnętrznych systemów e-commer.
Embedding Model – wybór modelu do przetwarzania danych produktowych
Embedding Model to ustawienie, które określa, jakiego modelu sztucznej inteligencji użyje wtyczka do generowania tzw. embeddingów – specjalnych matematycznych reprezentacji tekstów, używanych do wyszukiwania najbardziej dopasowanych informacji w bazie wiedzy lub pliku XML.
Embeddingi są sercem systemu odpowiedzi AI – to dzięki nim Konsultant może „zrozumieć”, co użytkownik ma na myśli, nawet jeśli pytanie jest zadane w inny sposób niż dane w bazie.
Jak działa wybór embedding modelu?
- Wtyczka łączy się z wybranym dostawcą AI (np. OpenAI) i generuje embeddingi dla każdego fragmentu danych (np. opis produktu, sekcja FAQ, cena).
- Embeddingi są zapisywane lokalnie i wykorzystywane podczas każdej rozmowy z użytkownikiem.
- Im lepszy model embeddingów, tym trafniejsze dopasowanie treści i lepsze odpowiedzi.
Gdzie ustawić model embeddingu?
- Zaloguj się do WordPressa.
- Przejdź do: Virtual AI Consultant → Knowledge Base.
- Znajdź pole Embedding Model.
- Z rozwijanej listy wybierz jeden z dostępnych modeli.
- Zapisz zmiany klikając Save Knowledge Base.
Najczęściej dostępne modele:
Model | Dostawca | Zalety | Uwagi |
---|---|---|---|
text-embedding-ada-002 | OpenAI | Szybki, tani, dobry do wyszukiwań | Idealny wybór dla większości stron |
text-embedding-3-small | OpenAI | Bardziej precyzyjny, nowoczesny model | Nieco droższy, ale lepiej rozumie kontekst |
text-embedding-3-large | OpenAI | Najdokładniejszy model z serii | Rekomendowany dla dużych katalogów |
Kiedy warto zmienić model?
- Gdy masz duży katalog produktów (np. 1000+ pozycji) i chcesz maksymalnej trafności.
- Gdy użytkownicy zadają bardzo złożone pytania, które wymagają lepszego zrozumienia kontekstu.
- Gdy korzystasz z darmowego limitu API i chcesz obniżyć koszty – wybierz model
text-embedding-ada-002
.
Dobre praktyki:
- Testuj różne modele, jeśli odpowiedzi AI nie są wystarczająco trafne.
- Przy dużych plikach XML zawsze używaj modelu obsługującego długie teksty.
- Pamiętaj, że embeddingi są generowane na nowo po każdej zmianie danych lub kliknięciu „Generate Embeddings”. Nie sa generowane te, które zostały wcześnie wygenerowane.
Podsumowanie:
Embedding Model decyduje o tym, jak dobrze Konsultant AI rozumie pytania użytkowników i dopasowuje do nich fragmenty wiedzy. Wybór odpowiedniego modelu to klucz do skutecznych i trafnych rozmów – zwłaszcza w przypadku katalogów produktowych, dokumentacji lub zapytań technicznych.
Embedding Schedule – Days
Automatyczne odnawianie bazy embeddingów
Pole Embedding Schedule – Days umożliwia ustalenie konkretnych dni tygodnia, w które system automatycznie wygeneruje nowe embeddingi z pliku XML. Dzięki temu Konsultant AI zawsze korzysta z aktualnych danych produktowych – bez potrzeby ręcznego klikania przycisku „Generate Embeddings”.
Funkcja ta jest szczególnie przydatna, jeśli:
- Twoja oferta często się zmienia (np. codzienne aktualizacje magazynowe),
- Plik XML z produktami jest aktualizowany przez system zewnętrzny (ERP, WooCommerce Feed),
- Chcesz mieć pewność, że AI zawsze ma najnowsze dane bez Twojej ingerencji.
Jak ustawić dni automatycznego generowania embeddingów?
- Zaloguj się do WordPressa.
- Przejdź do: Virtual AI Consultant → Knowledge Base.
- Znajdź pole Embedding Schedule – Days.
- Zaznacz odpowiednie dni tygodnia, np. Mon, Wed, Fri.
- Zapisz ustawienia klikając Save Knowledge Base.
Dni, które możesz wybrać:
Mon
– poniedziałekTue
– wtorekWed
– środaThu
– czwartekFri
– piątekSat
– sobotaSun
– niedziela
Możesz wybrać dowolną kombinację – np. tylko poniedziałki i piątki, jeśli plik XML aktualizujesz ręcznie raz na tydzień.
Dobre praktyki:
- Jeśli używasz zewnętrznego systemu do aktualizacji XML – upewnij się, że harmonogram pokrywa się z aktualizacją feeda.
- Nie wybieraj zbyt często (np. codziennie), jeśli dane w XML nie zmieniają się tak często – to może obciążać API.
- Jeśli aktualizujesz XML raz w tygodniu – wystarczy wybrać jeden dzień.
Co się stanie, gdy dzień jest zgodny z harmonogramem?
- System automatycznie sprawdzi plik XML.
- Jeśli plik jest dostępny i poprawny – wygeneruje nowe embeddingi.
- AI będzie od tego momentu korzystać z najnowszych danych.
Podsumowanie:
Embedding Schedule – Days pozwala w pełni zautomatyzować aktualizację danych produktowych w systemie AI. Dzięki temu masz pewność, że Twoi klienci zawsze otrzymają odpowiedź opartą na najnowszej wersji oferty – bez konieczności codziennego logowania się do panelu.
Embedding Schedule – Hour
Automatyczna godzina generowania embeddingów
Pole Embedding Schedule – Hour określa godzinę, o której system ma automatycznie wygenerować nowe embeddingi z pliku XML (jeśli dany dzień tygodnia został zaznaczony w polu Embedding Schedule – Days).
To idealne rozwiązanie, jeśli Twoja oferta jest codziennie lub cyklicznie aktualizowana – np. przez system ERP lub WooCommerce – i chcesz, aby Konsultant AI automatycznie korzystał z najnowszych danych.
Jak ustawić godzinę generowania embeddingów?
- Zaloguj się do WordPressa.
- Przejdź do: Virtual AI Consultant → Knowledge Base.
- Znajdź pole Embedding Schedule – Hour.
- Wybierz godzinę z rozwijanej listy (np.
03:00
,06:00
,12:00
,18:00
). - Zapisz zmiany klikając Save Knowledge Base.
Godzina odnosi się do strefy czasowej ustawionej w WordPressie (Ustawienia → Ogólne → Strefa czasowa).
Przykład:
Jeśli ustawisz:
- Dni: Mon, Wed, Fri
- Godzina: 04:00
To nowa baza embeddingów zostanie wygenerowana automatycznie w poniedziałek, środę i piątek o 4:00 rano.
Dobre praktyki:
- Wybierz godziny, w których strona ma najmniejszy ruch (np. noc lub wczesny ranek).
- Upewnij się, że plik XML jest aktualny przed tą godziną (jeśli jest tworzony automatycznie).
- W przypadku błędów (np. brak dostępu do XML) system nie nadpisze istniejących embeddingów – warto je wtedy wygenerować ręcznie.
Kiedy to ustawienie działa?
- Tylko jeśli włączona jest opcja Use XML Embeddings.
- I jeśli został ustawiony poprawny adres pliku XML.
- I jeśli określono również dni tygodnia w polu Embedding Schedule – Days.
Podsumowanie:
Embedding Schedule – Hour pozwala precyzyjnie określić, kiedy system ma automatycznie aktualizować bazę embeddingów. To ważne, jeśli chcesz, by Konsultant AI zawsze korzystał z najbardziej aktualnych danych – bez potrzeby ręcznego działania z Twojej strony.
Przycisk „Save Knowledge Base”
Zapis danych w bazie wiedzy Konsultanta AI
Save Knowledge Base to główny przycisk służący do zapisania wszystkich informacji wprowadzonych w sekcji Knowledge Base. Po kliknięciu:
- Dane wpisane w polach tekstowych (company_info.json, product_info.json, price_lists.json, faq.json, order_terms.json, misc.json) zostają zapisane lokalnie.
- Konsultant AI zaczyna korzystać z nowej wiedzy przy kolejnych odpowiedziach.
- Jeśli używasz wyłącznie wiedzy tekstowej (bez WooCommerce lub XML), to ten plik jest podstawowym źródłem informacji.
Kiedy należy kliknąć „Save Knowledge Base”?
- Po każdej zmianie w którymkolwiek z 6 pól wiedzy.
- Gdy dodajesz nowe informacje o produktach, firmie, cennikach lub FAQ.
- Po aktualizacji informacji o warunkach realizacji lub polityce działania.
- Jeśli zmieniłeś dane wprowadzone ręcznie i chcesz, by Konsultant natychmiast je uwzględnił.
Częste pytania:
Czy dane są zapisywane automatycznie?
Nie – dane z Knowledge Base zapisują się dopiero po kliknięciu przycisku „Save Knowledge Base”.
Czy można nadpisać wiedzę kilkukrotnie?
Tak – każdorazowe zapisanie nadpisuje poprzedni plik.
Czy przycisk uruchamia generowanie embeddingów XML?
Nie – do tego służy osobny przycisk Generate Embeddings, dostępny poniżej, jeśli masz ustawiony plik XML.
Podsumowanie:
Save Knowledge Base to podstawowy przycisk zapisujący całą ręcznie wpisaną wiedzę Konsultanta AI. Dzięki niemu masz pełną kontrolę nad tym, co AI wie i jak odpowiada na pytania użytkowników.
Przycisk „Reload JSON Knowledge Files”
Szybkie przeładowanie wiedzy Konsultanta AI
Reload JSON Knowledge Files to przycisk, który umożliwia ręczne odświeżenie bazy wiedzy Konsultanta AI na podstawie wcześniej zapisanych plików tekstowych (company_info.json
, product_info.json
, price_lists.json
, faq.json
, order_terms.json
, misc.json
).
Jest to przydatne w sytuacjach, gdy:
- Pliki tekstowe zostały zmodyfikowane
- Chcesz odświeżyć bazę wiedzy bez ponownego wypełniania formularzy w panelu WordPress.
- Wystąpił błąd ładowania danych i chcesz wymusić ponowne przetworzenie plików.
Co robi przycisk?
- Wczytuje wszystkie zapisane wcześniej pliki tekstowe.
- Tworzy z nich jeden wspólny kontekst wiedzy.
- Przypisuje ten kontekst do Konsultanta AI (wykorzystywany przy kolejnych odpowiedziach).
Kiedy używać?
- Po ręcznej edycji plików
- Gdy dane zniknęły z odpowiedzi Konsultanta mimo wcześniejszego zapisu.
- Po aktualizacji WordPressa lub wtyczki, jeśli wystąpiły problemy z odczytem plików.
Dobre praktyki:
- Jeśli dane zostały wprowadzone w panelu, zawsze klikaj najpierw Save Knowledge Base.
- Nie używaj tego przycisku, jeśli chcesz nadpisać dane – on tylko wczytuje istniejące pliki.
Różnica między „Save Knowledge Base” a „Reload JSON Knowledge Files”:
Funkcja | Save Knowledge Base | Reload JSON Knowledge Files |
---|---|---|
Zapisuje dane z formularza | ✔ | ✘ |
Tworzy/aktualizuje plik | ✔ | ✘ – tylko odczytuje |
Odświeża kontekst AI | ✔ | ✔ |
Działa na plikach JSON | tworzy | ładuje ponownie |
Podsumowanie:
Przycisk Reload JSON Knowledge Files pozwala szybko załadować do Konsultanta AI najnowsze dane z plików JSON, bez potrzeby ponownego wypełniania formularzy. To narzędzie techniczne, przydatne szczególnie przy pracy z dużymi bazami wiedzy i integracjach zewnętrznych.
Przycisk „Generate Embeddings from XML Now”
Ręczne tworzenie embeddingów na podstawie pliku XML
Generate Embeddings from XML Now to przycisk, który pozwala ręcznie wygenerować tzw. embeddingi (wektory semantyczne) z wcześniej wskazanego pliku XML zawierającego dane o produktach. Embeddingi te są wykorzystywane przez Konsultanta AI do dopasowywania odpowiedzi do zapytań użytkowników.
To kluczowe narzędzie, jeśli:
- Korzystasz z własnego feedu produktowego w formacie XML,
- Chcesz mieć pełną kontrolę nad tym, kiedy dane zostaną przetworzone,
- Chcesz przetestować zmiany bez czekania na automatyczny harmonogram.
Jak działa ten przycisk?
- Wtyczka pobiera plik XML ze ścieżki podanej w polu XML Product File Path for Embeddings.
- Każdy produkt z pliku zostaje przetworzony na embedding (matematyczny wektor).
- Embeddingi są zapisywane lokalnie w systemie.
- Konsultant AI od razu zaczyna korzystać z nowych danych podczas rozmów.
Jak użyć?
- Wprowadź adres pliku XML w polu XML Product File Path for Embeddings.
- Wybierz odpowiedni Embedding Model.
- Kliknij przycisk Generate Embeddings from XML Now.
- Poczekaj na zakończenie procesu (czas zależy od wielkości pliku XML).
Kiedy używać?
- Po każdej zmianie pliku XML (nowe produkty, opisy, ceny).
- Gdy plik został załadowany po raz pierwszy.
- Po aktualizacji modelu embeddingu.
- Po testowej edycji oferty (chcesz przetestować działanie AI na nowych danych).
Dobre praktyki:
- Przed kliknięciem upewnij się, że plik XML jest dostępny i poprawnie sformatowany.
- W razie błędów w pliku – embeddingi nie zostaną zapisane (sprawdź konsolę lub logi).
- Przy dużych plikach XML (powyżej 500 produktów) proces może potrwać kilkanaście sekund.
Czy trzeba klikać ten przycisk codziennie?
Nie – tylko jeśli nie używasz automatycznego harmonogramu (Embedding Schedule – Days/Hour). Jeśli masz ustawiony harmonogram, embeddingi będą aktualizowane automatycznie.
Podsumowanie:
Przycisk Generate Embeddings from XML Now to szybki i bezpieczny sposób na ręczne odświeżenie danych produktowych w AI. Dzięki niemu masz pełną kontrolę nad momentem aktualizacji bazy wiedzy Konsultanta, szczególnie przy testach, zmianach oferty lub uruchamianiu integracji po raz pierwszy.
Informacja: Last embedding generation
To pole wyświetla datę i godzinę ostatniego wygenerowania embeddingów z pliku XML, na podstawie Twojego harmonogramu lub ręcznego kliknięcia przycisku Generate Embeddings from XML Now.
Przykład:
Last embedding generation: 2025-03-17 19:25:29
Dzięki tej informacji możesz sprawdzić, kiedy ostatni raz zaktualizowano bazę danych embeddingów, a tym samym – kiedy Konsultant AI zaczął korzystać z najnowszej wersji pliku XML.
Jeśli podejrzewasz, że Konsultant korzysta ze starych danych – porównaj tę datę z datą ostatniej modyfikacji pliku XML.
Informacja: Last Indexed Embeddings (Sample)
Podgląd ostatnio przetworzonych danych
W tej sekcji wtyczka wyświetla fragment przykładowych danych (embeddingów), które zostały ostatnio zaindeksowane z pliku XML. Służy to wyłącznie jako podgląd kontrolny – nie jest to pełna treść bazy embeddingów.
Możesz tutaj:
- Sprawdzić, czy Konsultant widzi dane z pliku XML,
- Zobaczyć, które produkty zostały ostatnio zaindeksowane,
- Zweryfikować, czy zawartość opisu i tytułu odpowiada rzeczywistemu feedowi.
Jeśli podgląd jest pusty lub pokazuje stare dane:
- Sprawdź ścieżkę pliku XML w ustawieniach,
- Kliknij ponownie Generate Embeddings from XML Now,
- Upewnij się, że plik XML zawiera dane w odpowiednim formacie.
Podsumowanie:
Last embedding generation informuje, kiedy dane zostały zaktualizowane, a Last Indexed Embeddings (Sample) daje szybki wgląd w ich zawartość. To narzędzia diagnostyczne – pomagają administratorowi upewnić się, że AI działa na aktualnych danych produktowych.