spinny:~/writing $ less context-engineering-agents.md
12Het woord van dit moment, in de kleine wereld van AI-agenten, is context engineering.34Het lijkt alsof er weer een label is uitgevonden om iets te verkopen dat we al deden. Voor een deel is dat zo. Maar zoals vaak gebeurt, slaat het etiket aan omdat het een naam geeft aan een echte pijn.56De pijn is dit: modellen falen niet alleen omdat ze ‘niet denken’. Vaak falen ze omdat we ze met de verkeerde kamer naar het werk sturen.78We geven ze oude instructies. We verbergen belangrijke bestanden voor hem. We geven ze documenten door die te lang zijn en zeggen niet wat er toe doet. We laten ze logboeken zien zonder prioriteit. We geven ze tien hulpmiddelen zonder uit te leggen wanneer ze te gebruiken. Dan zijn we verrast als de agent zich beweegt als een persoon die wakker wordt in een onbekend appartement.910De prompt is de zin die u erop zegt. De context is de wereld die je eromheen voorbereidt.1112## Van prompt-engineering naar context-engineering1314Snelle engineering werd vaak gezien als schrijven. Kies de juiste woorden, vraag op de juiste manier, voeg voorbeelden toe, specificeer het format.1516Context engineering staat dichter bij architectuur.1718Je vraagt niet alleen maar: “hoe formuleer ik het verzoek?”. Het vraagt:1920- welke informatie is echt nodig?21- wat is lawaai?22- wat moet er direct worden hersteld?23- wat moet onthouden worden?24- welke instrumenten moeten worden blootgesteld?25- welke instructies zijn stabiel en welke zijn afhankelijk van de taak?26- hoe zorg ik ervoor dat de agent begrijpt wat gezaghebbend is?2728Het is een subtiele maar enorme verandering. Want als je met agenten werkt, is context geen statisch blok. Het verandert bij elke stap.2930De agent opent een bestand, leert iets, voert een test uit, ontvangt een foutmelding, werkt het plan bij, roept een tool aan, ontdekt een afhankelijkheid. Elke ronde moet hij beslissen wat hij meeneemt en wat hij weglaat.3132Dit is techniek.3334## De context is geen stortplaats3536Sjablonen met grote contextvensters brachten ons in de verleiding: laten we alles erin gooien.3738Het is begrijpelijk. Als ik een miljoen tokens heb, waarom zou ik dan kiezen?3940Want zelfs als je alles erin kunt stoppen, wil dat nog niet zeggen dat alles helpt. Lawaai heeft inderdaad een prijs. Het kost tokens, het kost aandacht, het kost latentie, het kost kwaliteit. Een model kan net als wij verdwalen in irrelevante details wanneer we twintig tabbladen openen en niet meer weten waarom.4142Goede context kent een hiërarchie:43441. systeeminstructies en beleid;452. specifieke doelstelling;463. huidige status;474. relevante gegevens;485. beperkingen;496. beschikbare hulpmiddelen;507. volg de reeds genomen beslissingen.5152Het is niet nodig om alles op hetzelfde niveau te behandelen. Een gebruikersopdracht is meer waard dan een oude notitie. Een mislukte test is nu meer waard dan een esthetische voorkeur van drie maanden geleden. Een beveiligingsbeleid is meer waard dan een productiesnelkoppeling.5354Context-engineering betekent ook het geven van gewichten, niet alleen aan gegevens.5556## Geheugen: onthoud minder, onthoud beter5758Het geheugen bij agenten is een van de meest lastige onderwerpen.5960Als gebruiker wilt u dat de agent u kent. Je wilt dat hij de toon onthoudt, het plan, de conventies, de dingen die al besloten zijn. Als ingenieur weet je dat elke hardnekkige herinnering ook een risico inhoudt: ze kan verkeerd, oud, te persoonlijk, te algemeen, niet verifieerbaar zijn.6162Een nuttig geheugen moet minstens drie kwaliteiten hebben:6364- herkomst: waar komt deze informatie vandaan?65- datum: wanneer was het waar?66- doel: voor welk soort taak moet het worden gebruikt?6768Zonder deze drie dingen wordt de herinnering bijgeloof.6970Ik beschouw het agentische geheugen graag als een werkboek, niet als een magische geest. Er zijn tijdelijke aantekeningen, bevestigde beslissingen, stijlvoorkeuren, technische beperkingen, links naar bronnen. Sommige dingen vervallen. Sommige moeten herschreven worden. Sommige moeten worden geëlimineerd omdat de agent ze verkeerd heeft geïnterpreteerd.7172Een goed systeem moet dit onderhoud normaal maken. Niet heroïsch.7374## Ophalen en gereedschap zijn niet hetzelfde7576Als we het over context hebben, komen we vaak meteen op RAG terecht. Inbedding, vectordatabase, chunking, herrangschikking.7778Allemaal nuttig. Maar ophalen is slechts één manier om informatie naar het model te brengen. Hij is niet de enige.7980Een agent kan context krijgen door bestanden te lezen, een API te bevragen, een MCP-server aan te roepen, een browser te openen, tests uit te voeren, in Slack te zoeken, naar een dashboard te kijken, de mens te vragen.8182Het interessante deel is beslissen welke route je moet gebruiken en wanneer.8384Als de agent een historische vraag moet beantwoorden, is het ophalen misschien voldoende. Als hij een bug moet repareren, moet hij echte code lezen. Als hij wil begrijpen waarom een implementatie mislukt, moet hij naar nieuwe logboeken kijken. Als u een klant wilt schrijven, moet u de toon, de geschiedenis en de status van het ticket ophalen. Als hij tijdens de productie moet optreden, moet hij toestemming vragen.8586Context is geen database. Het is een werkstroom.8788## De goede agent weet ook hoe hij moet negeren8990Een teken van volwassenheid bij agenten zal het vermogen zijn om te zeggen: ik heb deze informatie niet nodig.9192Het lijkt triviaal, maar het is heel moeilijk. Veel agentische systemen stapelen zich op. Elke tooloproep voegt tekst toe. Elke fout blijft in de buffer. Elk gelezen bestand wordt toegevoegd aan de stapel. Uiteindelijk heeft het model een zeer lange geschiedenis en geen kaart.9394Compressie is nodig. Tussensynthese is nodig. Het moet gestructureerd zijn.9596Niet "dat is alles wat er gebeurde", maar:9798- doelstelling nog steeds geldig;99- huidige hypothese;100- bestanden al gecontroleerd;101- genomen beslissingen;102- openstaande risico's;103- volgende actie.104105Dit maakt de agent minder theatraal en behulpzamer. Niet omdat hij slimmer lijkt, maar omdat hij met een opgeruimd bureau werkt.106107## Context-engineering voor teams, niet voor snelle artiesten108109De reden dat dit onderwerp mij interesseert, is dat het de verantwoordelijkheid verschuift van het individu naar het systeem.110111Bij snelle engineering wint vaak degene die het beste met het model kan praten. Bij context engineering wint het team dat zijn werk het beste organiseert: documentatie, conventies, issues, logs, tests, eigendom, naamgeving, bronnen.112113Een schone repository wordt een betere context. Een goed geschreven probleem wordt betere brandstof. Een bijgewerkt runbook bespaart tokens en zorgen. Een duidelijk changelog vermindert hallucinaties.114115Dit is goed en enigszins ongemakkelijk nieuws. Mooi omdat het goede praktijken beloont. Lastig, want met een slimme prompt kun je niet alles oplossen.116117De agenten versterken de hygiëne van het systeem dat ze aantreffen.118119## Hoe ik het morgen zou toepassen120121Als ik context-engineering in een echt project zou introduceren, zou ik beginnen met kleine dingen:122123- een kort en onderhouden projectinstructiebestand;124- goede voorbeelden van verwachte output;125- een lijst met beschikbare hulpmiddelen en cases waarin deze kunnen worden gebruikt;126- bouwkundige beslissingen op citeerbare wijze geschreven;127- probleem met minimale verplichte context;128- eenvoudig opvragen van logs en tests;129- persistent geheugen dat door mensen kan worden gewijzigd.130131Dan zou ik iets simpels meten: hoe vaak moet de agent om opheldering vragen of gaat hij de verkeerde kant op?132133Als het vaak voorkomt, zou ik niet meteen een groter model toevoegen. Ik zou naar de context kijken.134135## Mijn lezing136137Context-engineering is een beetje een opgeblazen woord, ja. Maar het concept is gezond.138139Het herinnert ons eraan dat de intelligentie van een agent niet alleen in het model zit. Het ligt in de omgeving die we voor hem voorbereiden: wat hij ziet, wat hij zich herinnert, wat hij kan doen, wat hij niet mag doen, welke bronnen hij als waar herkent.140141Het menselijke deel is dit: de context goed voorbereiden is een vorm van zorg. Het zegt tegen de agent, maar ook tegen het team: "Ik wil niet dat je het raadt, ik wil dat je krijgt wat je nodig hebt."142143Minder magie. Schonere kamer. Agenten hebben het net zo hard nodig als wij.144145## Bronnen146147- [LangChain Blog: De opkomst van context-engineering](https://blog.langchain.com/the-rise-of-context-engineering/)148- [Simon Willison: Context-engineering](https://simonwillison.net/2025/Jun/27/context-engineering/)149- [Model Context Protocol: Introductie](https://modelcontextprotocol.io/introduction)150- [Antropisch: effectieve agenten bouwen](https://www.anthropic.com/engineering/building-effectieve-agents)151- [OpenAI: nieuwe tools voor bouwagenten](https://openai.com/index/new-tools-for-building-agents/)152
:Context engineering: het werk vóór de promptlines 1-152 (END) — press q to close