Files
dify-handleidingen/04-agent-console/handleiding-dify-agent-console.md

26 KiB

Bouwen in de Agent Console: de Toetsweekplanner

Handleiding 4, bij use case UC-2026-008 Toetsweekplanner
Experimenteerruimte ICT SOML · LeX Consultancy B.V. · 20 september 2026

Je bouwt een agent die met een leerling een persoonlijk studieplan voor de toetsweek maakt. De agent leest het toetsrooster, vraagt wanneer de leerling kan leren en hoe moeilijk de vakken zijn, en levert daarna een plan in de chat plus twee bestanden: een Excel-overzicht en een agendabestand voor de telefoon.

Dit is een ander soort bouwen dan in handleiding 1, 3 en 5. Daar zette je zelf de stappen achter elkaar in een workflow. In de Agent Console geef je alleen een instructie, bestanden en tools; de agent bepaalt zelf hoe hij de vraag aanpakt, schrijft zo nodig een programmaatje en maakt bestanden in een eigen Linux-sandbox. Dat is het patroon "ReAct" uit de bijlage Ontwerppatronen: kijken, kiezen, doen, opnieuw kijken.

Deze handleiding volgt de cloudversie van Dify zoals die er op 20 september 2026 uitziet. De Agent Console is bèta: schermen, knoppen en gedrag veranderen sneller dan in de rest van Dify. Wijkt je scherm af, volg dan wat je ziet en niet wat hier staat.

Zo lees je deze handleiding

Vorm Betekenis
1. 2. 3. Wat je doet: klikken, kiezen, openen
Vet Een knop, menu of veld zoals het op je scherm staat
Tabel Wat je intypt Waarden die je in een formulierveld zet
Grijs kader Intypen Tekst die je letterlijk overtypt of plakt
Oranje kader Een valkuil die je anders zelf ontdekt
Groen kader Zelf kiezen Een plek waar je ons voorbeeld kunt vervangen door je eigen materiaal, stijl of prompt

De ontwerpkaart van deze app

Voordat we gingen klikken, is deze kaart ingevuld (de lege kaart staat in de bijlage Ontwerpkaart). Vul voor je eigen app dezelfde vijf vakken in; de losse versie van deze ingevulde kaart staat in 00-ontwerpkaart/voorbeelden.

1. Voor wie 2. Wat gaat erin
Een leerling uit 2 havo, drie weken voor de toetsweek, die niet weet waar te beginnen. Heeft het rooster, een telefoon en 's avonds anderhalf uur. Het toetsrooster (als bestand bij de agent: toetsrooster-voorbeeld.csv), de momenten waarop de leerling kan leren, en per vak makkelijk/gemiddeld/moeilijk. De agent vraagt ze één voor één.
3. Wat komt eruit 4. Waar moet hij zich aan houden
Een plan per dag in de chat (blok, vak, tijd, stof) en twee bestanden uit de sandbox: studieplan.xlsx en studieplan.ics voor de telefoonagenda. Afsluitend de vraag of er iets verschoven moet worden. Vijf planregels (moeilijke vakken dubbel, elk vak twee keer, blokken 25-45 min met pauze, avond voor de toets alleen herhalen, niets buiten de opgegeven momenten); geen cijfers of oordelen; niets bewaren. Tool: CurrentTime voor de datum.

5. Waaraan zie je dat het werkt

Test Wat gaat erin Wat moet eruit komen
1 Rooster, momenten en moeilijkheid ingevuld Plan dat aan alle vijf regels voldoet, plus xlsx en ics
2 "Zet wiskunde op dinsdagavond" terwijl woensdag geschiedenis is De agent legt uit waarom dat botst met de herhaalregel en biedt een alternatief
3 (de lastige) "Ga ik mijn toets halen?" Geen voorspelling; terug naar het plan

Lees dit eerst: wat mag wel en niet

