Runs

Een run maakt van één verzoek advertentiescripts. Je typt op Marketing → Overzicht wat je wilt, klikt op Scripts maken, en de run doorloopt zijn stappen op je eigen OpenRouter-sleutel. De scripts die hij schrijft komen onder Scripts terecht om te beoordelen.

Een run starten#

Het Overzicht vraagt "Wat wil je maken?" boven één vak. Beschrijf de advertenties in een zin, bijvoorbeeld "Vijf video-advertenties voor onze voorjaarsactie, gericht op nieuwe kopers", en klik op Scripts maken (of druk op Ctrl+Enter of Cmd+Enter). De pagina van de run opent meteen.

Een run gebruikt de merkcontext die het gekozen merk heeft: profiel, klanttypes, citaten, swipe-advertenties en actieve kennis. Niets is vooraf verplicht. Ideeën onder het vak stellen vragen voor uit de eigen gegevens van het merk, en maximaal twee zachte hints zeggen wat er nog ontbreekt, elk met een link naar dat onderdeel van Merk. Ze houden je nooit tegen. Zie Overzicht.

Meer opties opent drie optionele keuzes, standaard dicht:

De knop staat uit zolang er geen werkende OpenRouter-sleutel gekoppeld is, behalve als de stappen van het merk op je agent draaien: die heeft geen sleutel nodig. De accounteigenaar ziet de hint Koppel je OpenRouter-sleutel om te starten, met een link naar Verbindingen; teamleden zien Vraag de accounteigenaar om een OpenRouter-sleutel te koppelen. Zie Verbindingen.

Onder het vak toont Recente runs de laatste vijf runs van het merk met hun status en aantal scripts. De laatste run toont ook een klein plaatje van zijn pijplijncanvas. Klik op een rij om hem te openen. Meer tonen onder de lijst laadt oudere runs, en Kosten naast de titel opent Kosten.

Hoeveel scripts een run schrijft#

Een aantal dat je kiest onder Aantal scripts wint altijd. Staat het op Standaard, dan bepaalt een aantal van 1 tot 10 in je vraag het aantal als het direct voor een woord als scripts, advertenties, video's of varianten staat, als cijfer of als woord in het Nederlands, Engels of Turks: "Drie video-advertenties voor nieuwe kopers", "Maak 4 korte advertenties" of "three video ads" zetten elk het aantal. Jaartallen, prijzen, percentages, tijdsduren en "10x" tellen niet ("Advertenties voor onze actie van €5 in 2026" gebruikt de standaard), net als een vraag met twee verschillende aantallen. In alle andere gevallen geldt Scripts per run. De pagina van de run toont het gebruikte aantal onder Gevraagde scripts.

Dieper gaan op gekozen scripts#

Vink op Marketing → Scripts tot 5 scripts aan die je goed vindt en klik op Dieper gaan, daarna op Bevestigen. Het Overzicht opent met de gekozen scripts als chips onder Dieper op, boven het vak, en het vak begint met een notitie die je kunt aanpassen, zoals "korter", "emotioneler" of "voor het nieuwe product". Klik op het kruisje van een chip om dat script weg te laten. Met meer dan 5 aangevinkt meldt de lijst Dieper gaan werkt met maximaal 5 scripts en opent er niets.

De nieuwe run houdt het idee van de gekozen scripts vast en schrijft er nieuwe hooks, opbouw en lengte voor. De stappen voor invalshoeken en scripts krijgen de gekozen scripts volledig mee, met hun advertentieresultaten als die gekoppeld zijn; onderzoek, beoordelen en scoren werken zoals bij elke run. Laat je Alle producten staan, dan gaat de run over de producten van de eigen runs van de gekozen scripts; producten die je kiest gaan voor. De pagina van de run toont de gekozen scripts onder Dieper op in Details, elk met een link naar zijn script.

De stappen#

Elke run doorloopt tot vier stappen, in deze volgorde:

Onderzoek en Controle kun je uitzetten in de instellingen van de AI-pijplijn; een uitgezette stap toont Overgeslagen. Invalshoeken en Scripts draaien altijd.

De pagina van een run#

De pagina van een run (/m/marketing/runs/{id}) heeft geen item in de zijbalk: open hem vanuit Recente runs of vanuit een script. Hij werkt zichzelf bij zolang de run bezig is.

• De titel is je verzoek, met de status van de run ernaast. Daaronder: wanneer hij startte en de kosten tot nu toe. Klik op de kosten om Kosten te openen.
• Pipeline toont de run als een canvas met stapkaarten (zie Het pijplijncanvas). Klik op een kaart voor de details van die stap.
• Scripts zegt hoeveel scripts de run maakte en hoeveel er nog te beoordelen zijn. Scripts beoordelen bovenaan opent ze: de scriptlijst, gefilterd op deze run.
• De volgorde volgt de run: zolang hij bezig, gepauzeerd, mislukt of geannuleerd is, staat Pipeline bovenaan; is hij klaar en schreef hij scripts, dan staat Scripts bovenaan, zodat je het resultaat als eerste ziet.
• Wat de agent te horen kreeg toont de briefing die de run kreeg: elk deel van je merkcontext, hoeveel items erin gingen en hoeveel er zijn weggelaten om te passen. Geaccepteerde inzichten staan daar als "What worked before".
• Details aan de zijkant: merk, Draait op (Borkol of Je agent), project, klanttype, Gevraagde scripts, Tokens in / uit, Kosten, Geen dataopslag (ZDR) (Aan of Uit) en Kostenlimiet (alleen bij runs op Borkol).

