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.

En motor är en konversation, designad som ett diagram. Du bygger den på en arbetsyta av ett fåtal delar, testar den i simulatorn och publicerar den sedan. Den här sidan täcker varje del av byggaren. Om du är helt ny, skumma Personas först — varje motor körs som en persona.

Grundläggande begrepp

Ett par ord dyker upp överallt i byggaren. Lär dig dessa och resten faller på plats.

  • Fas — ett stadium i konversationen. En fas är ett öppningsmeddelande (hur AI:n sätter igång det stadiet) plus en kortlek med kort den kan spela medan konversationen befinner sig i den fasen. En typisk motor har ett par faser: en kall öppning, en uppvärmning, en inbjudan.
  • Kortlek — uppsättningen kort kopplade till en fas. Varje varv spelar motorn ett kort från leken, valt genom ett viktat slumpmässigt urval, så att samma fas känns annorlunda varje gång.
  • Kort — ett enda drag: chatta, ställ en fråga, skicka ett foto, lägg en länk, avsluta. Varje kort har egna inställningar (se kortreferensen nedan).
  • Port / övergång — en regel som flyttar konversationen från en fas till en annan, eller utlöser en reaktion. Vissa portar sitter inline mellan två faser; andra flödar fritt och bevakar hela konversationen.
  • Fakta — en detalj motorn lär sig om leadet (deras namn, stad, intressen). Fakta extraheras från chatten medan den pågår och kan infogas i meddelanden med en tagg.
  • Startpunkter — noderna som talar om var en konversation börjar: AI:n skickar meddelande först, användaren skickar meddelande först, eller en extern händelse.
  • Flytande observatörer — portar som inte är kopplade mellan två specifika faser. De bevakar hela konversationen och utlöses när deras villkor är uppfyllt (till exempel att en fakta dyker upp, eller att leadet accepterar en länk).

Arbetsytan

Byggaren är en zoombar arbetsyta med noder kopplade via kanter. Du drar delar från sidan, släpper kort på faser och ritar linjer för att koppla samman flödet.

Nodpalett

  • Start — noder för konversationsstart (AI-öppnare, Inkommande chatt, Händelseutlösare).
  • Faser — lägg till en ny fasnod på arbetsytan.
  • Regler — logikportar och observatörer du kopplar mellan eller runt faser.

Kortbibliotek

I kortbiblioteket listas varje korttyp. Dra ett kort till en fas för att lägga till det i den fasens kortlek. Samma korttyp kan förekomma i flera faser med olika inställningar.

Kopplingskanter

Dra från en nods uthanterare till en annan nod för att skapa en kant. Kanter är hur en startpunkt når sin första fas och hur portar för konversationen framåt.

Auto-arrangera

Handkopplade grafer blir röriga. Knappen Auto-arrangera (trollstaven, uppe till höger på flödesarbetsytan) lägger om hela grafen i en snygg vänster-till-höger-layout utan överlappande noder, och anpassar sedan vyn. De nya positionerna sparas när du sparar motorn. Kör den innan du avslutar en motor.

Korttyper

Kort är de drag en motor kan göra i en fas. Dessa är de inbyggda typerna, med sina biblioteksnamn:

  • Avslappnat samtal (CHAT) — fritt formulerat meddelande. Det här är det enda kortet som fullt ut respekterar dina anpassade Instruktioner, så det är ditt huvudverktyg för att styra ordvalet.
  • Faktasamlare (PROBE) — frågar efter nästa saknade fakta och riktar sig automatiskt mot den detalj motorn fortfarande behöver.
  • Skicka foto (PHOTO) — skickar det mest passande fotot från personans arkiv, automatiskt valt utifrån varje fotos beskrivning.
  • Verifieringsfoto (VERIFICATION) — ber leadet skicka ett verifikations-/bevisningsfoto på sig själva.
  • Lägg länken (LINK_DROP) — lägger din funnel-länk. Kräver en funnel-URL inställd i de globala inställningarna.
  • Avsluta / stäng (CLOSE) — avslutar och stänger konversationen.
  • Reagera (REACT), Retas / Flirta (TEASE), Öppna upp (SHARE), Relatera (RELATE) — snabba inbyggda slag som håller en konversation mänsklig. Se varningen nedan — dessa fyra kör en fast rad.