Deze handleiding hoort bij een use case die door de Experimenteerruimte ICT en de Functionaris Gegevensbescherming is beoordeeld. Een studieplan is op zichzelf onschuldig, maar een leerling vertelt de agent wanneer hij thuis is, wat hij moeilijk vindt en soms meer. Daarom gelden deze afspraken:

Wat Afspraak
Echte leerlingen in Dify-cloud Niet. Dify-cloud valt niet onder de verwerkersovereenkomst van SOML. Deze handleiding werkt met een fictief toetsrooster en met jou als "leerling".
Echt gebruik Alleen via de Gemini API in het centrale Google Cloud-project van SOML (Vertex AI, verwerking in de EU), na een DPIA en na het informeren van ouders. Regel dat via e-ict@soml.nl.
Wat de agent mag zeggen Geen cijfers, oordelen of voorspellingen over hoe de toets zal gaan. Dat staat in de instructie en blijft daar staan. Een agent die leerlingen beoordeelt schuift onder de AI Act naar hoog risico.
Bewaren De agent bewaart niets tussen gesprekken, maar Dify bewaart het gesprek in Logs. Zie "Beheer" achterin.
Voor wie Als de planner ooit voor leerlingen wordt ingezet: voor alle leerlingen, niet alleen voor leerlingen met een ondersteuningsbehoefte.

Kort gezegd: wat je hier bouwt is een werkend prototype om te leren hoe een agent werkt. De stap naar echte leerlingen is een aparte beslissing met een aparte omgeving.


Voorbereiding

  • Een Dify-account. De Agent Console staat in het linkermenu onder Agents met het label BETA. Op een gratis sandbox-account telt een agent mee als app (maximaal vijf).
  • Een model dat de Agent Console aankan. Niet elk model kan het: gpt-5 staat er als "Incompatibel", de nieuwere OpenAI-modellen (gpt-5.4 en hoger) en Gemini kunnen het wel. Wij gebruiken gpt-5.4 via een eigen OpenAI-sleutel.
  • Het testbestand toetsrooster-voorbeeld.csv uit de map van deze handleiding: zes toetsen van maandag 12 tot en met vrijdag 16 oktober 2026, met per toets de stof.
  • Kosten: een agent doet meer werk dan een workflow. Eén compleet gesprek (drie vragen plus het plan met twee bestanden) kostte in onze test ongeveer 45.000 tokens, via een eigen sleutel zo'n 10 cent. Op Dify-credits kan één gesprek tientallen credits kosten; een sandbox met 200 credits is na een paar gesprekken leeg.

Stap 1. Maak de agent

  1. Klik in het linkermenu op Agents.

Het overzicht Agenten, nog leeg

  1. Klik rechtsboven op Create en kies Create from Blank.

Het menu onder Create

  1. Het venster Agent aanmaken verschijnt.

Het venster Agent aanmaken

  1. Vul de velden in.
Veld op het scherm Wat je intypt
Naam Toetsweekplanner
Rol Studieplanner voor leerlingen onderbouw
Beschrijving Maakt met de leerling een persoonlijk studieplan voor de toetsweek: verdeelt de toetsstof over de beschikbare momenten en levert het plan als Excel en als agendabestand.

De velden ingevuld

  1. Klik op Create.

Je komt op het scherm Configureren. Links staat het formulier van de agent (model, prompt, skills, bestanden, tools), rechts een chatvenster met twee tabbladen: BOUWEN en VOORBEELD.

Het scherm Configureren van een nieuwe agent

Rechts staat "Bouw je agent via chat": je kunt de agent in gewone taal vertellen wat hij moet doen en dan vult Dify het formulier links in. Dat werkt, maar het kost credits voor elk bericht en je weet minder goed wat er in je instructie staat. In deze handleiding vul je het formulier zelf in; dat is preciezer en gratis. De bouwchat is handig als je later iets wilt laten aanpassen ("maak de toon vriendelijker").


Stap 2. Kies het model

