Framework
GRAIN De RAG-engineer
GRAIN is een retrieval-loop: Gather, Rank, Assemble, Inspect, Navigate. Gather verzamelt kandidaat-passages. Rank ordent ze voor de daadwerkelijk gestelde vraag. Assemble bouwt de context die het model mag zien. Inspect controleert of de geciteerde chunk ook degene is die gebruikt is. Navigate beslist over de volgende lookup of de weigering. Als je de passage niet kunt aanwijzen, heb je geen retrieval. Je hebt een vloeiende gok.
- De zetten
- 5
Wanneer je het gebruikt
Gebruik het wanneer een RAG-demo met een strak gezicht de verkeerde paragraaf citeert. Als het team de chunk die het model gebruikte niet kan openen, is de loop gebroken bij Inspect.
De zetten
- 01
Gather
Bronkeuze, rechten, versionering en het corpuscontract dat bepaalt wat in de index hoort.
- 02
Rank
Eerste-fase retrieval (dense, sparse of hybride), daarna een reranker die kandidaten ordent vóór assemblage.
- 03
Assemble
Tokenbudget, chunkvolgorde, deduplicatie, instructielayout en citaties die bewijs bruikbaar houden.
- 04
Inspect
Failure traces, bad-chunk workflows en eval-suites die een fout antwoord koppelen aan een retrievalbeslissing.
- 05
Navigate
TTL-beleid, re-ingest jobs, change detection en signalen die tonen hoe oud een antwoord kan zijn.
Faalmodi
Waarom de demo in productie faalt
Als je de bron achter de zin niet kunt openen, heb je geen RAG. Je hebt een chatvenster met extra tekst erin geplakt. GRAIN is de inspecteerbare loop. Falen is bijna altijd een benoemde letter, geen zwakker model.
- 01
Gather
Geen corpuscontract: rechten, versionering en wat in de index hoort zijn nooit opgeschreven. Verouderde bestanden blijven vindbaar.
- 02
Rank
Kandidaten worden geordend voor een andere vraag, of nooit gererankt. De first-stage-hit wordt behandeld als het antwoord.
- 03
Assemble
De geciteerde chunk zit niet in het venster dat het model echt zag. Context is volgepropt; bewijs is niet bruikbaar.
- 04
Inspect
Niemand kan de gebruikte passage openen. Er is geen eval die een fout antwoord koppelt aan een retrievalbeslissing.
- 05
Navigate
Geen TTL, geen re-ingest, geen signaal hoe oud het antwoord kan zijn. De demo was vers. Productie is dat niet.
Het boek
De RAG-engineer
Retrieval-systemen waar agents in productie echt op kunnen vertrouwen
Open het boekVerwante frameworks
STACK
De agentische codebase
STACK is een architectuur in vijf lagen voor repositories waarin mensen en agents werk delen: Structure, Toolchain, Agent configuration, Connection, Knowledge and quality. Het agent-besturingssysteem wordt geversioneerd zoals de app.
SENSE
AI-agenten voor startupstrategie
SENSE is een strategische intelligentielaag in vijf zetten: Scan, Evaluate, Navigate, Simulate, Execute. Het maakt van agentwerk geen productiviteitstruc, maar een claim met bron die een watchlist, een aannameregister of een maandagbesluit verandert.
CHORUS
De multi-agent organisatie
CHORUS is een coördinatieprotocol in zes vaardigheden voor teams van 2 tot 15 mensen die werk delen met gespecialiseerde AI-medewerkers: Charter, Handoff, Orchestrate, Review, Update, Sync. Een organogram noemt rapportagelijnen. CHORUS noemt coördinatielijnen.
ROUTE
Het model-portfolio
ROUTE is een discipline van vijf vaardigheden voor het besturen van een mix van taalmodellen: Register, Doel-typering, Uitvoeringsbeleid, Tracken, Evolueren. Register catalogiseert elk model met mandaat, kostenklasse, privacyklasse en uitfaseringsstatus. Doel-typering benoemt wat een taak echt vereist voordat je een model kiest. Uitvoeringsbeleid schrijft de routeringsregels, cascades en fallbacks. Tracken meet kosten, latentie en kwaliteit per route. Evolueren promoveert, degradeert en neemt op een cadans uit bedrijf. Een leaderboardkeuze is een collectie. ROUTE is een portefeuille.
Begrippen
Geen metafoor voor korrelgrootte en niet 'we hebben een vector store toegevoegd'. GRAIN is de inspecteerbare loop. RAG is de architectuur. De RAG-engineer is nu verkrijgbaar in het Engels en het Nederlands als paperback, hardcover en Kindle.
Citatie
GRAIN (De RAG-engineer). Len P. van der Hof, Systemen voor het strategische zelf. https://lenvanderhof.com/nl/frameworks/grain/