Docs

Engine Builder

The Engine Builder is where you design a conversation visually. You lay out phases on a canvas, fill them with cards, wire logic gates between them, and choose where the chat begins. This is the full reference.

Silnik to rozmowa zaprojektowana jak diagram. Budujesz go na płótnie z kilku klocków, testujesz w symulatorze, a potem publikujesz. Ta strona omawia każdą część kreatora. Jeśli dopiero zaczynasz, przejrzyj najpierw Persony : każdy silnik działa jako persona.

Podstawowe pojęcia

Kilka słów przewija się w kreatorze wszędzie. Naucz się ich, a reszta wskoczy na miejsce.

  • Faza: etap rozmowy. Faza to wiadomość otwierająca (sposób, w jaki AI rozpoczyna ten etap) plus talia kart, które może zagrać, dopóki rozmowa jest w tej fazie. Typowy silnik ma kilka faz: zimne otwarcie, rozgrzewkę, zaproszenie.
  • Talia: zestaw kart przypiętych do fazy. W każdej turze silnik zagrywa jedną kartę z talii, wybraną losowo z wagami, więc ta sama faza za każdym razem brzmi inaczej.
  • Karta: pojedynczy ruch: pogadać, zadać pytanie, wysłać zdjęcie, wrzucić link, zakończyć. Każda karta ma własne ustawienia (patrz opis kart niżej).
  • Bramka / przejście: reguła, która przenosi rozmowę z jednej fazy do drugiej albo wywołuje reakcję. Niektóre bramki siedzą w linii między dwiema fazami; inne unoszą się i obserwują całą rozmowę.
  • Fakt: szczegół, którego silnik dowiaduje się o leadzie (imię, miasto, zainteresowania). Fakty wyłuskujemy z czatu na bieżąco i można je wstawić z powrotem do wiadomości za pomocą tagu.
  • Punkty startowe: węzły, które mówią, gdzie zaczyna się rozmowa: AI pisze pierwsza, użytkownik pisze pierwszy, albo zewnętrzne zdarzenie.
  • Obserwatorzy unoszący się: bramki, które nie są wpięte między dwie konkretne fazy. Obserwują całą rozmowę i odpalają, gdy tylko ich warunek zostanie spełniony (na przykład pojawi się fakt albo lead przyjmie link).

Płótno

Kreator to płótno z powiększaniem, na którym węzły łączą się krawędziami. Przeciągasz elementy z boku, upuszczasz karty na fazy i rysujesz linie, żeby spiąć przepływ.

Paleta węzłów

  • Start: węzły rozpoczynające rozmowę (Otwarcie AI, Wiadomość przychodząca, Wyzwalacz zdarzenia).
  • Fazy: dodaje na płótno nowy węzeł fazy.
  • Reguły: bramki logiczne i obserwatorzy, których wpinasz między fazy albo wokół nich.

Biblioteka kart

Biblioteka kart wypisuje każdy typ karty. Przeciągnij kartę na fazę, żeby dodać ją do talii tej fazy. Ten sam typ karty może występować w wielu fazach z różnymi ustawieniami.

Łączenie krawędziami

Przeciągnij z uchwytu wyjściowego jednego węzła do drugiego, aby utworzyć krawędź. To dzięki krawędziom punkt startowy dociera do swojej pierwszej fazy, a bramki popychają czat dalej.

Automatyczny układ

Ręcznie spinane grafy szybko robią się bałaganem. Przycisk Auto-układ (różdżka, prawy górny róg płótna przepływu) rozkłada cały graf na nowo w czytelny układ od lewej do prawej, bez nachodzących na siebie węzłów, a potem dopasowuje go do widoku. Nowe pozycje zapisują się przy zapisie silnika. Uruchom go, zanim uznasz silnik za skończony.

Typy kart

Karty to ruchy, jakie silnik może wykonać wewnątrz fazy. Oto typy wbudowane, pod nazwami z biblioteki:

  • Swobodna rozmowa (CHAT): dowolna wiadomość. To jedyna karta, która w pełni respektuje Twoje własne Instrukcje, więc jest Twoim koniem roboczym do sterowania treścią.
  • Fact Finder (PROBE): dopytuje o kolejny brakujący fakt, automatycznie celując w ten szczegół, którego silnikowi jeszcze brakuje.
  • Wyślij zdjęcie (PHOTO): wysyła najlepiej pasujące zdjęcie ze skarbca persony, dobrane automatycznie po opisie każdego zdjęcia.
  • Zdjęcie dowodowe (VERIFICATION): prosi leada o przesłanie zdjęcia potwierdzającego / weryfikacyjnego.
  • Wrzuć link (LINK_DROP): wrzuca Twój link do lejka. Wymaga adresu URL lejka ustawionego w ustawieniach globalnych.
  • Zakończ (CLOSE): domyka i kończy rozmowę.
  • Zareaguj (REACT), Podroczyć się / poflirtować (TEASE), Otwórz się (SHARE), Nawiąż (RELATE): krótkie, wbudowane zagrywki, które sprawiają, że rozmowa brzmi po ludzku. Zobacz pułapkę niżej: te cztery odtwarzają stałą kwestię.

