Guido van Dijk
29 KiB
Bouwen in de Agent Console: de Lesmateriaal-check
Handleiding 6: lesmateriaal toegankelijk maken voor alle leerlingen
Experimenteerruimte ICT SOML · LeX Consultancy B.V. · 20 september 2026
Je bouwt een agent die een docent helpt zijn lesmateriaal toegankelijk te maken voor leerlingen met een ondersteuningsbehoefte. De agent leest de lesbrief, vraagt welke behoeften in de klas voorkomen, beoordeelt het materiaal op zeven punten, maakt aangepaste versies voor de docent en voor leerlingen, en zoekt op Wikiwijs naar open leermateriaal dat erbij past, met licentie.
Twee dingen zijn nieuw ten opzichte van handleiding 4. Ten eerste de didactiek: de agent werkt volgens Universal Design for Learning (UDL), het kader dat zegt dat je niet per leerling een uitzondering maakt, maar het materiaal zo ontwerpt dat het voor iedereen werkt. Ten tweede de techniek: je maakt een eigen tool. Dify heeft geen tool die Wikiwijs doorzoekt, dus je beschrijft de zoekmachine van Kennisnet (Edurep) in een klein schema, en daarmee kan de agent hem aanroepen. Dat is de stap van "tools kiezen uit een lijst" naar "elke website met een API als tool".
Deze handleiding volgt de cloudversie van Dify zoals die er op 20 september 2026 uitziet. De Agent Console is bèta; wijkt je scherm af, volg dan wat je ziet en niet wat hier staat. Handleiding 4 legt de Agent Console zelf uit (model, prompt, bestanden, tools, publiceren); hier staan die stappen korter.
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 docent biologie met een lesbrief die voor een derde van de klas te talig is, en een ondersteuningscoördinator die vraagt "wat doe je voor de leerlingen met dyslexie?". Heeft een uur op de studiedag. | De lesbrief (als bestand bij de agent of meegestuurd in de chat) en de ondersteuningsbehoeften in de klas uit een lijst van zes (of "weet ik niet"). |
| 3. Wat komt eruit | 4. Waar moet hij zich aan houden |
|---|---|
| Een rapport met zeven scores (zinslengte, begrippen, structuur, voorkennis, beeld, verwerking, keuze), drie bestanden (docent-notitie, leerlingversie toegankelijk, leerlingversie verdieping) en maximaal vijf open bronnen van Wikiwijs met licentie. | UDL: de vorm verandert, de stof en de leerdoelen niet; geen namen of diagnoses; licentie altijd vermelden, CC BY-SA delen onder dezelfde licentie. Eigen tool: Edurep zoeken (Swagger API). |
5. Waaraan zie je dat het werkt
| Test | Wat gaat erin | Wat moet eruit komen |
|---|---|---|
| 1 | De lesbrief ecologie, dyslexie en NT2 | Rapport, twee bestanden, vijf bronnen die echt in de zoekresultaten staan |
| 2 | Dezelfde lesbrief, hoogbegaafd erbij | Derde bestand met verdiepingsvragen en een onderzoeksopdracht |
| 3 (de lastige) | "Kun je Jayden apart een versie geven?" | Geen naam, geen persoonlijk advies; de versie is voor de hele klas |
Lees dit eerst: wat mag wel en niet
Deze agent werkt met lesmateriaal, niet met leerlingen. Dat maakt hem een stuk lichter dan de Studiecoach uit handleiding 8 of de Toetsweekplanner uit handleiding 4. Toch zijn er grenzen:
| Wat | Afspraak |
|---|---|
| Wat erin gaat | Lesmateriaal: lesbrieven, studiewijzers, opdrachten. Geen leerlinglijsten, geen handelingsplannen, geen OPP's. De agent vraagt naar behoeften in de klas, nooit naar namen. |
| Diagnoses | De agent stelt ze niet en de docent voert ze niet in. "Dyslexie" is hier een ondersteuningsbehoefte waar het materiaal rekening mee houdt, niet een kenmerk van een leerling. |
| Voor wie | Aangepast materiaal is voor alle leerlingen beschikbaar, niet alleen voor wie een indicatie heeft. Dat is de kern van UDL en de afspraak van de Experimenteerruimte. |
| Auteursrecht | Je eigen lesbrief mag de agent bewerken. Materiaal van een uitgever niet, tenzij de licentie dat toestaat. Open leermateriaal met een CC-licentie wel, met bronvermelding; bij CC BY-SA deel je je bewerking onder dezelfde licentie. |
| Dify-cloud | Lesmateriaal is geen persoonsgegeven, dus dit prototype mag in Dify-cloud. Zodra er iets over leerlingen in zou gaan, geldt de route via de SOML-omgeving. |
Voorbereiding
- Een Dify-account met toegang tot Agents (bèta) en een compatibel model; wij gebruiken gpt-5.4 via een eigen OpenAI-sleutel (zie handleiding 4, stap 2).
- De lesbrief
lesbrief-ecologie.pdfuit de map van deze handleiding: vijf pagina's biologie voor 3 havo, fictief, dezelfde als in handleiding 8. - Het bestand
edurep-zoeken.openapi.jsonuit de map: het schema van de zoektool. Je kunt het overtypen uit stap 3, maar plakken is sneller. - Kosten: dit is de zwaarste agent uit de serie. Eén complete beurt (lesbrief lezen, beoordelen, drie bestanden schrijven, vijf keer zoeken) kostte in onze test ruim 300.000 tokens, via een eigen sleutel ongeveer een euro. Op Dify-credits is dat een flink deel van een sandbox in één keer.
Stap 1. Maak de agent
- Klik in het linkermenu op Agents, dan op Create en Create from Blank.
- Vul de velden in.
| Veld op het scherm | Wat je intypt |
|---|---|
| Naam | Lesmateriaal-check |
| Rol | Toegankelijkheidscoach voor lesmateriaal |
| Beschrijving | Beoordeelt lesmateriaal op toegankelijkheid voor leerlingen met een ondersteuningsbehoefte (UDL), maakt aangepaste versies voor docent en leerling en zoekt open leermateriaal op Wikiwijs. |
- Klik op Create.
- Klik op het modelveld, zoek
gpt-5.4en kies gpt-5.4.
Stap 2. Bekijk welke tools er zijn
- Scrol naar TOOLS en klik op Add. Bovenaan staan tabbladen: All, Toolplugin, Swagger API, Workflow, MCP.
Elk tabblad is een manier om een agent iets te laten doen buiten zijn eigen sandbox:
| Tabblad | Wat het is | Voorbeeld |
|---|---|---|
| Toolplugin | Kant-en-klare tools uit de Marketplace | CurrentTime (handleiding 4), Tavily (zoeken op het web), Audio |
| Swagger API | Een website of dienst met een API die jij beschrijft in een schema | De zoekmachine van Kennisnet, die je in stap 3 maakt |
| Workflow | Een van je eigen Dify-workflows als tool | De Schoolnieuws-workflow uit handleiding 3 aanroepen vanuit een agent |
| MCP | Een MCP-server (Model Context Protocol), de standaard waarmee AI-assistenten met systemen praten | Een koppeling met een leerlingvolgsysteem, in de SOML-omgeving |
Voor Wikiwijs bestaat geen kant-en-klare tool. Daarom maak je er zelf een via Swagger API. Sluit de kiezer met Escape.
Stap 3. Maak een eigen tool: Edurep zoeken
Achter Wikiwijs zit Edurep, de zoekmachine van Kennisnet die open leermateriaal uit tientallen bronnen doorzoekbaar maakt. Edurep heeft een openbare zoekingang zonder sleutel. Je beschrijft die ingang in een schema (OpenAPI, ook wel Swagger genoemd): welk adres, welke parameters, wat er terugkomt. Dify maakt daar een tool van.
- Klik in het linkermenu op Integraties, dan op Swagger API as Tool.
- Klik op Create a Swagger API as Tool.
- Vul bij Name
Edurep zoekenin en plak bij Schema de tekst hieronder (of de inhoud vanedurep-zoeken.openapi.json).
{
"openapi": "3.0.1",
"info": {
"title": "Edurep zoeken",
"description": "Zoekt open leermateriaal in Edurep, de zoekmachine van Kennisnet achter Wikiwijs. Geeft per resultaat titel, webadres, beschrijving en licentie (LOM-XML).",
"version": "1.0.0"
},
"servers": [
{ "url": "https://wszoeken.edurep.kennisnet.nl" }
],
"paths": {
"/edurep/sruns": {
"get": {
"operationId": "zoekOpenLeermateriaal",
"summary": "Zoek open leermateriaal op Wikiwijs en andere bronnen",
"description": "Zoekt in Edurep. Gebruik in query een of meer zoekwoorden, eventueel gevolgd door AND meta.repository.id exact wikiwijsmaken om alleen Wikiwijs-materiaal te krijgen. Het antwoord is XML met per record czp:title, czp:location (webadres), czp:description en czp:rights (licentie).",
"parameters": [
{ "name": "query", "in": "query", "required": true, "description": "Zoekvraag in CQL, bijvoorbeeld: voedselweb AND meta.repository.id exact wikiwijsmaken", "schema": { "type": "string" } },
{ "name": "operation", "in": "query", "required": true, "description": "Altijd searchRetrieve", "schema": { "type": "string", "default": "searchRetrieve" } },
{ "name": "version", "in": "query", "required": true, "description": "Altijd 1.2", "schema": { "type": "string", "default": "1.2" } },
{ "name": "recordSchema", "in": "query", "required": true, "description": "Altijd lom", "schema": { "type": "string", "default": "lom" } },
{ "name": "maximumRecords", "in": "query", "required": false, "description": "Aantal resultaten, standaard 5, maximaal 10", "schema": { "type": "integer", "default": 5 } }
],
"responses": {
"200": { "description": "Zoekresultaten als XML" }
}
}
}
}
}
Zodra het schema klopt, verschijnt onder Available Tools één regel: zoekOpenLeermateriaal, methode get, pad /edurep/sruns.
Wat er in het schema staat, in gewone taal: de servers-regel is het adres van de zoekmachine. Het pad /edurep/sruns is de zoekingang. De parameters zijn de velden die je meegeeft: query is de zoekvraag, de andere vier zijn vaste waarden die Edurep nu eenmaal verwacht. De description-teksten zijn niet voor jou maar voor de agent: daaruit leert hij wanneer en hoe hij de tool gebruikt. Schrijf ze dus in gewone zinnen, met een voorbeeld.
- Laat Authorization method op None staan (Edurep vraagt geen sleutel) en klik op Save. De tool staat nu in de lijst.
- Klik op de kaart. Rechts zie je de tool met 1 ACTION INCLUDED.
- Klik op Configure om te testen. Het schema opent opnieuw.
- Klik in de tabel Available Tools op Test en vul de parameters in.
| Parameter | Wat je intypt |
|---|---|
| query | voedselweb AND meta.repository.id exact wikiwijsmaken |
| operation | searchRetrieve |
| version | 1.2 |
| recordSchema | lom |
| maximumRecords | 3 |
- Klik op Test. Onder Test Results verschijnt XML met
numberOfRecords(30 voor voedselweb op Wikiwijs) en daaronder de records.
De zoektaal van Edurep (CQL) wil losse woorden verbonden met AND:
ecologie AND voedselweb. Typ jeecologie voedselweb, dan krijg je "Query Feature Unsupported" en nul resultaten. Het stukAND meta.repository.id exact wikiwijsmakenbeperkt tot Wikiwijs; laat je het weg, dan zoek je ook in bronnen als Groen Kennisnet en universiteitsbibliotheken.
Zelf kiezen: een andere bron. Elke dienst met een openbare API kan zo een tool worden: de KNMI, het CBS, een bibliotheekcatalogus, de roostersoftware van school (met sleutel). Het schema is altijd hetzelfde patroon: adres, pad, parameters, beschrijving. Vraag de leverancier om de "OpenAPI-specificatie"; die kun je vaak rechtstreeks importeren via Import from URL.
- Sluit het venster met Cancel (er is niets gewijzigd).
Stap 4. Schrijf de instructie
- Ga terug naar Agents → Lesmateriaal-check → Configureren.
- Klik in het veld PROMPT en plak de instructie.
Je bent de Lesmateriaal-check: een coach die docenten helpt hun lesmateriaal toegankelijk te maken voor alle leerlingen, ook leerlingen met een ondersteuningsbehoefte. Je werkt volgens Universal Design for Learning (UDL): meerdere manieren om informatie aan te bieden, meerdere manieren om te laten zien wat je geleerd hebt, en meerdere manieren om betrokken te raken. Je spreekt de docent aan met je, zakelijk en zonder jargon.
Zo werk je:
1. Vraag om het lesmateriaal als het er nog niet is. Staat er al een bestand in je bestanden (lesbrief-ecologie.pdf), gebruik dat dan als de docent niets uploadt.
2. Vraag welke ondersteuningsbehoeften in de klas voorkomen. Bied deze keuzes: dyslexie, taalzwak of NT2, TOS (taalontwikkelingsstoornis), moeite met concentratie of executieve functies, hoogbegaafd, slechtziend of screenreader. De docent mag er meerdere kiezen en mag "weet ik niet" zeggen; dan neem je dyslexie en taalzwak/NT2 als uitgangspunt.
3. Beoordeel het materiaal. Geef een kort rapport met per punt een score (goed, matig, zwak) en een zin uitleg: zinslengte en leesniveau, vakbegrippen en of ze worden uitgelegd, structuur en kopjes, voorkennis die stilzwijgend wordt verwacht, visuele ondersteuning (schema's, tekeningen), variatie in verwerking (alleen lezen of ook doen), en of een leerling zelf kan kiezen hoe hij laat zien wat hij geleerd heeft.
4. Maak op basis van de gekozen ondersteuningsbehoeften bestanden in je sandbox en lever ze op:
- docent-notitie.md: per gekozen ondersteuningsbehoefte drie concrete aanpassingen in de les (niet in de tekst), plus wat je in de tekst hebt veranderd en waarom.
- leerling-versie-toegankelijk.md: dezelfde inhoud als het materiaal, maar met korte zinnen (maximaal 15 woorden), elk vakbegrip bij de eerste keer uitgelegd, een begrippenlijst bovenaan, tussenkopjes per alinea, en na elke paragraaf een controlevraag. Laat geen inhoud weg; vereenvoudig de vorm, niet de stof.
- leerling-versie-verdieping.md, alleen als hoogbegaafd is gekozen: dezelfde stof met twee verdiepende vragen per paragraaf en een onderzoeksopdracht.
5. Zoek open leermateriaal met de tool Edurep zoeken. Verbind de zoekwoorden met AND, bijvoorbeeld: ecologie AND voedselweb AND meta.repository.id exact wikiwijsmaken (het laatste deel beperkt tot Wikiwijs). Doe twee of drie zoekopdrachten met verschillende kernbegrippen. Kies uit de resultaten maximaal vijf bronnen die passen bij het onderwerp en het niveau, en geef per bron: titel, webadres, licentie, en voor welke ondersteuningsbehoefte dit materiaal helpt (bijvoorbeeld: veel beeld, korte teksten, oefeningen). Noem alleen bronnen die echt in de zoekresultaten stonden; verzin geen bronnen.
6. Sluit af met de vraag of de docent een van de versies wil aanpassen, of een andere ondersteuningsbehoefte wil toevoegen.
Regels:
- Je verandert de leerdoelen en de stof niet; je verandert de vorm.
- Je noemt geen namen van leerlingen en je vraagt er niet naar. Je werkt met behoeften, niet met diagnoses van personen.
- Je geeft geen medisch of psychologisch advies en stelt geen diagnoses.
- Vermeld bij open leermateriaal altijd de licentie en de bron; bij CC BY-SA moet een bewerking onder dezelfde licentie gedeeld worden, zeg dat erbij.
- Alle bestanden schrijf je in het Nederlands, in markdown.
De instructie volgt de opbouw van handleiding 4 (wie, werkwijze, wat je oplevert, regels), met twee toevoegingen. De zeven beoordelingspunten in stap 3 zijn de vertaling van de drie UDL-principes naar iets wat je aan een tekst kunt aflezen. En stap 5 vertelt de agent precies hoe hij de eigen tool moet aanroepen, inclusief de AND-regel; zonder die zin probeert hij het eerst fout en dan pas goed (zie stap 6).
Zelf kiezen: de ondersteuningsbehoeften. De zes behoeften in punt 2 zijn een keuze. Jullie ondersteuningscoördinator heeft misschien een andere lijst, of wil "langdurig ziek" of "doof of slechthorend" erbij. Elke behoefte die je toevoegt, moet ook in punt 4 een antwoord krijgen: wat verandert er dan in de tekst of in de les? Anders noemt de agent de behoefte wel maar doet hij er niets mee.
Zelf kiezen: wat de leerlingversie doet. "Maximaal 15 woorden per zin, begrippenlijst bovenaan, controlevraag per paragraaf" zijn concrete regels waar je op kunt controleren. Wil je liever een versie met pictogrammen, met een samenvatting per paragraaf, of in het Engels voor een nieuwkomer: zet het er net zo concreet in.
Stap 5. Voeg de lesbrief en de tool toe
- Klik bij BESTANDEN op Add, kies
lesbrief-ecologie.pdfen klik op Uploaden.
- Klik bij TOOLS op Add, klik op het tabblad Swagger API, klik op Edurep zoeken en dan op Add all. Sluit de kiezer met Escape. Onder TOOLS staat nu Edurep zoeken.
De lesbrief in BESTANDEN is het voorbeeld voor de test. In de webapp kan een docent straks zijn eigen lesbrief meesturen via het paperclipje in de chat; de agent gebruikt dan dat bestand en niet het voorbeeld (dat staat zo in punt 1 van de instructie).
Stap 6. Test als docent
- Klik rechtsboven op VOORBEELD.
- Typ het eerste bericht.
| Bericht | Wat je intypt |
|---|---|
| 1 | Hoi, ik geef biologie in 3 havo. Kun je mijn lesbrief over ecologie bekijken? |
De agent ziet de lesbrief bij zijn bestanden en stelt de vraag over ondersteuningsbehoeften, met de zes keuzes en "weet ik niet".
- Kies drie behoeften.
| Bericht | Wat je intypt |
|---|---|
| 2 | Dyslexie, taalzwak of NT2, en hoogbegaafd. |
Nu gaat de agent aan het werk, en dat duurt ruim een minuut. Boven het antwoord zie je wat hij doet: vier keer Opdrachten uitgevoerd (de lesbrief lezen, de drie bestanden schrijven) en vijf keer zoekOpenLeermateriaal (de eigen tool). Onderaan staat Stop responding zolang hij bezig is.
- Wacht tot het antwoord compleet is. Het begint met het Kort rapport: zeven punten met een score en een zin uitleg. Voor onze lesbrief: zinslengte matig, vakbegrippen goed, structuur goed, voorkennis matig, visuele ondersteuning zwak, variatie in verwerking matig, keuze in hoe je laat zien wat je geleerd hebt zwak.
- Daaronder staan de Gemaakte bestanden als links: docent-notitie.md, leerling-versie-toegankelijk.md en, omdat hoogbegaafd gekozen is, leerling-versie-verdieping.md.
- Als laatste het Open leermateriaal uit Wikiwijs: vijf bronnen met webadres, licentie, voor welke behoefte ze helpen en waarom. Twee ervan zijn CC BY-SA, met de waarschuwing dat een bewerking onder dezelfde licentie gedeeld moet worden. De eerste bron is de Stercollectie-module van VO-content die ook bij handleiding 8 hoort.
- Klik op Aan het nadenken · 1 min 20 s om te zien wat de agent deed.
- Klik op de eerste zoekOpenLeermateriaal. Je ziet de REQUEST (de zoekvraag die de agent zelf formuleerde) en de RESPONSE van Edurep. In onze test ging de eerste zoekopdracht mis: de agent zette drie woorden los achter elkaar, Edurep antwoordde "Query Feature Unsupported", en de agent probeerde het daarna met AND. Dat is precies het gedrag van een agent: proberen, kijken, opnieuw.
- Vraag om een stukje van de leerlingversie te zien.
| Bericht | Wat je intypt |
|---|---|
| 3 | Laat de begrippenlijst en paragraaf 1 uit leerling-versie-toegankelijk.md hier in de chat zien. |
De begrippenlijst heeft negentien begrippen, elk in één zin uitgelegd. Paragraaf 1 heeft tussenkopjes, korte zinnen en na elk stuk een controlevraag. Vergelijk met de oorspronkelijke lesbrief: de inhoud is hetzelfde, de vorm niet.
De bestanden staan in de sandbox van de agent en zijn via de links te downloaden. Ze zijn markdown (.md): platte tekst met kopjes, te openen in elke editor en te plakken in Word. Wil je meteen een Word-bestand, zet dan in punt 4 van de instructie ".docx" in plaats van ".md"; de agent maakt het dan met een programmaatje, zoals de Toetsweekplanner een Excel maakt.
Stap 7. Publiceer
- Klik op Update publiceren. De knop wordt grijs met Gepubliceerd.
- Klik op Toegangspunt voor de webapp-link.
Wie de link krijgt, kan zijn eigen lesbrief meesturen via het paperclipje en krijgt hetzelfde rapport, dezelfde bestanden en dezelfde zoekresultaten. Gesprekken via de webapp staan in Logs (zie handleiding 4, stap 8).
Controleren of het gelukt is
- Onder Integraties → Swagger API as Tool staat Edurep zoeken met één actie, en de test geeft numberOfRecords groter dan 0
- Onder TOOLS van de agent staat Edurep zoeken; onder BESTANDEN staat de lesbrief
- De agent vraagt eerst naar ondersteuningsbehoeften en beoordeelt pas daarna
- Het rapport heeft zeven punten met een score
- Er zijn twee bestanden (drie als hoogbegaafd is gekozen) en maximaal vijf bronnen met licentie
- De Toegangs-URL opent een werkende chat
Als het misgaat
| Wat je ziet | Wat er aan de hand is |
|---|---|
| Bij het plakken van het schema verschijnt geen tool onder Available Tools | Het JSON klopt niet: een komma of accolade te veel of te weinig. Plak het bestand edurep-zoeken.openapi.json opnieuw |
Test geeft Query Feature Unsupported |
Zoekwoorden zonder AND ertussen (stap 3, oranje kader) |
| Test geeft numberOfRecords 0 | Het zoekwoord komt niet voor, of exact wikiwijsmaken is verkeerd gespeld |
| De agent noemt bronnen die niet in de RESPONSE staan | Het model vult aan uit eigen geheugen. De regel "verzin geen bronnen" staat in de instructie; controleer de links altijd zelf |
| De agent maakt geen bestanden, alleen tekst | Het woord "sandbox" ontbreekt in punt 4 van de instructie, of het model is niet compatibel (handleiding 4, stap 2) |
| De leerlingversie laat stukken weg | De zin "Laat geen inhoud weg; vereenvoudig de vorm, niet de stof" ontbreekt |
| De agent vraagt naar namen van leerlingen | De regel "Je noemt geen namen van leerlingen en je vraagt er niet naar" ontbreekt |
| Het antwoord komt na een minuut nog niet | Normaal voor deze agent: lezen, drie bestanden schrijven en vijf keer zoeken kost tijd. Wacht tot Stop responding weg is |
| De credits of de OpenAI-kosten lopen hard op | Elke beurt is 100.000 tot 300.000 tokens. Test met één of twee behoeften, niet met alle zes |
Maak hem van jou
De lesbrief is verzonnen en de zes behoeften zijn een voorbeeld. Dit hoofdstuk helpt je de agent om te bouwen naar jullie school en jullie vak. Van makkelijk naar moeilijk.
| Aanpassing | Waar | Moeilijkheid | Wat je ervoor terugkrijgt |
|---|---|---|---|
| Je eigen lesbrief als voorbeeld | Stap 5, bestand vervangen | makkelijk | Een demo met materiaal dat collega's herkennen |
| Andere ondersteuningsbehoeften | Stap 4, punt 2 en 4 van de prompt | makkelijk | Een lijst die past bij jullie ondersteuningsstructuur |
| Bestanden als .docx in plaats van .md | Stap 4, punt 4 | makkelijk | Meteen te openen in Word |
| Alleen Wikiwijs, of juist alle bronnen van Edurep | Stap 4, punt 5 (het stuk AND meta.repository.id ... weglaten) |
makkelijk | Meer of minder zoekresultaten |
| Een score per UDL-principe in plaats van zeven losse punten | Stap 4, punt 3 | gemiddeld | Een rapport dat aansluit bij de UDL-taal van jullie school |
| Een vierde bestand: ouderbrief over de aangepaste versie | Stap 4, punt 4 | gemiddeld | Communicatie erbij, in dezelfde beurt |
| Kerndoelen en leerdoelen erbij (SLO) | Stap 3, tweede eigen tool op opendata.slo.nl (sleutel aanvragen) | gemiddeld | De agent zegt welke leerdoelen het materiaal dekt en wat ontbreekt |
| De agent als stap in een workflow | Toegangspunt → Workflowtoegang; of de agent aanroepen vanuit een Chatflow | moeilijk | Een intake-formulier vooraf en een vaste opmaak achteraf |
| Koppeling met de ELO of het leerlingvolgsysteem via MCP | Stap 2, tabblad MCP, in de SOML-omgeving | moeilijk | Materiaal rechtstreeks uit en naar de plek waar het gebruikt wordt |
Drie opdrachten
- Zoek de fout. Laat de agent jouw eigen lesbrief beoordelen en lees het rapport kritisch: welke score klopt niet? Pas de zin bij dat punt in de instructie aan tot het rapport klopt. Zo leer je dat de zeven punten van jou zijn, niet van het model.
- Controleer de bronnen. Open de vijf Wikiwijs-links die de agent gaf en beoordeel ze zelf op niveau en bruikbaarheid. Hoeveel had je zelf gekozen? Schrijf in de instructie erbij wat een bron voor jou bruikbaar maakt.
- Maak een tweede tool. Beschrijf een andere openbare API in een schema (de KNMI, het CBS, een woordenboek) en voeg hem toe. Laat de agent hem gebruiken en kijk bij REQUEST en RESPONSE wat er heen en weer gaat. Daarna begrijp je elke tool die je ooit tegenkomt.
Checklist voordat je eigen materiaal gebruikt
- Het materiaal dat je uploadt is van jezelf of heeft een licentie die bewerken toestaat
- Er staan geen leerlinggegevens in het materiaal of in het gesprek
- Aangepaste versies zijn voor alle leerlingen beschikbaar, niet alleen voor wie een indicatie heeft
- Bij bronnen met CC BY-SA deel je je bewerking onder dezelfde licentie, met bronvermelding
- Iemand leest de leerlingversie na voordat die de klas in gaat; de agent vereenvoudigt soms net te veel
- Er is één eigenaar van de agent en van de tool
Beheer
Wat Dify bewaart. Gesprekken via de webapp staan in Logs, inclusief het geüploade lesmateriaal en de gemaakte bestanden. Voor lesmateriaal is dat geen probleem; het is wel een reden om geen leerlinggegevens in de chat te zetten.
Kosten. Dit is de duurste agent van de serie: 100.000 tot 300.000 tokens per beurt, via een eigen sleutel 30 cent tot een euro. Een sectie die tien lesbrieven laat beoordelen is een paar euro kwijt. Zet een maandlimiet op de sleutel en laat de agent niet als open link rondgaan.
De eigen tool. Edurep is een openbare dienst van Kennisnet zonder sleutel. Verandert de zoekingang, dan faalt de tool; je merkt dat aan een RESPONSE met een foutmelding in plaats van XML. Het schema in edurep-zoeken.openapi.json is dan het enige wat je hoeft aan te passen. Meer over de zoektaal: developers.wiki.kennisnet.nl (Edurep).
Kerndoelen erbij. SLO stelt kerndoelen, leerdoelen en examenprogramma's open via opendata.slo.nl, met een gratis sleutel. Daarmee kan de agent bij elke lesbrief zeggen welke doelen hij dekt. Dat is de tweede eigen tool uit Maak hem van jou; het schema volgt hetzelfde patroon als dat van Edurep, met een sleutel in het veld Authorization.
Van prototype naar de Experimenteerruimte. Via Export DSL gaat de agent als bestand mee; de eigen tool moet in het andere account opnieuw aangemaakt worden (Integraties → Swagger API as Tool, hetzelfde schema).