Skip to main content
Een normale variabele zoekt een waarde op. Een AI-variabele bedenkt er een. Waar {{ candidate.first_name }} een veld leest en invoegt, voert een AI-variabele een korte instructie uit tegen het record en voegt in wat die produceert. Het is de tool voor de regel die elke keer anders moet zijn — een opener die iemands achtergrond koppelt aan een vacature, of een verjaardagswens die niet leest als een mailmerge. Je gebruikt hem precies zoals elke andere variabele:
In de editor verschijnt hij als een chip, gemarkeerd met de AI-sparkle zodat je hem in één oogopslag kunt onderscheiden van een normale variabele: Ai Variable Chip In Content

Waar je er een kunt toevoegen

Je kunt AI-variabelen aanmaken in e-mailtemplates, formulieren en automatiseringen. De automation builder biedt ook presets, zodat je een variabele die je vaak gebruikt niet handmatig opnieuw hoeft op te bouwen. WhatsApp-berichttemplates kunnen naar variabelen verwijzen, maar de variabelenlijst daar is read-only — je kunt geen AI-variabele aanmaken vanuit de message builder. Definieer hem in plaats daarvan op de automatisering die het bericht verstuurt.

Wanneer je er een gebruikt

Grijp naar een AI-variabele wanneer alle drie waar zijn:
  • de output moet worden afgeleid, niet opgezocht;
  • een vaste regel met een fallback zou slecht lezen, omdat de waarde echt per persoon moet veranderen;
  • er net naast zitten is te overleven — niemand neemt er een beslissing op.
Goede kandidaten: een gepersonaliseerde opener, een re-engagement-haakje voor een slapende kandidaat, een niet-generieke verjaardagsregel, of een toonherschrijving van een vaste alinea.

Wanneer je iets anders gebruikt

De meeste personalisatie is geen AI-probleem. Controleer voordat je een AI-variabele toevoegt of een gewone variabele of een modifier het werk al doet — die zijn sneller, goedkoper, en kunnen er niet naast zitten.
Laat een AI-variabele nooit een feit verzinnen. Datums, tarieven, salarissen, contractvoorwaarden, startdatums, juridische of GDPR-status, en alles wat leest als een toezegging moet uit een veld komen. Als het veld leeg is, is het eerlijke antwoord het weg te laten of een fallback te gebruiken — niet een model het gat te laten vullen. Een gegenereerde zin die een startdatum verzint is een onjuiste uitspraak die uit jouw naam naar een kandidaat wordt gestuurd.

Een AI-variabele instellen

Open het variabelenpaneel met de {}-control in de werkbalk van de builder. Bestaande variabelen worden getoond met hun key en type, dus een AI-variabele is makkelijk te herkennen: Ai Variable Variables Panel Klik op Add en selecteer vervolgens AI variable uit de groep Intelligent: Ai Variable Type Picker

Kiezen wat de AI moet doen

Voor al het andere vraagt de editor wat voor soort werk deze variabele doet. Er zijn zeven modi, elk getoond als een tegel met een beschrijving van één regel: Ai Variable Mode Picker
De modus ligt niet vast. Zodra je er een kiest, klappen de tegels in tot een compacte dropdown, en je kunt hem wijzigen wanneer je wilt. Heropen de variabele en selecteer een andere modus onder What should the AI do?. De rest van het formulier past zich daarop aan.

De rest van de editor

Ai Variable Editor
Een AI-variabele hoeft geen proza te produceren. Omdat je het returntype kiest, kan er net zo goed een Yes / No, een Number, of een waarde uit een List uitkomen — daar zijn de modi Classify en Extract voor. De waarschuwing hierboven blijft gelden: een waarde afleiden uit data in het record is prima, er een verzinnen niet.

Geef het iets om mee te werken

De instructie alleen is zelden genoeg — het model heeft het record nodig. Er zijn twee manieren om dat aan te leveren, en ze kunnen worden gecombineerd.

Inline in de prompt

