Ontwerp AI-Agenten en Automatiseringsworkflows

Bouw agentische AI-systemen en automatiseringsworkflows met herbruikbare prompts, staatbeheer en integratiepatronen die betrouwbaar schaalen over n8n, API's en LLMs.

Door Copy&Prompt TEAM · Gepubliceerd juni 2025 · Bijgewerkt juni 2025

Snel antwoord: Ontwerp AI-agenten door elk een vaste rol, begrensde toolset, kortetermijngeheugen en stopvoorwaarde. Koppel ze aan workflows met deterministische triggers (webhooks, schema's of API-aanroepen) en geef gestructumeerd JSON tussen stappen door. Bewaar elke herbruikbare agentprompt extern zodat updates zich instant over alle workflows verspreiden. Valideer elke agent tegen drie foutmodi voordat u ze koppelt: time-out, lus en gefingeerde toolaanroep.

Inleiding

U wilt AI-agenten bouwen die niet instorten na de derde run. U wilt automatiseringsworkflows die overleven model-updates en teamwijzigingen. U wilt systemen die herstellen vanuit fouten in plaats van ze te vergroten.

Deze gids neemt u mee door de architectuurlaag die elk team overslapt. We behandelen staatbeheer, promptversionering, toolcontracten en integratiepatronen met behulp van Copy&Prompt, n8n en raw LLM API's.

Timebox: 45 minuten. Moeilijkheid: gemiddeld. U dient al bekend te zijn met API-aanroepen en basis systeemprompts te kunnen schrijven.

Vereisten

• Een OpenAI, Anthropic of Gemini API-sleutel (of zelfgehost model).
• Toegang tot Copy&Prompt voor promptversionering (gratis tier voldoende).
• Een workflowtool: n8n (lokaal of cloud), Make, of een lichtgewicht Node.js-script.
• Basiskennis van JSON-schema's en REST API's.
• Budget: nul bij gebruik van gratis tiers. Reken op API-kosten boven 10.000 maandelijkse oproepen.

Stap 1: Definieer het Agentcontract

Begin met een contract, niet met code. Elke agent moet zijn rol, invoer, uitvoer, foutgedrag en tools definiëren in één, geversioneerde prompt.

{
  "role": "Hoofdonderzoekanalist",
  "input": "Een klantvraag-string",
  "output": "Gestructumeerd JSON met sleutels: intentie, urgentie, aanbevolen_volgende_stap",
  "timeout_seconds": 30,
  "max_retries": 2,
  "tools": ["web_zoeken", "samenvatten"],
  "failure_mode": "escaleren_naar_mens"

Tip: Codeer het contract nooit vast in de workflowlogica. Bewaar het als een prompttemplate in Copy&Prompt zodat elke workflow dezelfde definitie ophaalt.

Fout: "Tools" definiëren als vrije strings in plaats van getypte API's. Het model zal parameters verzinnen.

Stap 2: Externaliseer Prompts Naar een Geversioneerde Bibliotheek

De grootste bron van drift zijn inline prompts. Als u een systeemprompt bijwerkt in n8n, moet u handmatig elke workflow opnieuw publiceren. Bewaar prompts in plaats daarvan extern.

Gebruik Copy&Prompt om elke agentprompt te hosten. Elke prompt krijgt een stabiele id:

GET https://api.copyandprompt.com/v1/prompts/{prompt_id}?version=latest

Workflows roepen dit eindpunt tijdens runtime aan. Een enkele promptupdate zorgt instant voor verspreiding overal.

Tip: Vergrendel de versie-hash in productieworkflows. Schakel alleen automatische updates in in de testomgeving.

Fout: "latest" gebruiken in productie. Een goede promptwijziging kan stilletjes 80% van de workflows verstoren in één nacht.

Stap 3: Bouw de Uitvoitlus

Elke agent doorloopt drie fasen: initialiseren, actuatoreren, termineren.

1. Initialiseren: Laad het agentcontract van uw geversioneerde bibliotheek.
2. Actuator: Roep de LLM aan met rol + context + tools. Parseer de JSON-reactie.
3. Termineren: Controleer stopvoorwaarden. Als ze zijn vervuld, retourneer het resultaat. Als niet, beslis volgende actie.

while not exit_condition_met:
    response = call_llm(system_prompt, user_input, tools)
    action = parse_action(response)
    if action.type == "search":
        result = web_search(action.query)
        tool_result = summarize(result)
    elif action.type == "finish":
        return action.output
    else:
        escalate_to_human()

Tip: Limiet iteraties tot 5–10 lussen. Geen enkele agent moet eeuwig draaien.

Fout: Geen iteratielimiet. Agenten draaien eindeloos op onduidelijke invoer.

Stap 4: Ontwerp Deterministische Integratiepunten

Agenten zijn niet-deterministisch. Workflows moeten deterministisch zijn. Koppel ze met gestructuurde contracten.

Elke agentuitvoer wordt een JSON-object dat wordt doorgegeven aan het volgende stappel. Definieer schema's bij elke doorstroom:

{
  "type": "object",
  "properties": {
    "intent": {"type": "string", "enum": ["billing", "technical", "sales"]},
    "urgency": {"type": "integer", "minimum": 1, "maximum": 5},
    "next_step": {"type": "string"}
  },
  "required": ["intent", "urgency", "next_step"]
}

Tip: Gebruik Zod-schema's in TypeScript om agentuitvoer validatiefouten voor ze door te sturen.

Fout: Rauwe tekst tussen agenten doorsturen. Onstructuurde data vergroot fouten.

Stap 5: Koppel Agenten Aan Workflows

Gebruik n8n of een scriptrunner om te orkesteren. Elk knooppunt roept een agent via HTTP aan.

Voorbeeld n8n-stroom:

1. Webhook ontvangt klant-e-mail.
2. Knooppunt 1 roept Intent Classificatiefunctie Agent. Parseert JSON-uitvoer.
3. Knooppunt 2 routeert naar Billing of Technische agent op basis van intentie.
4. Knooppunt 3 roept Knowledge Base Agent aan met gestructureerde context.
5. Eindknooppunt verzendt antwoord via e-mail of Slack.

Tip: Voeg een “kwaliteitshek” toe tussen agenten. Valideer JSON-schema vóór doorsturing.

Fout: Lineaire kettingen zonder foutfall-back. Eén slechte agent breekt de volledige stroom.

Stap 6: Beheer Staatsbeheer

De meeste agentenfouten zijn het gevolg van verloren context. Gebruik een persistente staatsopslag.

Implementeer een eenvoudige sleutel-waarde-opslag (Redis, SQLite, zelfs een JSON-bestand) per workflowinstantie:

{
  "run_id": "abc-123",
  "current_agent": "knowledge_base",
  "history": [
    {"agent": "intent_classifier", "output": {...}},
    {"agent": "knowledge_base", "output": {...}}
  ],
  "user_context": {
    "customer_id": "cust_99",
    "previous_ticket": "TKT-3321"
  }
}

Tip: Log elke agentinteractie. Herstel begint met traceerbaarheid.

Fout: Geen staatspersistatie. Lange workflows vergeten vorige beslissingen.

Stap 7: Implementeer Monitoring en Herstel

Monitor drie metrieken per agent:

• Exit-rate: Percentage runs dat een terminale staat bereikt.
• Retry-rate: Percentage toolaanroepen die opnieuw moeten proberen.
• Hallucinatiefrequentie: Percentage onjuiste JSON-uitvoer.

Zet waarschuwingen wanneer een willekeurige frequentie hoger is dan 5%. Herhaal mislukte agenten automatisch één keer, daarna escaleren.

Tip: Bewaar mislukte runs met volledige context. Herlaat ze door een gecorrigeerde prompt om herstel te testen.

Fout: Geen waarschuwingen. Stille degradatie vernietigt vertrouwen in het systeem.

Hoe Verifieer Je Dat Het Werkt

Test elke agent tegen drie scenario's:

1. Gelukkige pad: Duidelijke invoer die past bij het agentcontract.
2. Twijfelachtige invoer: Grensgeval dat de agent dwingt om om aanvullende informatie te vragen.
3. Mislukte tool: Simuleer een time-out of API-fout. Bevestig escalation activeert.

Alle drie moeten slagen voordat implementatie plaatsvindt.

Oplossen Van Veelvoorkomende Fouten

Agent loopt eindeloos

Oorzaak: Geen iteratielimiet of verkeerde stopvoorwaarde.

Oplossing: Handhaaft een harde luslimiet van 10 rondes. Log elke iteratie.

Schema-misvalidatie van uitvoer

Oorzaak: Promptdrift of ongeversioneerde templates.

Oplossing: Valideert elke uitvoer tegen het schema. Vergrendel promptversies.

Workflow blijft hangen op één agent

Oorzaak: Geen time-outbehandeling of retrylogica.

Oplossing: Voeg schakelcircuutlogica toe. Routeer fouten naar een menselijke escalatiefunctie.

Belangrijkste Inzichten

• Definieer elke agent met een vast contract buiten code opgeslagen.
• Externaliseer prompts in een geversioneerde bibliotheek zoals Copy&Prompt.
• Limiet agentlussen. Laat ze nooit onbegrensd draaien.
• Geef gestructumeerd JSON tussen agenten door. Nooit rauwe tekst.
• Monitor exit, retry en hallucinatiefrequentie. Waarschuwing bij 5%.
• Test agenten op gelukkige, twijfelachtige en fatale invoer.

Volgende Stap

Neem uw bestlopende agent vandaag noch. Verplaats de prompt naar Copy&Prompt. Vervang de inline-versie door een API-aanroep. Implementeer één workflow met dit patroon. U zult drift vangen voordat die productie breekt.

Veelgestelde Vragen

Kan ik agenten bouwen zonder n8n?

Ja. Gebruik een lichtgewicht Node.js-script met Express voor HTTP-triggers. n8n biedt geen unieke mogelijkheid boven visuele orkestrering. Het belangrijkste zijn gestructureerde doorstroom en persistente staat.

Hoeveel agenten moet één workflow hebben?

Limiet tot 5–7 agenten per workflow. Daarna bovenop schaalt foutcomplexiteit exponentieel. Minder agenten met rijkere tooltoegang schalen beter dan lange kettingen.

Verbeter uw AI-resultaten vandaag nog - Maak betere prompts en krijg nauwkeurigere antwoorden met Copy&Prompt. Copy&Prompt →