Dify AI-agenten Handleiding 2026: Autonome AI met tools bouwen
Dify AI-agenten gaan veel verder dan eenvoudige chatbots — ze kunnen het web doorzoeken, Python-code uitvoeren, elke API aanroepen en meerstaps taken autonoom oplossen. Deze handleiding legt alles uit: van je eerste agent tot aangepaste tools en multi-agent-systemen.
Wat zijn Dify AI-agenten?
Een Dify AI-agent is een AI-applicatie die autonoom beslist welke tools hij moet gebruiken om een taak te vervullen. In tegenstelling tot een gewone chatbot die alleen tekst genereert op basis van de prompt, kan een agent echte acties uitvoeren: Google doorzoeken, een Wikipedia-artikel lezen, een Python-script uitvoeren, het huidige weer ophalen of elke REST API aanroepen.
Het cruciale verschil is handelingsvermogen: je geeft de agent een doel (bijv. "Onderzoek de top 5 AI-startups van 2026 en vat hun financiering samen"), en de agent bepaalt zelfstandig de noodzakelijke stappen — websearch, resultaten lezen, informatie filteren en een antwoord samenstellen.
Agent vs. Chatbot vs. Workflow — Wanneer wat gebruiken?
Dify biedt drie hoofdtypen apps. Begrijpen wanneer welk type het meest geschikt is, bespaart tijd en levert betere resultaten:
| Kenmerk | Chatbot | Workflow | Agent |
|---|---|---|---|
| Toolgebruik | ✗ Geen | ✓ Vaste tools | ✓ Dynamische keuze |
| Beslissing | Geen | Vaste vertakkingen | Autonoom redeneren |
| Ideaal voor | Q&A, supportbots | Pipelines, automatisering | Onderzoek, complexe taken |
| Stappen | 1 stap (prompt → antwoord) | Vooraf gedefinieerde stappen | Variabel, bij uitvoering |
| Realtime data | ✗ Nee | Alleen via HTTP-knooppunten | ✓ Ja, via tools |
| Voorspelbaarheid | Hoog | Zeer hoog | Lager (flexibel) |
Gebruik chatbot wanneer...
Je een eenvoudige gespreksassistent nodig hebt voor klantenservice, FAQ-beantwoording of helpdesk. Statische kennis, geen realtime data nodig.
Gebruik workflow wanneer...
Je een herhaalbare, deterministische pipeline hebt: tekst vertalen, artikelen samenvatten, supporttickets classificeren. Altijd dezelfde stappen.
Gebruik agent wanneer...
De taak realtime informatie, meerdere tools of dynamische beslissingen vereist. Onderzoek, concurrentieanalyse, live data-ophaling of complexe meerstaps taken.
Je eerste Dify agent aanmaken
Volg deze stappen om een onderzoeksagent te bouwen die op het web kan zoeken en berekeningen kan uitvoeren. Dit duurt ongeveer 10 minuten:
Nieuwe app aanmaken
Klik in Dify Studio op "+ App aanmaken". Wanneer gevraagd naar het type, kies "Agent". Vul een naam in, bijv. "Onderzoeksassistent".
Systeemprompt schrijven
Beschrijf de rol van de agent. Voorbeeld: "Je bent een onderzoeksassistent. Wanneer actuele informatie nodig is, gebruik Google Search. Gebruik de Calculator voor berekeningen. Citeer altijd je bronnen."
Tools toevoegen
In de sectie "Tools" (linker paneel) klik op "+ Tool toevoegen". Schakel "Google Search" in — je hebt een SerpAPI-sleutel nodig (gratis contingent beschikbaar). Schakel ook "Calculator" in — geen API-sleutel nodig.
Agentstrategie kiezen
Kies bij "Agentstrategie" voor "Function Calling" voor GPT-4o of Claude-modellen. Kies "ReAct" voor open-source modellen zonder native Function Calling.
Model selecteren
Kies GPT-4o of Claude 3.5 Sonnet voor de beste agentprestaties. Deze modellen begrijpen het meest betrouwbaar wanneer en hoe ze tools moeten gebruiken.
Agent testen
Typ in het voorbeeldvenster: "Wat is de huidige Bitcoin-koers in euro?" — Bekijk hoe de agent Google Search aanroept, de resultaten leest en een actueel antwoord geeft. Dan: "Als ik 0,5 BTC koop tegen deze koers, wat kost me dat?"
Publiceren
Klik op de blauwe "Publiceren"-knop. Je agent is nu live en toegankelijk via de deellink of de REST API.
Ingebouwde tools voor Dify agenten
Dify bevat een bibliotheek kant-en-klare tools. De meeste vereisen een gratis of betaalde API-sleutel van de betreffende aanbieder. Dit zijn de meest nuttige:
Google Search
Doorzoekt Google en geeft de topresultaten terug met titels, snippets en URL's. De krachtigste zoektool — ideaal voor actueel nieuws, prijzen, bedrijfsdata en tijdgevoelige informatie.
DuckDuckGo
Privacygerichte webzoekopdracht zonder API-sleutel. Goed voor algemene zoekopdrachten. Iets minder betrouwbaar dan Google Search voor zeer actuele informatie.
Bing Search
Microsoft's zoekmachine via Azure Cognitive Services. Goed alternatief voor SerpAPI met royaal gratis contingent (1.000 transacties/maand).
Wikipedia
Doorzoekt Wikipedia en geeft de volledige artikeltekst terug. Ideaal voor feitelijke, encyclopedische kennis. Veel betrouwbaarder dan websearch voor stabiele feiten.
Calculator
Berekent wiskundige uitdrukkingen. Voorkomt dat het model probeert rekenkunde in zijn hoofd uit te voeren (LLM's zijn berucht slecht in wiskunde). Ideaal voor prijsberekeningen, percentages en statistieken.
Code Interpreter
Voert Python-code uit in een veilige sandbox. De agent kan code schrijven en uitvoeren om data te analyseren, tekst te verwerken, complexe berekeningen uit te voeren of bestanden te bewerken.
Weer
Geeft actuele weersomstandigheden en voorspellingen terug voor elke locatie. Nuttig voor reisagenten, evenementenplanning of locatiegebaseerde toepassingen.
WolframAlpha
Computationele intelligentie — beantwoordt wiskundeproblemen, wetenschappelijke vragen, historische data, eenheidsomrekeningen met de hoogste nauwkeurigheid. Uitstekende aanvulling op websearch.
Aangepaste tools: Elke API verbinden
De echte kracht van Dify agenten ligt erin dat je elke REST API als aangepaste tool kunt integreren. Zo kan je agent interageren met interne bedrijfssystemen, SaaS-tools, databases of andere diensten met een API.
Methode 1: OpenAPI-schema
Heeft je API een OpenAPI (Swagger) specificatie, plak dan het JSON of YAML direct in Dify. Het parseert automatisch alle endpoints, parameters en beschrijvingen.
- Tools → Aangepaste tools → Tool aanmaken
- Kies "Importeren vanuit OpenAPI-schema"
- Plak OpenAPI JSON/YAML
- Verificatie toevoegen (API-sleutel, Bearer-token enz.)
- Opslaan — alle endpoints zijn beschikbaar als tools
Methode 2: Handmatige definitie
Voor eenvoudige API's zonder formele specificatie definieer je elk endpoint handmatig:
- Naam: "haal_klantgegevens" (hoe de agent het noemt)
- Beschrijving: "Zoekt een klant op e-mailadres" (de agent leest dit om te beslissen wanneer hij de tool gebruikt)
- Methode: GET, POST, PUT, DELETE
- URL: Je endpoint-URL met parameters
- Parameters: naam, type, beschrijving, verplicht/optioneel
Agentstrategieën: ReAct vs. Function Calling
Dify ondersteunt twee strategieën voor het redeneren en toolgebruik van agenten. De juiste keuze hangt af van het gebruikte LLM:
Function Calling
Het model begrijpt native hoe het tools als gestructureerde functie-aanroepen moet gebruiken. Betrouwbaarder, efficiënter en produceert schonere redeneerschema's.
Beste modellen:
- GPT-4o, GPT-4 Turbo
- Claude 3.5 Sonnet, Claude 3 Opus
- Gemini 1.5 Pro, Gemini 1.5 Flash
- Mistral Large
ReAct (Reasoning + Acting)
Het model schrijft zijn redenering als tekst ("Gedachte: Ik moet X zoeken...") gevolgd door actie-instructies ("Actie: google_search[X]"). Werkt met elk model dat instructies kan opvolgen.
Wanneer gebruiken:
- Open-source modellen (Llama, Qwen, Mistral 7B)
- Modellen zonder native Function Calling
- Wanneer je de volledige redenering wilt zien
Vuistregel
Gebruik je GPT-4o, Claude 3.5+ of Gemini Pro? → Kies Function Calling. Gebruik je een open-source model? → Kies ReAct. Bij twijfel, probeer eerst Function Calling.
Multi-agent orkestratie
Voor complexe taken kun je meerdere gespecialiseerde agenten aan elkaar koppelen. Elke agent richt zich op zijn sterke punten, en een coördinatoragent stuurt het werk tussen hen door.
Voorbeeld: Concurrentieanalysesysteem
Specialisatie
Elke agent heeft een gefocuste systeemprompt en alleen de tools die hij nodig heeft. Een onderzoeksagent krijgt zoektools; een schrijfagent krijgt opmaaktools.
Parallelle uitvoering
Dify Workflow-knooppunten kunnen meerdere agenten parallel aanroepen. Verzamel alle resultaten en voeg ze samen in een laatste stap voor snellere totale uitvoering.
Iteratiebeheersing
Stel maximale iteratielimieten per agent in om oneindige lussen te voorkomen. Een coördinator kan mislukte subtaken automatisch opnieuw proberen.
Tool-isolatie
Houd gevoelige tools (CRM-toegang, databaseschrijfbewerkingen) in aparte agenten met strikte toegangscontroles. De publiek toegankelijke coördinator raakt nooit direct gevoelige systemen aan.
Veelgestelde vragen
Wat kunnen Dify AI-agenten doen?
Dify AI-agenten kunnen op het web zoeken (Google, Bing, DuckDuckGo), Python-code uitvoeren, externe API's aanroepen, Wikipedia lezen, berekeningen uitvoeren, het weer controleren en veel meer. Ze beslissen zelfstandig welke tools ze voor elke taak gebruiken.
Wat is het verschil tussen een Dify agent en een chatbot?
Een Dify chatbot beantwoordt vragen op basis van zijn training en je prompts. Een Dify agent gebruikt actief tools — hij kan het internet doorzoeken, code uitvoeren of API's aanroepen. Gebruik chatbots voor support, agenten voor onderzoek en automatisering.
Kan ik eigen tools toevoegen aan een Dify agent?
Ja. Je kunt elke REST API als aangepaste tool toevoegen door een OpenAPI-specificatie op te geven of handmatig het endpoint, naam, beschrijving en parameters in te stellen. De agent gebruikt je tool wanneer de taak dat vereist.
Ondersteunt Dify agent meerstaps redeneren?
Ja. Dify agenten gebruiken ReAct (Reasoning + Acting) of Function Calling. De agent denkt stap voor stap, roept tools aan, observeert resultaten en gaat door totdat de taak voltooid is — vergelijkbaar met AutoGPT of LangChain.
Klaar om je Dify agent te deployen?
Agenten draaien op Dify Cloud kost snel veel credits. Zelf hosten geeft je onbeperkte agent-runs voor vaste maandelijkse kosten — vanaf €3,79/maand. Kies beheerde hosting als je geen onderhoud wilt.
Hetzner VPS
Vanaf €3,79/maand. Volledige controle, onbeperkte agent-runs, geen berichtkosten. Beste keuze voor AI-agenten met intensief toolgebruik.
Hetzner VPS halen →Elestio
Beheerde Dify hosting — volledig ingericht in 5 minuten. Automatische updates, back-ups en SSL inbegrepen. Ideaal als je je wilt richten op het bouwen van agenten.
Elestio proberen →