Kernconcepten

Inleiding

Welkom bij Workflows fundamentals. Deze gids behandelt alles wat je moet weten om te begrijpen hoe workflows werken — van individuele nodes tot uitvoeringspatronen, versionering en teststrategieën.

Voor het eerst hier? Dit is je routekaart. Lees alles door om de kernconcepten te begrijpen en bekijk daarna de Getting Started-gids om je eerste workflow te bouwen: https://docs.langdock.com/product/workflows/getting-started


Wat is een Node?

Een node is de fundamentele bouwsteen van een workflow. Zie het als een stap in een recept — elke node doet één ding en je schakelt ze aan elkaar om je volledige automatisering te creëren. Nodes kunnen dingen doen zoals:

  • AI-agents uitvoeren om inhoud te analyseren of te genereren

  • HTTP-aanvragen doen naar externe API's

  • Gegevens transformeren met aangepaste code

  • Uitvoering routeren op basis van voorwaarden

  • Meldingen naar teamleden sturen

Je verbindt nodes met elkaar om een volledige workflow te maken die je proces van begin tot eind automatiseert.

Visueel programmeren: Workflows gebruiken een visueel canvas waar je nodes kunt slepen, neerzetten en verbinden. Geen coderen vereist (tenzij je een Code-node wilt gebruiken)!

Nodes

Begrijpen van de Node-structuur

Elke node heeft een paar gemeenschappelijke elementen die het werken ermee gemakkelijk maken:

De Node-header

Laat het node-type en de naam zien. Klik hier op de afspeelknop om de node afzonderlijk te testen — erg handig voor het debuggen!

Invoer- en uitvoertabbladen

Nadat een node is uitgevoerd, kun je erop klikken om te zien:

  • Invoertabblad: Welke gegevens de node heeft ontvangen

  • Uitvoertabblad: Welke gegevens de node heeft geproduceerd

Deze gegevens stromen naar de volgende nodes in je workflow.

Configuratiepaneel

Klik op een node om de instellingen in het zijpaneel te openen. Hier configureer je wat de node doet, selecteer je AI-modellen, stel je verbindingen met externe services in en meer.

Configuratiepaneel

Werken met variabelen

Gegevens stromen via variabelen. Wanneer een node klaar is met uitvoeren, wordt de output beschikbaar als een variabele die je kunt gebruiken in latere nodes. Zo beweegt informatie zich door je workflow.

De basisprincipes

Gebruik dubbele accolades om naar variabelen te verwijzen. Voorbeelden:

{{form1.output.email}}
{{analyze_data.output.structured.summary}}
{{api_response.data.items[0].title}}

Velden configureren met variabelen

Elke node heeft velden die geconfigureerd moeten worden. Je kunt variabelen gebruiken in de meeste tekstvelden, of kiezen uit drie veldmodi:

  • Automodus: Laat de workflow automatisch de beste waarde bepalen

  • Handmatige modus: Voer exacte waarden in of gebruik variabelen zoals {{form1.output.email}}

  • AI Prompt-modus: Geef instructies zodat AI dynamische inhoud genereert

Lees over Veldmodi: https://docs.langdock.com/product/workflows/field-modes