Typ {{ waar dan ook in het Input-vak en er verschijnt een picker die elke variabele toont die voor deze template beschikbaar is, met key en type. Blijf typen om te filteren, en selecteer er dan een om hem in te voegen. Hij verschijnt als een badge met de naam van het veld, en erover bewegen toont de waarde.
Ai Variable Prompt Variable Picker 1
Een verjaardagswens die de ontvanger bij naam begroet leest dus als:
Elke badge wordt vervangen door de waarde van die ontvanger voordat de instructie het model bereikt, dus voor Sofia wordt het model om een wens voor Sofia gevraagd in plaats van voor {{recipient.first_name}}. Een oranje badge is een key die HireData niet herkent. Die bereikt het model als de kale key, dus herstel hem voordat je opslaat.

Het Variables-tabblad

Schakel over naar het tabblad Variables en selecteer Add Field om velden te koppelen in plaats van ze in de prompt te benoemen. Elke rij is een doorzoekbare picker over dezelfde lijst variabelen, en de -knop verwijdert er een.
Ai Variable Picker
Een veld koppelen geeft de waarde ervan aan het model zonder dat je het in de instructie hoeft te noemen. Het maakt de inputs van de variabele ook duidelijk voor wie hem hierna opent, wat de moeite waard is zodra de prompt lang wordt.

Waarom de inputs ertoe doen

De velden waarnaar je verwijst, via welke methode dan ook, zijn de inputs van de variabele — en inputs bepalen wanneer hij opnieuw wordt bepaald. Geef hem de velden waarvan hij echt afhangt in plaats van ze in proza te beschrijven. Zie Beperkingen.

De instructie schrijven

Een bruikbare instructie benoemt haar vorm en haar grenzen. Laat de speciale controls het werk doen waarvoor ze er zijn — stel de outputtaal in via de Language-control in plaats van die in de prompt te beschrijven, en stel het returntype in in plaats van erom te vragen:
Write a friendly, single-sentence birthday wish, maximum 20 words. Vary the wording so it does not sound templated. No emoji. Do not open with “Happy birthday”. If the recipient’s name is missing, write a general wish with no name.
Die laatste zin is het belangrijkst. Zeg wat er moet gebeuren wanneer de data ontbreekt, of het model verzint iets om de ruimte te vullen. Langere instructies zijn geen betere instructies. Beperkingen doen meer werk dan beschrijving. Benoem de maximale lengte, de toon, wat er niet mag, en wat er geproduceerd moet worden wanneer de brondata dun is.

Beperkingen

Hij wordt één keer per verzending bepaald, en daarna herhaald. De waarde wordt gegenereerd de eerste keer dat er naar de variabele wordt verwezen en hergebruikt voor elke andere vermelding in hetzelfde bericht — dus twee keer {{ celebration }} in één e-mail geeft je twee keer dezelfde zin, geen twee pogingen. Hij wordt opnieuw bepaald wanneer zijn inputs veranderen, en dat is wat hem per ontvanger maakt. Een variabele zonder gekoppelde inputs heeft niets om op te variëren. Een opgeslagen default is geen vangnet. Voor een AI-variabele is de default-waarde het slot waarin de gegenereerde waarde wordt geschreven, geen fallback die je kunt instellen. Als het model niets retourneert, resolvet de variabele naar niets. Om te garanderen dat er iets op de pagina belandt, gebruik je de default-modifier op de plek waar je ernaar verwijst:
Een geldige template kan alsnog met een gat erin worden verzonden. Validatie controleert of een placeholder bekend is, niet of hij een waarde zal hebben wanneer het bericht uitgaat. Dus deze template:
kan perfect valideren en toch aankomen als een e-mail die opent met een lege regel, gevolgd door “We hope you take some time today to celebrate.” De template is niet kapot. De variabele produceerde niets. Testverzendingen gedragen zich anders dan echte. Bij een testverzending heeft elke custom variabele waarnaar in de body wordt verwezen een expliciete, niet-lege waarde nodig die jij aanlevert — opgeslagen waarden worden bewust niet gesubstitueerd. Een schone test bewijst dus dat de copy werkt; hij bewijst niet dat de variabele in productie een waarde oplevert. Als een ontvanger een bericht meldt met een ontbrekende zin, een lege begroeting of een los fragment, controleer dan welke variabelen AI-variabelen zijn voordat je aanneemt dat de copy fout is.

Voordat je verzendt

1

Test met complete data

Bevestig dat de waarde goed leest en binnen je lengtelimiet blijft.
2

Test met ontbrekende en lege data

Dit is waar AI-variabelen falen. Controleer dat een dun record iets acceptabels oplevert in plaats van een gehallucineerd detail of een lege regel.
3

Test in elke taal waarin je verzendt

Toon en formaliteit gaan niet mee tussen talen. Een regel die warm leest in het Engels kan overfamiliair lezen in het Nederlands.
4

Lees het als de ontvanger

Vraag je af of een kandidaat zich zou schamen voor deze zin, erdoor in verwarring zou raken of erdoor zou worden misleid. Is het antwoord misschien, scherp dan de beperkingen aan of gebruik een vaste regel.

Gerelateerd

Gerelateerde onderwerpen

VariablesModifiers