Behandel LangGraph niet als een langere keten
Stop met het zien van LangGraph als LangChain met meer stappen. Die fout leidt tot defecte agents.
LangGraph is bedoeld voor workflows die state, vertakkingen, tool calls en menselijke goedkeuring vereisen. Het is voor agents die fouten moeten kunnen herstellen zonder opnieuw te hoeven starten.
Als je het gebruikt, moet je eerst drie dingen definiëren: state, interrupts en herstel.
De eerste grens: State-schema
Voor een enkele prompt is de grens de tekst. Voor LangGraph is de grens het State-schema. Je moet beslissen:
- Welke velden tussen nodes bewegen.
- Welke velden een node bijwerkt.
- Hoe gelijktijdige vertakkingen waarden samenvoegen.
- Welke waarden in een checkpoint terechtkomen.
- Welke waarden nooit persistent mogen zijn.
Reducers zijn hier cruciaal. Als je geen juiste regel instelt om berichten toe te voegen (append), zal je parallelle werk data verliezen.
Begin klein. Bouw een graph met één schema, één node en één reducer. Als je dat niet werkend krijgt, zullen het toevoegen van tools je fouten alleen maar verbergen.
De runtime-grens
Voordat je compile() aanroept, is je graph slechts een beschrijving. Na compile() neemt de runtime het over.
Wanneer een graph faalt, kijk dan niet alleen naar de node. Controleer deze vier zaken:
- Stelt het State-schema de node in staat om die key te schrijven?
- Geeft de node een geldig State-veld terug?
- Voegt de reducer de data correct samen?
- Heeft de conditional edge een uitgangspad?
De mens in de loop
Behandel menselijke goedkeuring niet als een UI-feature. Behandel het als een contract van de graph.
Een betrouwbaar patroon ziet er als volgt uit:
- Het model stelt een tool call voor.
- De graph genereert een interrupt.
- Een mens keurt de actie goed of bewerkt deze.
- De graph hervat vanaf dat exacte punt.
Dit maakt agents herstelbaar in plaats van alleen reactief.
Je Smoke Checklist
Voordat je naar productie gaat, voer deze test uit:
- Gebruik een tijdelijke map zonder productiedata.
- Definieer een minimale State.
- Schrijf één node die alleen geldige velden teruggeeft.
- Gebruik een reducer voor append-acties.
- Voeg één interrupt toe voor een tool-actie.
- Voeg een checkpointer toe.
- Forceer een fout en verifieer het hervat-gedrag.
Als dit pad faalt, voeg dan geen extra tools toe. Het probleem is je runtime-grens.
LangGraph is niet bedoeld voor eenmalige model-aanroepen. Gebruik het wanneer je AI multi-step werk moet uitvoeren dat inspecteerbaar, pauzeerbaar en controleerbaar is.
Optionele leercommunity: https://t.me/GyaanSetuAi