Obs

Reagera, Retas/Flirta, Öppna upp och Relatera kör en fast, inbyggd rad och ignorerar Instruktioner-fältet. Allt du skriver in i dessa fyra kort (och eventuella taggar) används inte. Om du behöver anpassad formulering, använd ett Avslappnat samtal kort istället.

Portar & övergångar

Portar bestämmer när konversationen fortsätter eller reagerar. Det finns två former: inline-räknare kopplade mellan två faser, och flytande observatörer som bevakar hela chatten.

Inline-räknare

  • Efter N meddelanden (MESSAGE_COUNT) — kopplad fas → port → fas. Den räknar varv och för konversationen framåt när ett tröskelvärde nås. Tröskelvärdets 1–20. Det här är standardsättet att föra en chatt framåt genom sina faser.

Flytande observatörer

  • Faktakontroll (FACT_EXISTS) — utlöses när en specifik fakta har extraherats ur konversationen.
  • Konverteringskontroll (CONVERSION_CHECK) — utlöses baserat på om leadet accepterade eller avvisade den senast droppade länken.
  • Signaldetektor (DETECTOR) — en intern observatör som stödjer bottankvarförsvar. Den erbjuds inte i paletten; du placerar den inte själv.

Startpunkter

Varje motor måste veta hur en chatt börjar. Lägg till en eller flera startnoder och koppla var och en till den fas där den sökvägen börjar.

  • AI-öppnare / Outreach — AI:n skickar det första meddelandet (kall outreach). Använd detta för proaktiva funnels.
  • Inkommande chatt / Standard — användaren skickar meddelande först (det normala inkommande DM:et). En motor måste ha exakt en Inkommande chatt / Standard-start.
  • Händelseutlösare — startar en chatt när en specifik extern händelse utlöses. Den behöver ett händelse-id (till exempel, story_reaction).
  • Uppföljning — återengagerar ett lead som blivit tyst och drar tillbaka dem i konversationen.

Obs

Prompttaggar fylls inte i på AI-öppnaren. En {name} skriven i öppnaren visas ordagrant för leadet. Håll AI-öppnaren skriven med vanliga ord.

Fakta & Kunskapsfliken

I Kunskaps fliken hanterar du de fakta motorn samlar in. Det finns två typer:

  • Systemfakta — inbyggda detaljer som motorn alltid försöker lära sig (till exempel leadets namn och plats).
  • Anpassade fakta — dina egna fält, specifika för din funnel.

Varje fakta är tilldelad en fas — stadiet under vilket motorn ska försöka lära sig det. Faktasamlar-kortet jagar sedan vilken fakta som fortfarande saknas för den aktuella fasen.

Obs

Varje fakta kan tillhöra exakt en fas. Om du vill att motorn ska lära sig något i ett annat stadium, flytta faktan — du kan inte tilldela den till två faser samtidigt.

Nodinspektören

Klicka på valfri nod för att öppna inspektören till höger. Vad du kan redigera beror på noden, men de gemensamma fälten är:

  • Instruktioner / direktiv — vägledning på vanligt språk för vad AI:n ska göra. På ett kort styr detta meddelandet; på en fas är detta fasens syfte. (Kom ihåg att de fyra snabbkorten ignorerar det.)
  • Fasöppnare — öppningsmeddelandet för en fas: hur AI:n startar konversationen när den träder in i det stadiet.
  • Vikt (1–100) — hur sannolikt ett kort är att dras från sin lek vid ett givet varv. Högre vikt = spelas oftare.
  • Användningsgräns (0–20) — det maximala antalet gånger ett kort får spelas i en konversation. 0 innebär obegränsat.
  • Väntan mellan användningar — hur många varv att vänta innan ett kort kan spelas igen, så att det inte upprepas i rad.