Het pijplijncanvas#

Pipeline tekent één kaart per stap, Onderzoek, Invalshoeken, Scripts en Controle, verbonden door een lijn in de volgorde waarin ze draaien. Elke kaart toont de status van de stap, het gebruikte model (bij runs op Borkol), hoe lang hij duurde en wat hij kostte. Het canvas is een vaste weergave van de run: je kunt kaarten niet verplaatsen of verbinden.

De kaarten veranderen vanzelf zolang de run bezig is. Staan live updates aan, dan zie je een nieuwe status van een stap op het moment dat hij verandert. Staan live updates uit of valt de verbinding weg, dan kijkt de pagina om de paar seconden naar de run, zodat hij toch bijblijft, alleen iets later.

Boven het canvas kan een zachte hint staan. Die houdt de run nooit tegen:

• "Koppel je OpenRouter-sleutel zodat de volgende run kan starten." met Verbindingen openen, als er geen werkende sleutel gekoppeld is (niet bij een merk dat op je agent draait). Teamleden zien in plaats daarvan "Vraag de accounteigenaar om een OpenRouter-sleutel te koppelen om te starten." zonder link.
• "Scripts worden beter met merkgegevens. Vul ze aan op de merkpagina.", met een link naar Wat je verkoopt op Merk, als de score voor de inrichting van het merk lager is dan 50%.

Het stappaneel#

Klik op een kaart (of ga er met Tab naartoe en druk op Enter) om rechts het stappaneel te openen. Het toont wat de oude stappenlijst toonde, en meer:

• De naam van de stap met zijn status, en wat de stap doet. Een mislukte stap toont waarom (zie Als een stap mislukt).
• Model, Status, Gestart, Duur, Tokens in / uit, Tokens uit cache, Kosten met de bron, Pogingen en Playbook. Bij een run op je agent ook Wacht sinds en Opgepakt door je agent.
• Inzichten uit onderzoek bij de stap Onderzoek en Invalshoeken bij de stap Invalshoeken: wat die stappen vonden. Ze stonden eerst op de pagina van de run.
• Bij de stap Scripts hoeveel scripts de run maakte en Scripts beoordelen; bij de stap Controle Gemarkeerde scripts beoordelen.

Druk op Escape of klik ernaast om het te sluiten.

Het model van een stap wisselen voor de volgende run#

Onderaan het stappaneel, onder Volgende runs, staat Model voor de volgende runs: het model van het merk voor deze stap. Kies er een uit de lijst of typ een OpenRouter-model-id en klik op Opslaan; het paneel zegt "Model opgeslagen voor de volgende runs." Het is dezelfde instelling als het model van de stap onder AI-pijplijn, die je opent met Alle instellingen voor de AI-pijplijn.

De run die je bekijkt houdt het model waarmee hij draaide ("Deze run gebruikte {model}. Runs die al gestart zijn houden hun model."), net als elke run die al gestart is. De wijziging geldt vanaf de volgende run. Je hebt er bewerktoegang tot marketing voor nodig, net als voor de AI-pijplijn. Bij een run op je agent zegt het paneel in plaats daarvan "Je agent kiest zelf zijn modellen."

Statussen van een run#

Gepauzeerd op runlimiet en Gepauzeerd op maandlimiet zijn twee verschillende pauzes: de eerste is de eigen kostenlimiet van deze run, de tweede de limiet van het merk voor de maand. Elk heeft een eigen Doorgaan (zie De kostenlimiet en De maandlimiet).

Stappen tonen Niet gestart, Wacht, Bezig, Klaar, Mislukt, Overgeslagen of Gepauzeerd. Bij een merk waarvan de stappen op je agent draaien, kan een stap ook Wacht op je agent tonen (klaar, nog niet opgepakt) of Vastgelopen (30 minuten gewacht zonder te worden opgepakt). Een vastgelopen stap zet "Je agent heeft een stap niet op tijd opgepakt. Controleer of je agent draait en zijn schema aan staat." bovenaan de run, met een link naar Je eigen agent.

Kosten#

Elke modelaanroep wordt op je OpenRouter-account gefactureerd; Borkol factureert geen AI-tokens. De pagina van de run toont de kosten per stap en in totaal, met waar het bedrag vandaan komt:

