Je eigen agent

Standaard voert Borkol elke stap van een run uit op je OpenRouter-sleutel. Draai je al een eigen agent, bijvoorbeeld Hermes Agent, dan kan die de stappen doen, op zijn eigen modellen. Borkol houdt de merkcontext, de pijplijn en de controles; je agent pakt het werk op, leest dezelfde briefing die Borkol zou gebruiken en stuurt de resultaten terug. Voor jou verandert er niets: je typt nog steeds een verzoek op het Overzicht, en de scripts komen nog steeds onder Scripts.

Instellen vraagt drie dingen: een token, de drie installatieblokken in je agent geplakt, en het merk op Je agent gezet.

Een token aanmaken#

Marketing → Instellingen → Verbindingen → Meer · Je eigen agent (/m/marketing/settings/integrations?section=agent) toont de tokens waarmee je agents verbinden. Het stond eerst in een eigen onderdeel van de instellingen; het oude adres /m/marketing/settings/agent opent het nog steeds.

1. Klik op Token aanmaken en geef het een Naam, bijvoorbeeld "Hermes op mijn laptop".
2. Klik op Token aanmaken. Het volgende venster toont het token, dat begint met bka_. Kopieer het token nu: je ziet het maar één keer. Na het sluiten van het venster zijn alleen de laatste vier tekens zichtbaar, en niemand bij Borkol kan het opnieuw tonen.
3. Hetzelfde venster toont de drie installatieblokken met je token al ingevuld (zie hieronder). Kopieer wat je nodig hebt en klik op Klaar.

Meer in het aanmaakvenster bevat twee optionele beperkingen, standaard dicht:

Zodra een token actief is, linkt een regel onder de lijst naar AI-pijplijn, waar je Stappen draaien op voor een merk op Je agent zet.

De lijst toont per token de Naam, de laatste vier tekens onder Token, het Merk, Laatst gebruikt (Nooit tot de agent voor het eerst verbindt) en de Status (Actief of Ingetrokken).

Alleen de accounteigenaar kan tokens aanmaken en intrekken. Teamleden zien de lijst met "Alleen de accounteigenaar kan tokens aanmaken of intrekken."

De drie installatieblokken#

Het eenmalige venster toont de blokken met je token erin. Installatie-instructies onder de tokenlijst toont later dezelfde blokken, met <jouw token> op de plek van het token: plak daar je eigen token.

Met Hermes#

1. Voeg het blok Agentconfiguratie (Hermes) toe aan ~/.hermes/config.yaml.
2. Installeer de skill: hermes skills install https://api.borkol.com/mcp/marketing/SKILL.md (het adres in het blok Skill).
3. Voer de regel uit Planning één keer uit. Hermes draait geplande taken in zijn gateway, dus laat hermes gateway draaien.

Wil je het meteen proberen, vraag Hermes dan "Use the borkol-marketing skill: check Borkol for work and do it."

Een andere MCP-client#

De server spreekt het Model Context Protocol over HTTP, dus elke MCP-client kan verbinden. Wijs hem naar het serveradres uit het configuratieblok en stuur het token mee als Authorization: Bearer <token>. De tekst van de skill werkt als instructie voor elke agent.

Een merk op je agent zetten#

Marketing → Instellingen → AI-pijplijn → Meer → Wie de stappen uitvoert heeft één veld, Stappen draaien op: Borkol (de standaard) of Je agent. Het geldt per merk, zoals elke AI-pijplijninstelling, en je slaat het op via de balk onderaan. Runs die al gestart zijn houden hun instelling. Bij Je agent gelden de stapmodellen niet: je agent kiest zelf zijn modellen, en de pagina zegt dat boven de modellen.

Kies je Je agent terwijl er nog geen token is, dan zie je "Je agent heeft nog geen token. Maak er een aan onder Je eigen agent." met een link naar de tokenpagina.

Een merk dat op je agent draait heeft geen OpenRouter-sleutel nodig: je kunt runs starten zonder.

Wat de agent doet#

Je agent werkt met deze tools op de Borkol Marketing-server:

