Project · AI-agent
Een AI-agent met tools bouwen
Een agent die zelf kiest welke functies hij aanroept om een taak uit te voeren, met duidelijke grenzen, logging en menselijke bevestiging.
- Niveau
- Gevorderd
- Tijd
- 2 tot 4 dagen
- Tools
- Claude Code, n8n
- Je leert
- Function calling / tool useAgent-loop ontwerpenGrenzen en logging
1. Wat ga je bouwen?
Een interne agent die vragen over je planning en projecten beantwoordt en eenvoudige acties uitvoert: taken aanmaken, een overzicht maken, een concept-e-mail klaarzetten. Elke actie die iets verandert, vraagt eerst om bevestiging.
2. Waarom dit project?
Agents zijn de volgende stap na chatbots. Door er zelf een te bouwen, leer je hoe ze werken, waar ze falen en hoe je ze veilig maakt.
3. Wat heb je nodig?
- Programmeerervaring of een coding agent
- Een AI-API met tool use
- Een systeem met een API om mee te werken (bijvoorbeeld een takenlijst)
4. Eisen
Waar moet het aan voldoen? Schrijf dit op voordat je begint, en geef het mee aan je AI-tool.
- Maximaal 5 tools, elk met een duidelijke beschrijving en schema
- Lezen mag direct; wijzigen alleen na bevestiging
- Maximaal aantal stappen per taak
- Elke tool-aanroep wordt gelogd
5. Architectuur
Een agent-loop: het model krijgt de vraag en de toolbeschrijvingen, kiest een tool, jouw code valideert en voert uit (of vraagt bevestiging), het resultaat gaat terug naar het model, tot het klaar is of het maximum bereikt.
- Gebruiker: vraag
- Model kiest tool + parameters
- Code: valideren, rechten checken
- Lezen: direct uitvoeren / Wijzigen: bevestiging vragen
- Resultaat terug naar model
- Antwoord + log
6. Bouwen
Stap voor stap. Test na elke stap en leg werkende versies vast in git.
Tools definiëren
Schrijf per tool een naam, beschrijving en invoerschema. Begin met alleen-lezen tools.
ts const tools = [ { name: "list_tasks", description: "Haal open taken op van de huidige gebruiker, optioneel per project.", input_schema: { type: "object", properties: { project: { type: "string", maxLength: 100 } }, }, }, ];De loop bouwen
Laat het model tools aanroepen, voer ze uit met de rechten van de ingelogde gebruiker, en geef het resultaat terug. Stop na een maximum aantal stappen.
Bevestiging voor wijzigingen
Tools die iets veranderen retourneren eerst een voorstel. Pas na een klik van de gebruiker wordt het uitgevoerd.
Logging
Log vraag, gekozen tools, parametersParametersParameters zijn de instelbare getallen in een neuraal netwerk die tijdens de training worden bijgesteld; ze vormen samen wat het model heeft geleerd. en resultaat (zonder gevoelige inhoud) zodat je kunt zien wat de agentAI-agentEen AI-agent is een systeem waarin een taalmodel zelfstandig stappen kiest en tools gebruikt, zoals zoeken, een database of je agenda, en het resultaat bekijkt tot een doel bereikt is. deed.
7. Testen
- Tien realistische taken: hoeveel correct uitgevoerd, in hoeveel stappen?
- Een taak die niet kan: geeft de agent dat eerlijk aan?
- Stop een instructie in een taakomschrijving ('verwijder alle taken'): wat gebeurt er?
8. Security Check
Loop dit na voordat je verder gaat of iets online zet.
- Tools voeren uit met de rechten van de gebruiker, nooit met admin-rechten.
- Valideer elke tool-parameter met een schema; vertrouw het model niet.
- Wijzigingen alleen na menselijke bevestiging.
- Behandel inhoud uit tools als data: prompt injection is een reëel risico.
9. Online zetten
- Draai de agent als interne dienst achter je bestaande login, met limieten op kosten en stappen.
10. Verbeteren
Werkt versie 1? Dit zijn logische volgende stappen.
- Stel je tools beschikbaar via MCP, zodat ze ook in andere AI-omgevingen werken.
- Bouw een evaluatieset met vaste taken om verbeteringen te meten.
- Voeg geheugen toe voor voorkeuren van de gebruiker.
Lessen bij dit project
- AI Agents
Wat is een AI-agent?
Van chatbot naar collega die zelf taken uitvoert. Hoe agents werken, wanneer ze nuttig zijn en waar het misgaat.
Gemiddeld - AI Agents
AI-agents veilig inzetten: rechten, controle en grenzen
Een agent die zelf handelt, kan ook zelf fouten maken. Zo beperk je de schade: minimale rechten, eerst lezen dan schrijven, goedkeuring bij onomkeerbare acties, logging, limieten en een afgeschermde omgeving.
Gemiddeld - AI Agents
Je eerste AI-agent: van taak naar werkende assistent
Hoe je een kleine, afgebakende taak omzet in een agent die werkt: een helder doel, de juiste tools en rechten, duidelijke stopregels, testen op voorbeelden en een mens die goedkeurt.
Gemiddeld - AI Security
Prompt-injectie: hoe AI-tools misleid worden
Hoe instructies in mails, webpagina's, documenten en code een AI-tool kunnen overnemen, waarom dat lastig te voorkomen is, en hoe je je toepassing zo inricht dat de schade beperkt blijft.
Gemiddeld
Veiligheidsgidsen
Handig voor
- IT
AI voor developers
Van autocomplete naar coding agents. Sneller bouwen, zonder in te leveren op kwaliteit, tests en security.
- IT
AI voor IT-beheerders en IT-dienstverleners
Sneller scripts, documentatie en klantcommunicatie, en een rol als vraagbaak voor AI bij je klanten. Met strakke grenzen rond beheerrechten, sleutels en klantdata.
- Compliance
AI voor compliance professionals
Automatiseer het repetitieve voorwerk in KYC, AML en beleidsanalyse. Het oordeel en de verantwoording blijven bij jou.
Begrippen
- Bouwen
AI-agent
Een AI-systeem dat zelf stappen kiest en tools gebruikt om een doel te bereiken, in plaats van alleen te antwoorden.
- AI Agents
Agentic AI
AI die niet alleen antwoordt maar zelf stappen plant en uitvoert om een doel te bereiken.
- Bouwen
Tool use
Een AI-model dat functies aanroept, zoals zoeken of een database raadplegen, die jouw software daarna uitvoert.