Pro tip: Wanneer je {{ in een veld typt, zie je een dropdown met alle beschikbare variabelen uit vorige nodes.


Hoe workflows worden uitgevoerd

Begrijpen hoe uitvoering werkt is essentieel. Workflows kunnen nodes sequentieel (één na één) of parallel (tegelijkertijd) uitvoeren. Weten hoe uitvoering werkt helpt je snellere, efficiëntere automatiseringen te bouwen.

Sequentiële uitvoering

Standaard voert je workflow nodes één voor één uit, volgens de verbindingen die je hebt getekend. Elke node wacht tot de vorige is voltooid voordat hij begint.

Parallelle uitvoering

Wanneer je meerdere nodes verbindt met één bronnode, kunnen ze tegelijk draaien. Dit versnelt je workflow wanneer nodes niet van elkaar afhankelijk zijn.

Voorbeeld (diagram):

              → E-mail verzenden →
Trigger →    → Ticket aanmaken →    → Doorgaan
              → Database bijwerken →

Alle drie de nodes na de trigger kunnen parallel draaien omdat ze onafhankelijk zijn.

Nodes

Foutafhandeling

Je bepaalt wat er gebeurt wanneer er iets misgaat. Voor elke node kun je kiezen:

  • Workflow laten falen: Stop alles en markeer de uitvoering als mislukt (goed voor kritieke stappen)

  • Workflow voortzetten: Log de fout maar ga door (goed voor niet-kritische acties)

  • Foutterugroep: Routeer naar andere nodes bij een fout met de rode fout-handle (goed voor fallback-logica)

Je kunt foutafhandeling voor elke node afzonderlijk configureren via de node-instellingen.

Nodes

Workflow-versies

Versiebeheer voor workflows. Elke workflow heeft versies, vergelijkbaar met Git voor code. Dit houdt productie stabiel terwijl je veilig wijzigingen aanbrengt in de conceptmodus.

Conceptversie (v0)

Dit is je sandbox. Breng wijzigingen aan, test dingen en experimenteer zonder iets in productie te beïnvloeden. De conceptversie is altijd gelabeld v0.

Gepubliceerde versies

Wanneer je tevreden bent met je wijzigingen, publiceer je ze om een nieuwe versie te maken (v1.0.0, v1.1.0, enz.). Gepubliceerde versies zijn:

  • Immuteerbaar: Ze kunnen niet worden gewijzigd, wat productie stabiel houdt

  • Geactiveerd voor triggers: Alleen actieve gepubliceerde versies reageren op echte triggers

  • Gedocumenteerd: Elke versie bevat een beschrijving van wat er is veranderd

  • Klaar voor rollback: Je kunt indien nodig een oudere versie opnieuw activeren

Bij publiceren kies je het type bump:

  • Patch (1.0.0 → 1.0.1): Bugfixes en kleine aanpassingen

  • Minor (1.0.0 → 1.1.0): Nieuwe functies of nodes

  • Major (1.0.0 → 2.0.0): Brekende wijzigingen

Test alles in de conceptversie voordat je publiceert. Je kunt volledige workflowtests uitvoeren zonder productie-triggers te beïnvloeden.


Je workflow testen

Test vroeg, test vaak. Wacht niet tot je workflow compleet is om te beginnen met testen. Test elke node tijdens het bouwen om problemen vroeg te ontdekken.

Individuele nodes testen

Klik op de afspeelknop van een node om alleen dat onderdeel te testen. Dit is uitstekend voor:

  • De output van een agent verifiëren voordat je de rest van de workflow bouwt

  • Controleren of een API-aanroep de verwachte gegevens retourneert

  • Problemen debuggen in specifieke nodes

Complete workflows testen

Gebruik de knop “Test run” op de trigger-node om de gehele workflow uit te voeren met voorbeeldgegevens. Dit doorloopt alle nodes maar markeert gebeurtenissen niet als verwerkt, zodat je veilig kunt testen.

Resultaten bekijken

Na elke testrun kun je op nodes klikken om te zien:

  • Invoer: Welke gegevens de node heeft ontvangen

  • Uitvoer: Wat het heeft geproduceerd

  • Berichten: Voor agent-nodes, het volledige AI-gesprek

  • Logs: Voor code-nodes, alle console-uitvoer

  • Gebruik: Hoeveel AI-credits zijn verbruikt


Verbindingen tussen nodes

Verbindingen bepalen de flow. De lijnen tussen nodes bepalen de uitvoeringsvolgorde en hoe gegevens door je workflow stromen.

Verbindingshandles

Nodes hebben verbindingspunten (handles) aan hun zijkanten:

  • Linkerkant (invoer): Waar de uitvoering binnenkomt

  • Rechterkant (uitvoer): Waar de uitvoering uitgaat

  • Meerdere outputs: Condition-nodes hebben één output per voorwaarde

  • Rode handle: Speciale foutoutput (verschijnt wanneer foutafhandeling is ingeschakeld)

Verbindingen tekenen

Klik en sleep van een output-handle naar een input-handle. De lijn toont de uitvoeringsstroom. Workflows voeren uit in de volgorde die door deze verbindingen is gedefinieerd.


Workflow-status

Je workflow kan zich in een van de drie toestanden bevinden:

  • Niet ingezet

  • Aan

  • Uit

Niet ingezet: Wordt nog gebouwd — er worden geen automatische triggers uitgevoerd. Veilig om wijzigingen aan te brengen en te testen.

Nodes

Menselijk toezicht

Voor gevoelige acties zoals financiële transacties of het verwijderen van gegevens kun je handmatige goedkeuring vereisen voordat je doorgaat: Human in the Loop — Voeg handmatige goedkeuringsstappen toe voor belangrijke acties die menselijk toezicht vereisen: https://docs.langdock.com/product/workflows/human-in-the-loop


Beste praktijken

  • Geef nodes duidelijke namen: “Analyseer feedback” in plaats van “Agent 1”

  • Houd workflows gefocust: Eén workflow, één doel

  • Test vroeg en vaak: Test elke node tijdens het bouwen

  • Voeg opmerkingen toe: Documenteer complexe logica voor je toekomstige zelf


Volgende stappen

Nu je de basisprincipes begrijpt, duik dieper in specifieke onderwerpen:

  • Veldmodi — Configureer node-velden met Automatisch, Handmatig en AI Prompt-modi: https://docs.langdock.com/product/workflows/field-modes

  • Human in the Loop — Voeg handmatige goedkeuring toe voor gevoelige acties: https://docs.langdock.com/product/workflows/human-in-the-loop

  • Getting Started — Bouw je eerste workflow stap voor stap: https://docs.langdock.com/product/workflows/getting-started

  • Node-typen — Ontdek alle beschikbare triggers en nodes: https://docs.langdock.com/product/workflows/nodes/manual-trigger


Was deze pagina nuttig? Ja / Nee

(Reacties worden gegenereerd met AI en kunnen fouten bevatten.)