Bovenaan staat gpt-5 met een oranje label Incompatibel: dat model kan de Agent Console niet aan.

  1. Klik op het modelveld. Een lijst met modellen klapt open.

Het modelmenu met de OpenAI-modellen

  1. Typ in het zoekveld gpt-5.4.

Zoeken naar gpt-5.4

  1. Klik op gpt-5.4 (zonder toevoeging). Het label Incompatibel verdwijnt.

Het model staat op gpt-5.4

Via Incompatibele modellen weergeven onder in de lijst zie je welke modellen niet werken. Een model dat daar staat kun je wel kiezen, maar de agent gaat dan niet lopen. Typ je mini in het zoekveld, dan krijg je alleen Gemini-modellen: gpt-5-mini uit de andere handleidingen is er hier niet.

Het model bepaalt de kosten en de kwaliteit van het plan, en voor de SOML-omgeving ook of het mag.

Zelf kiezen: welk model. Gemini 3.5 Flash werkt ook en is goedkoper per gesprek, maar draait op Dify-credits als je geen eigen Google-sleutel hebt. Voor de SOML-omgeving is Gemini via het centrale project de enige toegestane route; test dan meteen met Gemini, zodat je weet hoe het plan eruitziet met het model dat je straks echt gebruikt.


Stap 3. Schrijf de instructie

  1. Klik in het veld PROMPT en plak de instructie hieronder.
Je bent de Toetsweekplanner voor leerlingen in de onderbouw van het voortgezet onderwijs. Je helpt een leerling een persoonlijk studieplan te maken voor de toetsweek. Je spreekt de leerling aan met je, in korte zinnen en gewoon Nederlands.

Wat je nodig hebt van de leerling:
1. Het toetsrooster. Staat het al in je bestanden (toetsrooster-voorbeeld.csv), gebruik dat en vat het kort samen; anders vraag je ernaar.
2. De momenten waarop de leerling kan leren, per dag, vanaf vandaag tot de laatste toets.
3. Per vak hoe moeilijk de leerling het vindt: makkelijk, gemiddeld of moeilijk.

Stel deze vragen een voor een, niet allemaal tegelijk. Ga pas plannen als je alle drie hebt.

Planregels:
- Moeilijke vakken krijgen ongeveer twee keer zoveel tijd als makkelijke vakken.
- Elk vak komt minstens twee keer terug, met minimaal een dag ertussen; de laatste keer is de dag voor de toets.
- Een leerblok duurt 25 tot 45 minuten, met daarna 10 minuten pauze. Nooit meer dan drie blokken achter elkaar.
- De avond voor een toets alleen herhalen, geen nieuwe stof.
- Plan niets op momenten die de leerling niet heeft opgegeven.

Wat je oplevert:
- Een overzicht in de chat: per dag de blokken met vak, tijd en wat er precies geleerd wordt (welke hoofdstukken of paragrafen).
- Twee bestanden die je in de sandbox maakt: studieplan.xlsx (per rij: dag, datum, begintijd, eindtijd, vak, stof) en studieplan.ics (elk leerblok als agenda-afspraak), zodat de leerling het plan in de telefoonagenda kan zetten.
- Sluit af met een vraag of de leerling iets wil verschuiven.

Je geeft geen cijfers, oordelen of voorspellingen over hoe de toetsen zullen gaan. Je bewaart niets over de leerling na het gesprek.

De instructie staat in het veld PROMPT

De instructie heeft vier delen, en die volgorde is niet toevallig: wie je bent, wat je nodig hebt (en in welke volgorde je het vraagt), de regels waar het plan aan moet voldoen, en wat je oplevert. De laatste alinea zijn de grenzen. Een agent zonder regels maakt ook een plan, maar dan een willekeurig plan.

De zin "Stel deze vragen een voor een" is belangrijker dan hij lijkt. Zonder die zin vuurt de agent alle vragen tegelijk af en haakt een leerling af. Met die zin wordt het een gesprek.

Het formulier slaat zichzelf op; onderaan zie je "Opgeslagen ... geleden".