Elk resultaat wordt gecontroleerd tegen hetzelfde formaat en dezelfde limieten als een stap die Borkol zelf uitvoert: het aantal scripts, hooks per script, de toegestane tags. Uitvoer in de verkeerde vorm gaat terug naar de agent als fout met het veld dat niet klopte, en de agent herstelt het en stuurt het opnieuw. De stap blijft open tot er een geldig resultaat binnenkomt. Scripts krijgen hun advertentiecodes en gaan door de controle, precies zoals bij Borkol.

Wat je agent instuurt is data, nooit een instructie: in latere briefings staat het alleen als geciteerd materiaal, en de controle keurt een script af dat instructie-achtige tekst herhaalt. Kennisitems die de agent tijdens het onderzoek voorstelt wachten op acceptatie onder Kennis, net als voorstellen van elke andere run.

Advertentieresultaten melden#

Een agent die je advertentieplatform kan lezen, kan de resultaten met report_metrics naar Borkol sturen, in plaats van dat jij een bestand importeert. De resultaten worden precies zo opgeslagen als een import van advertentieresultaten en voeden inzichten. Het token heeft Resultaten terugsturen (work:submit) nodig; zonder dat wordt de tool niet aangeboden.

Argumenten:

Elke rij:

Elke rij wordt gecontroleerd met dezelfde regels als een bestandsimport. Een rij die niet klopt, wordt weggelaten en onder errors vermeld met zijn index, veld en reden; de andere rijen worden opgeslagen. Het antwoord is {ok, created, updated, matched, unmatched, skipped, errors}: matched-rijen zijn via hun advertentiecode aan een script gekoppeld, unmatched-rijen worden bewaard en koppelen zodra het script bestaat, skipped-rijen horen bij een advertentie en dag die de koppeling Meta-advertenties al heeft gesynchroniseerd, zodat ze nooit dubbel tellen. Dezelfde advertentie en dag opnieuw sturen werkt die bij.

Fouten die de hele aanroep stoppen:

Een token dat tot één merk beperkt is, kan brand_id weglaten.

Op de runpagina#

Een run op je agent toont Draait op: Je agent onder Details, en zijn stappen kunnen twee extra statussen tonen:

Een vastgelopen stap zet een regel bovenaan de run: "Je agent heeft een stap niet op tijd opgepakt. Controleer of je agent draait en zijn schema aan staat, of annuleer de run om het merk vrij te maken voor nieuwe runs.", met een link naar Je eigen agent. De bel toont één melding per vastgelopen stap ("Je agent heeft {step} niet opgepakt: {verzoek}"), en de mobiele app stuurt hem als pushmelding. Zodra de agent de stap oppakt, gaat hij gewoon verder. Een vastgelopen run telt nog als actief voor zijn merk, dus met Runs tegelijk op 1 wachten nieuwe runs van dat merk erachter: annuleer de run om het merk vrij te maken.

Een stap die je agent begon maar niet binnen een uur afmaakte, gaat terug naar Wacht op je agent, zodat de volgende controle hem weer kan oppakken.

Kosten#

Je agent betaalt zijn eigen modellen; er gaat niets van je OpenRouter-sleutel af. Meldt de agent zijn kosten, dan toont de runpagina ze per stap en in totaal als gemeld door je agent. Melden is optioneel, dus een stap zonder meldingen toont geen kosten, en een run zonder enige melding toont Niet gemeld door je agent. Het model staat er alleen als de agent het meldde.

De Kostenlimiet per run geldt alleen voor runs op Borkol. Een run op je agent wordt nooit gepauzeerd op de kostenlimiet.

Een token intrekken#

Het rijmenu van een actief token heeft Intrekken. Na bevestigen van "Dit token intrekken?" kan de agent die het gebruikt niet meer verbinden, en de rij toont Ingetrokken. Dit kun je niet ongedaan maken: maak een nieuw token en werk de configuratie van de agent bij. Een stap die de agent had geclaimd gaat meteen terug naar Wacht op je agent, zodat een andere agent hem kan oppakken.

Wie wat mag#

Tokens aanmaken en intrekken mag alleen de eigenaar. Stappen draaien op wijzigen vraagt marketing-bewerkrechten, net als de rest van de AI-pijplijn. Leden met leesrechten zien de tokenlijst en de runpagina's.