Prompttaggar

Inuti ett korts Instruktioner kan du skriva en tagg och motorn byter in det verkliga värdet innan meddelandet skickas. Tillgängliga taggar:

Personadetaljer

  • {name} — personans namn
  • {age} — personans ålder
  • {origin} — varifrån personan kommer
  • {city} — personans stad
  • {job} — personans yrke
  • {hobbies} — personans hobbyer och intressen
  • {bio} — personans biografi
  • {style_tags} — personans skrivstilsdrag
  • {time} — aktuell tid på dygnet, så att personan kan låta morgon- eller kvällsmedveten

Din funnel

  • {platform} — appen du skickar meddelanden på
  • {funnel_platform} — din funnel eller destinationsplattform

Åtgärder

  • {photo} — skickar det mest passande fotot från arkivet, automatiskt valt via beskrivning
  • {link} — lägger din konverteringslänk, med filterkringgående tillämpad

Kortspecifikt

  • {fact} — på ett Faktasamlar-kort: nästa detalj att ta reda på om leadet
  • {vibe} — på ett Skicka foto-kort: aktuellt fotostämning, avslappnat eller hett
  • {context} — på ett ingångs-/öppnarkort: det inkommande första meddelandet som öppnaren reagerar på

Globala & identitetsinställningar

De motorövergripande inställningarna finns i fliken Identitet / globala inställningar:

  • Meddelandeplattform — appen konversationen körs på (driver {platform} taggen).
  • Varvsgräns (1–100, standard 60) — det maximala antalet varv innan konversationen avslutas.
  • Max meddelandebubblor (1–5) — hur många separata meddelandebubblor ett enda svar kan delas upp i.
  • Funnel-plattform — din destinationsplattform (driver {funnel_platform}).
  • Funnel-URL — länken som Lägg länken-kortet skickar.
  • Länkmaskering — tillämpas automatiskt för att undvika länkfilter när länken läggs.
  • Leadsvärde — vad ett konverterat lead är värt, används av analytics för att uppskatta intäkter.

Avvisanden & bottankvarförsvar

Du kan skripta hur motorn hanterar besvärliga situationer — ett lead som trycker tillbaka, eller anklagar AI:n för att vara en bot. Varje scenario parar en utlösare med ett svar, som kan vara en text eller en bild, så att konversationen återhämtar sig på ett smidigt sätt istället för att fastna.

Validering & publicering

Byggaren kontrollerar din motor medan du arbetar och rapporterar problem i Problem-panelen. Två nivåer spelar roll:

  • Fel blockerar publicering. Du kan inte publicera en motor som misslyckas med validering.
  • Bara hårda gränsenfel blockerar Spara. Du kan spara ett pågående arbete som fortfarande har mjukare problem och återkomma till det.
  • Problem-panelen hoppar till noden när du klickar på ett problem, så att du kan åtgärda det på plats.

Obs

En fas måste ha minst ett kort och ett öppningsmeddelande. En tom fas valideras inte.

Obs

Portar och startnoder kan inte döpas om. Bara faser och händelseutlösare tar ett anpassat namn — låt byggaren namnge allt annat automatiskt.

Obs

Publicering till marketplace kräver en helt ren validering — det är striktare än Spara. Rensa alla fel i Problem-panelen innan du publicerar.

Motor CRUD & marketplace

  • Ny — starta en ny motor från en tom arbetsyta.
  • Kopiera (klona) — duplicera en befintlig motor för att iterera utan att röra originalet.
  • Döp om — döp om en av dina egna motorer.
  • Ta bort — ta bort en motor du äger.
  • Publicera / avpublicera — dela en ren motor till marketplace, eller ta bort den därifrån.

Nästa steg

Med en motor byggd är du redo att sätta den i arbete. Läs om den persona den körs som i Personas, starta från en bevisad funnel i Marketplace-mallar, kör den torrt i Testning & simulatorn, och koppla den live med Gå live.

Engine Builder — FluidTalk Documentation | FluidTalk