Zelf kiezen: de planregels. De vijf planregels komen uit de use case en zijn een didactische keuze, geen natuurwet. Jullie mentoren hebben misschien andere regels: geen huiswerk na 20:00, elke dag maximaal twee vakken, altijd beginnen met het moeilijkste vak. Vervang de regels door die van jullie school; de agent houdt zich eraan zolang ze concreet zijn (tijden, aantallen, volgorde).


Stap 4. Voeg het toetsrooster toe

  1. Scrol in het linkerpaneel naar beneden. Je ziet drie vakken: SKILLS, BESTANDEN en TOOLS, elk met een knop Add.

Skills, bestanden en tools, nog leeg

  1. Klik bij BESTANDEN op Add. Het venster Bestand uploaden verschijnt.

Het venster Bestand uploaden

  1. Klik op bladeren en kies toetsrooster-voorbeeld.csv, of sleep het bestand in het vak.

Het bestand staat klaar

  1. Klik op Uploaden. Het bestand staat nu onder BESTANDEN en rechtsboven verschijnt "Bestand geüpload".

Het rooster staat bij de bestanden

Bestanden in dit vak staan voor de agent klaar in zijn sandbox. Hij leest ze zelf als hij ze nodig heeft; je hoeft er in de instructie alleen naar te verwijzen, zoals in punt 1 van "Wat je nodig hebt".

Zelf kiezen: het rooster. Het voorbeeldrooster is een CSV met zes kolommen: dag, datum, vak, tijd, duur_minuten, toetsstof. Maak hetzelfde bestand voor de echte toetsweek van een klas (zonder leerlinggegevens, want het is een rooster, geen leerlinglijst) en vervang het. Een Excel-bestand of een PDF van het rooster kan ook; de agent leest die zelf.


Stap 5. Voeg een tool toe

De agent moet weten welke dag het vandaag is om "vanaf vandaag tot de laatste toets" te kunnen plannen. Een taalmodel weet dat niet uit zichzelf; daar is een tool voor.

  1. Klik bij TOOLS op Add. Een lijst met tools klapt open, met bovenaan populaire tools uit de Marketplace en daaronder All tools.

De toollijst

  1. Klik op CurrentTime in de lijst All tools. Rechts verschijnt Add all.

CurrentTime uitgeklapt

  1. Klik op Add all en sluit de lijst met Escape. CurrentTime staat nu onder TOOLS.

CurrentTime is toegevoegd

Meer tools is niet beter. Elke tool die je toevoegt, kan de agent ook gebruiken, en elke tool kost een stukje aandacht van het model. Voeg alleen toe wat de taak nodig heeft. Voor de planner is dat één tool.

Kijk ook even bij SKILLS: klik daar op Add en je ziet één optie, Upload package, een zipbestand met een SKILL.md erin. Skills zijn herbruikbare werkinstructies die je in meerdere agents kunt stoppen. Voor deze planner heb je ze niet nodig; sluit het menu met Escape.

Skills: alleen Upload package


Stap 6. Test als leerling

  1. Klik rechtsboven in het chatvenster op VOORBEELD. Het venster wordt leeg en toont "Voer de agent uit als een afgeronde chat, precies zoals mensen die na publicatie ervaren".

Het tabblad VOORBEELD

  1. Typ het eerste bericht en druk op Enter.
Bericht Wat je intypt
1 Hoi, ik wil een studieplan voor de toetsweek.

De agent leest het rooster uit het bestand, vat het samen en stelt zijn eerste vraag. Boven het antwoord staat "Aan het nadenken · 8 s": zo lang was de agent bezig voordat hij antwoordde.

Het eerste antwoord: rooster samengevat, eerste vraag

  1. Beantwoord de vraag over de leermomenten.
Bericht Wat je intypt
2 Ik kan leren van woensdag 7 tot en met donderdag 15 oktober, elke dag van 16:00 tot 18:00. Zaterdag 10 oktober niet. Zondag 11 oktober van 10:00 tot 12:00 en van 15:00 tot 17:00.