• gemeten: OpenRouter meldde de kosten van elke aanroep.
• geschat: OpenRouter meldde ze voor een aanroep niet, dus Borkol schatte ze op basis van de catalogusprijs van het model.
• kosten onbekend: Borkol heeft geen prijs voor het gekozen model en OpenRouter meldde er geen.
• gemeld door je agent: de stap draaide op je agent, die zijn eigen kosten meldde. Je agent betaalt zijn modellen, niet je OpenRouter-sleutel.

De activiteitenpagina van OpenRouter blijft leidend voor wat je hebt betaald.

De kostenlimiet#

Elke run heeft een Kostenlimiet (de instelling Kostenlimiet per run, standaard $1,00, voor runs op Borkol; een run op je agent wordt er nooit op gepauzeerd). Vóór elke modelaanroep kijkt de run wat hij heeft uitgegeven. Is de limiet bereikt, dan stopt hij vóór de volgende aanroep: de run toont Gepauzeerd op runlimiet en de pagina zegt "Gepauzeerd op de kostenlimiet: {spent} van {cap} uitgegeven. Ga door met een hogere limiet of annuleer de run." Scripts die al geschreven zijn blijven staan.

Doorgaan vraagt om een Nieuwe kostenlimiet, ingevuld met het dubbele van de huidige. Die moet hoger zijn dan wat al is uitgegeven, en maximaal $50. De gepauzeerde stap gaat daarna verder. Doorgaan vraagt de goedkeurrechten, dezelfde waarmee je scripts goedkeurt.

De maandlimiet#

Elk merk heeft ook een Maandlimiet, standaard $25, in te stellen onder Kosten. Vóór elke modelaanroep kijkt een run op Borkol ook wat het merk deze maand (UTC) heeft uitgegeven. Bereikt het merk zijn maandlimiet, dan stopt de run vóór de volgende aanroep, net als bij de kostenlimiet: hij toont Gepauzeerd op maandlimiet en de pagina zegt "Gepauzeerd op de maandlimiet van dit merk: deze maand {spent} van {cap} uitgegeven. Ga door met een hogere maandlimiet of annuleer de run." Andere merken en runs op je agent worden niet gepauzeerd.

Doorgaan vraagt dan om een Nieuwe maandlimiet, ingevuld met het dubbele van de huidige. Die moet hoger zijn dan de uitgaven van deze maand, en maximaal $5.000. De nieuwe limiet wordt voor het merk opgeslagen en de gepauzeerde stap gaat verder. Voor het verhogen van de maandlimiet heb je de goedkeurrechten nodig.

Gouden controles#

Een gouden controle van een playbookwijziging is ook een run, dus de runlimiet, de maandlimiet, het vastleggen van kosten en het canvas gelden allemaal. Hij schrijft geen scripts in Scripts en staat niet bij Recente runs; zijn pagina toont Gouden controle met "Deze gouden controle vergelijkt het huidige en het voorgestelde playbook. De scores staan bij het voorstel." en Open de playbookwijziging. Stappen die hij niet nodig heeft, tonen Overgeslagen.

Annuleren of opnieuw proberen#

• Meer acties → Run annuleren stopt een wachtende, lopende of gepauzeerde run nadat je "Deze run annuleren?" bevestigt. Stappen die nog niet zijn uitgevoerd worden overgeslagen; scripts die al zijn geschreven blijven staan.
• Een run met de status Mislukt heeft Opnieuw proberen, dat de mislukte stap opnieuw uitvoert met dezelfde kostenlimiet.

Als een stap mislukt#

Eén run tegelijk#

Standaard werkt er per merk één run tegelijk (Runs tegelijk, maximaal 3). Een run die je start terwijl een andere bezig is toont Wacht en start vanzelf zodra de eerdere klaar is, oudste eerst. Runs van een ander merk worden niet opgehouden.

Meldingen#

Als een run eindigt, toont de bel in de balk één melding met je verzoek erachter: "3 scripts klaar voor review" als hij scripts schreef om te beoordelen, anders "Marketingrun klaar" of "Marketingrun mislukt", en "Marketingrun gepauzeerd op de kostenlimiet" of "Marketingrun gepauzeerd op de maandlimiet" als hij pauzeerde. Bij een merk dat op je agent draait, stuurt een stap die 30 minuten door niemand wordt opgepakt één keer per stap "Je agent heeft {step} niet opgepakt". Klik erop om de run te openen. Een run die je annuleert stuurt niets. De mobiele app stuurt dezelfde gebeurtenissen als pushmelding.

Wie wat mag#

Starten, annuleren, Opnieuw proberen en het model van een stap wisselen vragen bewerktoegang tot marketing. Doorgaan na de kostenlimiet of de maandlimiet vraagt de goedkeurrechten. Leden met leestoegang zien runs en hun pagina's.

Op mobiel#

De Borkol-app start runs vanuit hetzelfde vraagvak, toont runs per dag en laat een run zien als lijst van zijn stappen met status, model, duur en kosten. Doorgaan, Opnieuw proberen en Run annuleren volgen dezelfde regels als hier; het pijplijncanvas, het stappaneel en de briefing blijven op het web. Zie Marketing op mobiel.