Uwaga

Zareaguj, Podroczyć się / poflirtować, Otwórz się i Nawiąż odtwarzają stałą, wbudowaną kwestię i ignorują pole Instrukcje. Cokolwiek wpiszesz w te cztery karty (i wszystkie tagi) nie zostanie użyte. Jeśli potrzebujesz własnego sformułowania, użyj zamiast tego karty Swobodna rozmowa .

Bramki i przejścia

Bramki decydują, kiedy rozmowa idzie dalej albo reaguje. Są dwie postaci: liczniki w linii wpięte między dwie fazy, oraz obserwatorzy unoszący się , którzy pilnują całego czatu.

Licznik w linii

  • Po N wiadomościach (MESSAGE_COUNT): wpięty jako faza → bramka → faza. Zlicza tury i przesuwa rozmowę dalej po przekroczeniu progu. Próg mieści się w zakresie 1–20. To standardowy sposób przeprowadzania czatu przez kolejne fazy.

Obserwatorzy unoszący się

  • Sprawdzenie faktu (FACT_EXISTS): odpala, gdy konkretny fakt zostanie wyłuskany z rozmowy.
  • Sprawdzanie konwersji (CONVERSION_CHECK): odpala w zależności od tego, czy lead przyjął, czy odrzucił ostatni wrzucony link.
  • Detektor sygnału (DETECTOR): wewnętrzny obserwator stojący za obroną przed oskarżeniami o bycie botem. Nie ma go w palecie; sam go nie umieszczasz.

Punkty startowe

Każdy silnik musi wiedzieć, jak zaczyna się czat. Dodaj jeden lub więcej węzłów startowych i wepnij każdy do fazy, od której zaczyna się dana ścieżka.

  • Otwarcie AI / Zaczepka: AI wysyła pierwszą wiadomość (zimne zagadanie). Używaj tego w lejkach, gdzie sam wychodzisz z inicjatywą.
  • Wiadomość przychodząca / Domyślne: użytkownik pisze pierwszy (zwykły przychodzący DM). Silnik musi mieć dokładnie jeden start typu Wiadomość przychodząca / Domyślne.
  • Wyzwalacz zdarzenia: rozpoczyna czat, gdy odpali konkretne zdarzenie zewnętrzne. Potrzebuje id zdarzenia (na przykład story_reaction).
  • Follow-up: odzywa się do leada, który zamilkł, i wciąga go z powrotem do rozmowy.

Uwaga

W Otwarciu AI tagi promptów nie są podstawiane. Wpisany tam {name} wyświetliłby się leadowi dosłownie. Otwarcie AI pisz zwykłymi słowami.

Fakty i zakładka Wiedza

W zakładce Wiedza zarządzasz faktami, które silnik zbiera. Są dwa rodzaje:

  • Fakty systemowe: wbudowane szczegóły, których silnik zawsze próbuje się dowiedzieć (na przykład imię i lokalizacja leada).
  • Fakty własne: Twoje własne pola, specyficzne dla Twojego lejka.

Każdy fakt jest przypisany do fazy: czyli etapu, na którym silnik ma spróbować się go dowiedzieć. Karta Fact Finder goni potem za tym faktem, którego wciąż brakuje w bieżącej fazie.

Uwaga

Każdy fakt należy dokładnie do jednej fazy. Jeśli chcesz, żeby silnik dowiadywał się czegoś na innym etapie, przenieś ten fakt. Nie da się przypisać go do dwóch faz naraz.

Inspektor węzła

Kliknij dowolny węzeł, żeby otworzyć inspektora po prawej. To, co możesz edytować, zależy od węzła, ale wspólne pola to:

  • Instrukcje / dyrektywa: wskazówki zwykłym językiem, co AI ma zrobić. Na karcie sterują treścią wiadomości; na fazie opisują cel tej fazy. (Pamiętaj, że cztery szybkie karty to ignorują.)
  • Otwarcie fazy: wiadomość otwierająca fazę: jak AI zaczyna rozmowę, gdy wchodzi na ten etap.
  • Limit użyć (0–20): maksymalna liczba zagrań karty w jednej rozmowie. 0 oznacza bez limitu.
  • Odstęp między użyciami: ile tur odczekać, zanim karta będzie mogła zostać zagrana ponownie, żeby nie powtarzała się jedna za drugą.