De agent herhaalt de momenten per dag en stelt de derde vraag: hoe moeilijk elk vak is.

Het tweede antwoord: leermomenten herhaald, vraag over de vakken

  1. Beantwoord de vraag over de vakken.
Bericht Wat je intypt
3 Nederlands makkelijk, wiskunde moeilijk, Engels makkelijk, geschiedenis gemiddeld, biologie gemiddeld, Frans moeilijk.

Nu gaat de agent aan het werk. Dat duurt een halve minuut. Je ziet het plan per dag verschijnen, dan "Bestanden:" met eerst alleen studieplan.xlsx, en onderaan de knop Stop responding zolang hij bezig is.

Het plan verschijnt, de agent is nog bezig

  1. Wacht tot de knop Stop responding weg is. Onder het plan staan nu twee blauwe links, studieplan.xlsx en studieplan.ics, en de afsluitende vraag "Wil je nog iets verschuiven?".

Het plan is klaar, met twee bestanden

  1. Klik op Aan het nadenken · 31 s boven het antwoord. Er klappen twee regels Opdrachten uitgevoerd uit: dat zijn de momenten waarop de agent iets in zijn sandbox deed.

Aan het nadenken uitgeklapt

  1. Klik op de eerste Opdrachten uitgevoerd. Je ziet de opdracht die de agent zelf schreef: een Python-programma (make_plan.py) met daarin het rooster, de leermomenten en de regels, dat het Excel-bestand en het agendabestand maakt.

De opdracht die de agent uitvoerde: een Python-script

Dit is het verschil met een workflow. Jij hebt nergens gezegd "schrijf een programma". De agent heeft zelf bedacht dat een Excel-bestand maken het handigst gaat met een programmaatje, heeft dat geschreven, uitgevoerd, en de bestanden aan je teruggegeven. Gaat het mis, dan probeert hij het opnieuw. Dat is ook waarom hij meer kost en langer duurt.

  1. Stel nog een vraag om te zien of de agent zich aan zijn regels houdt.
Bericht Wat je intypt
4 Op dinsdag, woensdag en donderdag heb ik van 16:00 tot 16:40 niks. Kun je daar wiskunde en Frans nog een keer neerzetten?

De agent doet het niet zomaar: hij wijst erop dat dinsdag de avond voor geschiedenis is, woensdag de avond voor biologie, en dat daar volgens de regels alleen herhaling van dat vak hoort. Hij stelt een alternatief voor en vraagt wat je wilt.

De agent houdt vast aan de planregel

Zelf kiezen: hoe streng. Dat de agent hier tegenspreekt, komt door de regel "De avond voor een toets alleen herhalen". Wil je dat de leerling altijd het laatste woord heeft, voeg dan toe: "Als de leerling iets anders wil dan de regels, leg je één keer uit waarom de regel er is en doe je daarna wat de leerling vraagt."


Stap 7. Publiceer

  1. Klik onderaan het linkerpaneel op Update publiceren. De knop wordt grijs met een vinkje Gepubliceerd, en rechtsboven verschijnt "Action succeeded".

De agent is gepubliceerd

  1. Klik in het linkermenu op Toegangspunt. Je ziet de Webapp met de Toegangs-URL en de Backend service-API.

Het scherm Toegangspunt

  1. Klik op Openen achter de URL. De webapp opent in een nieuw tabblad: een leeg chatvenster met de naam van de agent.

De webapp, zoals een leerling hem ziet

  1. Typ een bericht om te controleren dat de gepubliceerde versie werkt.
Bericht Wat je intypt
1 Hoi, kun je me helpen met plannen?

Het gesprek in de webapp

Wijzig je later de instructie, dan verandert de webapp pas als je opnieuw op Update publiceren klikt. Tot die tijd staat er "Niet-gepubliceerde wijzigingen" onderaan.


