Een AI agent bouwen: stappenplan in 6 stappen

1. Kies één afgebakende taak

Begin met een taak met een duidelijk eindresultaat. "Help met klantenservice" is te breed. "Zoek bij elke nieuwe aanvraag de klantgegevens op en schrijf een conceptantwoord" is concreet. Je weet wat erin gaat, wat eruit moet komen en wanneer het goed is.

2. Controleer of je een agent nodig hebt

Liggen de stappen vast, dan is een workflow eenvoudiger en voorspelbaarder. Anthropic beschrijft daarvoor onder meer prompt chaining (stappen na elkaar), routing (een vraag naar de juiste afhandeling sturen) en parallelization (deeltaken tegelijk laten doen). Een agent is pas nodig als je vooraf niet weet hoeveel stappen de taak vraagt. Het verschil lees je in Hoe werkt een AI agent?.

3. Bepaal welke tools de agent nodig heeft

Schrijf op welke acties de agent moet kunnen doen. Leg per tool vast wat hij doet, welke invoer hij verwacht en wat hij teruggeeft. Begin met zo weinig mogelijk tools. Geef eerst alleen tools die lezen. Tools die iets wijzigen of versturen voeg je later toe, met een bevestiging door een mens.

4. Schrijf instructies en tool-omschrijvingen

Het model kiest tools op basis van hun naam en omschrijving. Schrijf die alsof je ze uitlegt aan een nieuwe collega: wanneer gebruik je deze tool, wat geef je mee en wanneer juist niet. Beschrijf in de systeeminstructie de taak, het gewenste eindresultaat en wat de agent moet doen als informatie ontbreekt.

5. Bouw de loop met grenzen

De loop zelf is kort: model aanroepen, tool uitvoeren, resultaat teruggeven, herhalen. Bouw er wel grenzen in:

• Een maximum aantal stappen, zodat de agent niet eindeloos doorgaat.
• Logging van elke stap, zodat je achteraf ziet wat de agent deed en waarom.
• Een akkoord van een mens voor acties die je niet kunt terugdraaien.

Anthropic adviseert te beginnen met de API van het taalmodel. Veel patronen schrijf je in een paar regels code, en je ziet precies wat er gebeurt.

6. Test met echte voorbeelden

Verzamel echte gevallen uit je werk, inclusief lastige en onvolledige. Laat de agent ze afhandelen en kijk waar het misgaat: koos hij de verkeerde tool, ontbrak er informatie, of was de instructie onduidelijk? Pas de instructies en tools aan en test opnieuw. Houd ook bij hoeveel stappen en tokens een taak kost, want daar hangen de kosten van af.

Samen bouwen

Een agent bouwen leer je het snelst door het te doen. In de 1-op-1 training AI agent bouwen loop je deze stappen in 3 uur door met Tarik, voor je eigen case.