Tagi w promptach

W Instrukcjach karty możesz wpisać tag , a silnik podstawi prawdziwą wartość tuż przed wysłaniem wiadomości. Dostępne tagi:

Szczegóły persony

  • {name}: imię persony
  • {age}: wiek persony
  • {origin}: skąd pochodzi persona
  • {city}: miasto persony
  • {job}: praca persony
  • {hobbies}: hobby i zainteresowania persony
  • {bio}: biografia persony
  • {style_tags}: cechy stylu pisania persony
  • {time}: aktualna pora dnia, żeby persona brzmiała porannie albo wieczorowo

Twój lejek

  • {platform}: aplikacja, w której piszecie
  • {funnel_platform}: Twoja platforma lejka albo docelowa

Akcje

  • {photo}: wysyła najlepiej pasujące zdjęcie ze skarbca, dobrane automatycznie po opisie
  • {link}: wrzuca Twój link konwersji, z omijaniem filtrów

Zależne od karty

  • {fact}: na karcie Fact Finder: kolejny szczegół do wybadania o leadzie
  • {vibe}: na karcie Wyślij zdjęcie: aktualny klimat zdjęć, swobodny albo pikantny
  • {context}: na karcie wejścia / otwarcia: przychodząca pierwsza wiadomość, na którą reaguje otwarcie

Ustawienia globalne i tożsamości

Ustawienia obejmujące cały silnik znajdziesz w zakładce Tożsamość / ustawienia globalne:

  • Platforma komunikacyjna: aplikacja, w której toczy się rozmowa (zasila tag {platform} ).
  • Limit tur (1–100, domyślnie 60): maksymalna liczba tur, po której rozmowa się zatrzymuje.
  • Maks. dymków wiadomości (1–5): na ile osobnych dymków można rozbić pojedynczą odpowiedź.
  • Platforma lejka: Twoja platforma docelowa (zasila {funnel_platform}).
  • URL lejka: link, który wysyła karta Wrzuć link.
  • Maskowanie linku: stosowane automatycznie przy wrzucaniu linku, żeby ominąć filtry linków.
  • Wartość leada: ile wart jest skonwertowany lead; analityka używa tego do szacowania przychodu.

Odmowy i obrona przed „jesteś botem”

Możesz rozpisać, jak silnik radzi sobie w niezręcznych momentach: gdy lead się stawia albo oskarża AI o bycie botem. Każdy scenariusz łączy wyzwalacz z odpowiedzią, która może być tekstem albo obrazem, żeby rozmowa wyszła z tego z klasą, zamiast utknąć.

Walidacja i publikacja

Kreator sprawdza Twój silnik na bieżąco i zgłasza problemy w panelu Problemy. Liczą się dwa poziomy:

  • Błędy blokują publikację. Nie opublikujesz silnika, który nie przechodzi walidacji.
  • Zapis blokują tylko błędy twardych limitów. Pracę w toku z łagodniejszymi problemami możesz zapisać i wrócić do niej później.
  • Panel Problemy przeskakuje do węzła , gdy klikniesz zgłoszenie, żebyś mógł je poprawić na miejscu.

Uwaga

Faza musi mieć co najmniej jedną kartę i wiadomość otwierającą. Pusta faza nie przejdzie walidacji.

Uwaga

Bramek i węzłów startowych nie da się przemianować. Własną nazwę przyjmują tylko fazy i wyzwalacze zdarzeń : resztę pozwól nazwać kreatorowi automatycznie.

Uwaga

Publikacja w Marketplace wymaga w pełni czystej walidacji: to ostrzejsze kryterium niż zapis. Wyczyść każdy błąd w panelu Problemy, zanim opublikujesz.

Operacje na silnikach i Marketplace

  • Nowy: zacznij nowy silnik od pustego płótna.
  • Kopiuj (klonuj): zduplikuj istniejący silnik, żeby iterować, nie ruszając oryginału.
  • Zmień nazwę: zmień nazwę jednego z własnych silników.
  • Usuń: usuń silnik, którego jesteś właścicielem.
  • Opublikuj / wycofaj: udostępnij czysty silnik w Marketplace, albo go stamtąd ściągnij.

Następne kroki

Gdy silnik jest gotowy, możesz zaprząc go do pracy. Poczytaj o personie, jako która działa, w sekcji Persony, zacznij od sprawdzonego lejka w szablonach Marketplace, przepuść go na sucho w Testach i symulatorze, a potem podłącz na żywo zgodnie z Wdrożeniem.

Engine Builder: FluidTalk Documentation | FluidTalk