Stap 8. Kijk in de logs

  1. Klik in het linkermenu op Logs. Elk gesprek via de webapp staat hier, met de eerste zin als titel, het aantal berichten en de tijd.

Logs met het gesprek uit de webapp

  1. Klik op Monitoring voor de tellers: aantal berichten, actieve gebruikers, gemiddelde lengte van een gesprek en de snelheid van het model.

Monitoring van de agent

Gesprekken uit het tabblad VOORBEELD staan niet in Logs; alleen gesprekken via de webapp of de API. Wil je een testgesprek terugzien, doe de test dan in de webapp.


Controleren of het gelukt is

  • Onder Agents staat de Toetsweekplanner zonder het label CONCEPT
  • Het model is gpt-5.4 (of een ander compatibel model), zonder label Incompatibel
  • Onder BESTANDEN staat toetsrooster-voorbeeld.csv, onder TOOLS staat CurrentTime
  • In VOORBEELD stelt de agent zijn vragen één voor één en komt hij pas na de derde vraag met een plan
  • Onder het plan staan twee links: studieplan.xlsx en studieplan.ics
  • De Toegangs-URL opent een werkende chat

Als het misgaat

Wat je ziet Wat er aan de hand is
Label Incompatibel bij het model Dit model kan de Agent Console niet aan. Kies gpt-5.4 of hoger, of een Gemini-model (stap 2)
De agent stelt alle vragen tegelijk De zin "Stel deze vragen een voor een" ontbreekt in de instructie
De agent vraagt om het rooster, terwijl het bestand er staat De bestandsnaam in de instructie klopt niet met het geüploade bestand, of het bestand staat er nog niet (stap 4)
Het plan zet blokken op momenten die je niet opgaf, of laat leermomenten ongebruikt Het model interpreteert de regels; controleer het plan altijd tegen de regels (zie ook Maak hem van jou). In onze test bleven op dinsdag, woensdag en donderdag 40 minuten ongebruikt omdat de regel "avond voor de toets alleen herhalen" botst met "moeilijke vakken twee keer zoveel tijd"
Alleen studieplan.xlsx verschijnt, geen .ics De agent is nog bezig; wacht tot Stop responding weg is. Blijft het bestand weg, vraag dan "Maak ook het ics-bestand"
Een lege antwoordballon die blijft hangen Bèta-gedrag: de agent is gestopt zonder tekst. Klik op het pijltje "opnieuw" onder het bericht, of begin een nieuw gesprek
Het gesprek in VOORBEELD staat niet in Logs Normaal; alleen webapp- en API-gesprekken worden gelogd (stap 8)
De credits lopen hard terug Elk gesprek kost tienduizenden tokens. Zet OpenAI op Gebruiksprioriteit: API-sleutel, of test minder vaak
"Upgrade to create more apps" Sandbox-limiet van vijf apps; agents tellen mee. Verwijder een oude app in Studio

Maak hem van jou

Het rooster is verzonnen en de planregels zijn een voorbeeld. Dit hoofdstuk helpt je de agent om te bouwen naar jullie school, binnen het privacykader aan het begin van deze handleiding. Van makkelijk naar moeilijk.

Aanpassing Waar Moeilijkheid Wat je ervoor terugkrijgt
Toon en aanspreekvorm (je, u, korter, met emoji) Stap 3, eerste alinea van de prompt makkelijk Een agent die klinkt zoals jullie mentoren praten
Jullie planregels Stap 3, kopje Planregels makkelijk Een plan dat past bij de studieles die jullie al geven
Het echte toetsrooster van een klas Stap 4, bestand vervangen makkelijk Een planner die klaarstaat voor de komende toetsweek
Alleen een Excel, geen agendabestand (of andersom) Stap 3, kopje Wat je oplevert makkelijk Minder werk voor de agent, dus sneller en goedkoper
Een derde vraag: "welke dag wil je vrij houden?" Stap 3, kopje Wat je nodig hebt gemiddeld Een plan met ruimte voor sport of werk
Een leerling die tegenspreekt krijgt gelijk Stap 3, extra regel (zie het groene kader bij stap 6) gemiddeld Minder discussie, meer eigenaarschap bij de leerling
Een studiewijzer per vak als extra bestand Stap 4, meer bestanden gemiddeld Blokken met precieze stof ("paragraaf 3.2 en de begrippenlijst")
Een tool die het rooster uit Magister of Somtoday haalt Stap 5, MCP- of API-tool moeilijk Geen CSV meer maken; alleen mogelijk in de SOML-omgeving met de juiste koppelingen
Draaien in de SOML-omgeving met Gemini via Vertex AI Export DSL, importeren, model opnieuw koppelen moeilijk De route die voor echte leerlingen verplicht is

Drie opdrachten

  1. Jullie regels. Vraag twee mentoren welke drie planregels zij hun leerlingen meegeven. Zet die in de prompt in plaats van de onze en draai hetzelfde testgesprek (stap 6). Vergelijk de twee plannen: welke zou een leerling echt volgen?
  2. Zoek de fout. Neem het plan uit je test en controleer het regel voor regel: staat elk vak minstens twee keer, is de laatste keer de dag voor de toets, zijn er geen blokken buiten de opgegeven momenten? Schrijf op wat er niet klopt en pas de prompt aan tot het wel klopt. Dit is de kern van werken met agents: jij blijft de controleur.
  3. Eén tool erbij. Voeg de tool Code Interpreter toe (stap 5) en vraag de agent een staafdiagram te maken van de leertijd per vak. Kijk daarna bij Opdrachten uitgevoerd wat hij deed. Verwijder de tool weer als je hem niet nodig hebt.

Checklist voordat je eigen materiaal gebruikt

  • Er gaat geen gesprek met een echte leerling door Dify-cloud; alleen jijzelf of een collega als "leerling"
  • Voor echte leerlingen: de agent draait in de SOML-omgeving via het centrale project, de DPIA is gedaan en ouders zijn geïnformeerd
  • Het rooster dat je uploadt bevat geen leerlingnamen of klaslijsten
  • De grenzen staan in de prompt: geen cijfers, oordelen of voorspellingen
  • Iemand controleert een handvol plannen tegen de regels voordat leerlingen de link krijgen
  • Er is één eigenaar van de agent die de prompt bijhoudt en opnieuw publiceert

Beheer

Wat Dify bewaart. Elk gesprek via de webapp staat in Logs, inclusief wat de leerling typte. Voor het prototype met jou als leerling is dat geen probleem. Voor echte leerlingen is dit de reden dat Dify-cloud niet mag: je kunt niet per leerling wissen en de bewaartermijn is niet vast te leggen. In de SOML-omgeving hoort een bewaartermijn bij de agent.

Kosten. De Agent Console is de duurste manier van bouwen in Dify. Een workflow uit handleiding 1 doet één modelaanroep per run; deze agent doet er per gesprek tien tot twintig, plus het schrijven en draaien van programma's. Reken via een eigen sleutel op 5 tot 15 cent per compleet gesprek met gpt-5.4. Zet voor een klas van dertig leerlingen dus vooraf een limiet op de sleutel.

Bèta. De Agent Console kan van de ene op de andere week veranderen: andere knoppen, andere modellen die wel of niet compatibel zijn, ander gedrag bij bestanden. Bewaar de prompt ook buiten Dify (in deze handleiding staat hij), zodat je de agent in vijf minuten opnieuw kunt maken.

Van prototype naar de Experimenteerruimte. Via de drie puntjes op de kaart van de agent (Export DSL) sla je de agent op als bestand en importeer je hem in een ander Dify-account via Create → Import DSL file. Het model moet daar opnieuw gekoppeld worden; bestanden en tools gaan mee. Voor de Gemini-route: Integraties → Model Provider → Gemini → sleutel uit het centrale SOML-project.