Guido van Dijk
19 KiB
Bouwen in Microsoft 365 Copilot: de Toetsweekplanner
Handleiding 3 van de reeks Copilot-agents voor school
LeX Consultancy B.V. · 21 september 2026
Je bouwt een agent die met een leerling een studieplan voor de toetsweek maakt. De agent kent het toetsrooster, vraagt wanneer de leerling kan leren en hoe moeilijk de vakken zijn, en levert dan een plan in de chat plus een Excel-bestand op OneDrive. Dat laatste is nieuw: de agent schrijft en draait een klein programma om dat bestand te maken.
Dit is de tegenhanger van handleiding 4 uit de Dify-reeks (de Agent Console). Wie die kent, ziet hetzelfde ontwerp: een instructie met regels, een rooster, en een agent die zelf bepaalt hoe hij het aanpakt. De stappen in de Agent Builder ken je uit handleiding 1 en 2; hier staan ze kort.
Deze handleiding volgt Microsoft 365 Copilot zoals het er op 21 september 2026 uitziet, in een werkaccount met Copilot Chat en zonder de betaalde Microsoft 365 Copilot-licentie. Wijkt je scherm af, volg dan wat je ziet.
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
| 1. Voor wie | 2. Wat gaat erin |
|---|---|
| Een leerling uit klas 2, drie weken voor de toetsweek, die niet weet waar te beginnen. Heeft het rooster, een telefoon en anderhalf uur per avond. | Het toetsrooster (in de instructie), de momenten waarop de leerling kan leren, en per vak makkelijk/gemiddeld/moeilijk. De agent vraagt ze een voor een. |
| 3. Wat komt eruit | 4. Waar moet hij zich aan houden |
|---|---|
| Een plan per dag in de chat (blok, vak, tijd, stof) en een bestand studieplan.xlsx op OneDrive. Afsluiting met de vraag of er iets moet schuiven. | Vijf planregels (moeilijke vakken dubbel, elk vak twee keer, blokken van 25-45 minuten met pauze, avond voor de toets alleen herhalen, niets buiten de opgegeven momenten); geen cijfers of oordelen; geen naam vragen. |
5. Waaraan zie je dat het werkt
| Test | Wat gaat erin | Wat moet eruit komen |
|---|---|---|
| 1 | Datum van vandaag, leermomenten en moeilijkheid | Een plan dat de momenten respecteert, plus een echt Excel-bestand |
| 2 | "Op maandag staat nieuwe stof Engels, terwijl de toets dinsdag is. Klopt dat met je regels?" | De agent controleert zichzelf aan de regel en stelt een correctie voor |
| 3 (de lastige) | "Ga ik mijn wiskundetoets halen?" | Geen voorspelling; terug naar het plan |
Lees dit eerst: wat mag en wat niet
Een studieplan is onschuldig, maar een leerling vertelt de agent wanneer hij thuis is en wat hij moeilijk vindt. Daarom:
| Wat | Afspraak |
|---|---|
| Echte leerlingen | Alleen als leerlingen een eigen schoolaccount in Microsoft 365 hebben en de school Copilot Chat voor leerlingen heeft aangezet. Dan vallen de gesprekken onder de afspraken van de school met Microsoft. In deze handleiding ben jij de "leerling". |
| Wat de agent zegt | Geen cijfers, oordelen of voorspellingen over toetsen. Dat staat in de instructie en blijft erin: een agent die leerlingen beoordeelt, valt onder de AI Act in de categorie hoog risico. |
| Bestanden | Het Excel-bestand komt in de OneDrive van degene die chat. Bij een leerling dus in de OneDrive van die leerling, niet bij jou. |
| Voor wie | Als de planner ooit voor leerlingen gaat: voor alle leerlingen, niet alleen voor leerlingen met een ondersteuningsbehoefte. |
Voorbereiding
- Handleiding 1 gedaan.
- Het toetsrooster
toetsrooster-voorbeeld.csvuit deze map, om te lezen: zes toetsen van maandag 12 tot en met vrijdag 16 oktober 2026. De tekst staat al ininstructies.txt, omgezet naar zinnen. - Geduld: deze agent rekent en schrijft een bestand. Een compleet plan duurde in onze test enkele minuten, en het antwoord verschijnt regel voor regel.
Zelf kiezen: het rooster. Zet het echte toetsrooster van een klas in de instructie, in dezelfde vorm: per regel dag, datum, vak, begintijd, duur en stof. Zonder leerlinggegevens, want het is een rooster, geen klassenlijst. Alles wat een leerling daarna typt, gaat over zichzelf; het rooster is voor iedereen hetzelfde.
Stap 1. Maak de agent
- Klik op Nieuwe agent, dan op Overslaan.
- Vul naam en beschrijving in.
| Veld op het scherm | Wat je intypt |
|---|---|
| Naam | Toetsweekplanner |
| Beschrijving | Maakt met een leerling een persoonlijk studieplan voor de toetsweek: verdeelt de toetsstof over de beschikbare momenten en levert het plan als Excel-bestand. |
Vul de naam pas in als het formulier helemaal geladen is. Typ je te vroeg, dan komt je tekst midden in "Nieuwe agent" terecht of raakt hij kwijt. Kijk na het typen even naar de kop.
Stap 2. Schrijf de instructie
- Klik in Instructies en plak de tekst uit
instructies.txt:
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. Het rooster van deze toetsweek staat hieronder; vat het kort samen. Geeft de leerling een ander rooster, gebruik dan dat.
2. De momenten waarop de leerling kan leren, per dag, vanaf vandaag tot de laatste toets. Vraag ook welke datum het vandaag is als je dat niet weet.
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).
- Een Excel-bestand studieplan.xlsx met per rij: dag, datum, begintijd, eindtijd, vak, stof. Maak dat bestand echt aan en geef de leerling de link.
- 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 vraagt niet naar de naam van de leerling en bewaart niets.
TOETSROOSTER (dag, datum, vak, begintijd, duur, toetsstof)
maandag 12 oktober 2026, Nederlands, 09:00, 60 minuten: leesvaardigheid hoofdstuk 3 en 4; spelling werkwoorden (d/t)
maandag 12 oktober 2026, wiskunde, 10:45, 45 minuten: hoofdstuk 2 (vergelijkingen) en 3 (procenten)
dinsdag 13 oktober 2026, Engels, 09:00, 45 minuten: unit 3 en 4: woordenlijst, present simple en present continuous
woensdag 14 oktober 2026, geschiedenis, 09:00, 45 minuten: hoofdstuk 5: de Republiek in de Gouden Eeuw (paragraaf 1 t/m 4)
donderdag 15 oktober 2026, biologie, 10:45, 45 minuten: thema 2: cellen en organen (basisstof 1 t/m 5)
vrijdag 16 oktober 2026, Frans, 09:00, 45 minuten: chapitre 2: vocabulaire, être en avoir, getallen tot 100
Vier delen: wat de agent nodig heeft, de planregels, wat hij oplevert, en het rooster. Twee zinnen verdienen aandacht. "Vraag ook welke datum het vandaag is" staat erin omdat de agent in Copilot Chat geen klok heeft: zonder die zin plant hij vanaf een datum die hij verzint. En "Maak dat bestand echt aan en geef de leerling de link" is de zin die de agent aan het programmeren zet.
Het rooster staat in de instructie als zinnen, niet als CSV. De kolomkoppen "dag, datum, vak, begintijd, duur, toetsstof" staan er een keer boven; dat is genoeg om een tabel te begrijpen, en het plakt zonder problemen.
- Vul de startvragen in.
| Titel | Bericht |
|---|---|
Plan maken |
Hoi, ik wil een studieplan voor de toetsweek. |
Rooster bekijken |
Welke toetsen heb ik in de toetsweek en wat is de stof? |
Plan aanpassen |
Ik wil een blok verschuiven in mijn plan. |
Stap 3. Kijk of de agent bestanden mag maken
- Klik op het tandwiel achter Kennis. Onder Kennisinstellingen staat Maak documenten, grafieken en code. Die staat standaard aan; laat dat zo. Zonder die schakelaar kan de agent geen Excel maken en beschrijft hij het plan alleen.
- Sluit het venster. Kennis blijft leeg en Webzoekopdracht blijft uit.
Dit is de Copilot-versie van de "sandbox" uit de Dify Agent Console: een plek waar de agent een programma mag draaien. Je ziet er in Copilot minder van (geen script om te lezen), maar het resultaat is hetzelfde: een bestand dat er anders niet was.
Stap 4. Test als leerling
- Klik op Voorbeeld en stuur het eerste bericht. Geef de datum mee, want de agent weet niet welke dag het is.
| Bericht | Wat je intypt |
|---|---|
| 1 | Hoi, ik wil een studieplan voor de toetsweek. Het is vandaag maandag 5 oktober 2026. |
De agent vat het rooster samen en stelt zijn eerste vraag: wanneer kun je leren, met een voorbeeld van hoe je dat opgeeft.
- Geef je leermomenten op.
| 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 bevestigt en vraagt per vak hoe moeilijk je het vindt, met de drie keuzes erbij.
- 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. Als eerste verschijnt: Het gegenereerde 'studieplan.xlsx' bestand is automatisch opgeslagen in OneDrive, met daaronder Programmeren en uitvoeren. De agent heeft een programma geschreven, gedraaid en het bestand weggezet, nog voordat het plan in de chat staat.
- Wacht. Het plan verschijnt regel voor regel, per dag een kopje met de blokken en pauzes.
Onderaan staat Excel-bestand: studieplan.xlsx als link, de vraag of je iets wilt verschuiven, en 1 verwijzing: CodeInterpreter. Dat laatste is Copilots naam voor het onderdeel dat programma's draait.
- Klik op studieplan.xlsx. Het bestand opent in Excel op OneDrive: een tabel met per rij dag, datum, begintijd, eindtijd, vak en stof, precies zoals de instructie vroeg.
Het antwoord komt in Copilot Chat tergend langzaam op het scherm, en alleen als het venster zichtbaar is. Zet het niet op de achtergrond; wacht tot Kopiëren onder het antwoord staat. In onze test duurde het plan ruim vijf minuten.
Stap 5. Controleer het plan aan de regels
Lees het plan tegen de vijf regels. In onze test viel iets op: op maandag 12 oktober stond "Engels: unit 4 en werkwoordstijden", nieuwe stof, terwijl de toets Engels op dinsdag is en de regel zegt: de avond voor een toets alleen herhalen. Leg dat de agent voor.
| Bericht | Wat je intypt |
|---|---|
| 4 | Op maandag 12 oktober staat Engels unit 4 als nieuwe stof, terwijl de toets Engels dinsdag is. Klopt dat met je regels? |
De agent geeft het toe, citeert de regel, ziet zelf nog een tweede fout (Engels kwam maar een keer terug voor de toets) en stelt een betere verdeling voor. Hij vraagt of hij het hele plan opnieuw mag maken.
Dit is de les van deze handleiding, dezelfde als in de Dify-reeks: een agent interpreteert regels, hij voert ze niet uit als een programma. Het plan zag er goed uit en had toch een fout. Wie het plan naleest, vindt hem; wie het plan doorstuurt, niet. De agent kan zichzelf corrigeren, maar alleen als iemand het vraagt.
Zelf kiezen: laat de agent zichzelf controleren. Voeg aan "Wat je oplevert" toe: "Loop het plan voordat je het geeft na op alle vijf de planregels en verbeter het waar het niet klopt." Dat vangt een deel van de fouten af, niet alles. Test opnieuw met dezelfde drie berichten en vergelijk.
Stap 6. Maak de agent
- Klik op Maken. De agent is privé.
- Sluit de Builder. De Toetsweekplanner staat onder Agents, naast de twee agents uit handleiding 1 en 2.
Delen: zie handleiding 1, stap 7. Voor deze agent geldt de tabel aan het begin: alleen met leerlingen als de school dat heeft ingericht.
Controleren of het gelukt is
- De agent vat het rooster samen en stelt daarna zijn vragen een voor een
- Hij plant pas als hij datum, leermomenten en moeilijkheid heeft
- Er staat een link naar studieplan.xlsx in het antwoord en het bestand opent op OneDrive
- Het plan gebruikt alleen de opgegeven momenten (kijk zelf na)
- Op een vraag naar een regel legt de agent uit en corrigeert hij
Als het misgaat
| Wat je ziet | Wat er aan de hand is |
|---|---|
| De agent plant vanaf een verkeerde datum | Hij weet niet welke dag het is. Geef de datum in je eerste bericht, of laat de zin "Vraag ook welke datum het vandaag is" in de instructie staan |
| Geen Excel-bestand, alleen een beschrijving | Maak documenten, grafieken en code staat uit (stap 3), of de zin "Maak dat bestand echt aan" ontbreekt |
| De link naar het bestand werkt niet | Het bestand staat in de OneDrive van degene die chatte; iemand anders kan het niet openen. Open het via je eigen OneDrive, map van Copilot |
| De agent stelt alle vragen tegelijk | "Stel deze vragen een voor een" ontbreekt |
| Het plan zet blokken op momenten die je niet gaf, of nieuwe stof op de avond voor de toets | De agent interpreteert. Leg het hem voor (stap 5) en overweeg de zelfcontrole uit het groene kader |
| Het antwoord blijft hangen | Het venster staat op de achtergrond. Zet Copilot in beeld en wacht; het antwoord loopt door |
| De agent noemt een cijfer of een kans | De laatste alinea van de instructie ontbreekt |
Copilot naast de Dify Agent Console
| Dify Agent Console (handleiding 4) | Copilot Agent Builder | |
|---|---|---|
| Rooster meegeven | Bestand uploaden onder FILES | In de instructie (gratis laag) of als bestand (betaald) |
| Datum weten | Tool CurrentTime | Niet beschikbaar; de leerling geeft de datum |
| Bestanden maken | Sandbox: Python-script dat je kunt lezen, xlsx en ics | CodeInterpreter: script niet zichtbaar, alleen Word, Excel, PowerPoint |
| Waar komt het bestand | Link in de chat, tijdelijk | OneDrive van de gebruiker, blijvend |
| Model | Zelf kiezen (gpt-5.4), eigen sleutel | Vast, zonder credits |
| Kijken wat de agent deed | Thinking, Ran commands, het script | Alleen "Programmeren en uitvoeren" en een verwijzing |
Copilot is hier makkelijker (niets in te richten, bestand staat meteen goed) en minder doorzichtig (je ziet het programma niet). Voor een leerling maakt dat niet uit; voor wie wil begrijpen wat een agent doet, is de Dify-versie leerzamer.
Maak hem van jou
| Aanpassing | Waar | Moeilijkheid | Wat je ervoor terugkrijgt |
|---|---|---|---|
| Toon en aanspreekvorm | Stap 2, eerste alinea | makkelijk | Een agent die klinkt als je mentoren |
| Je eigen planregels | Stap 2, kop Planregels | makkelijk | Een plan dat past bij de studielessen die je al geeft |
| Het echte rooster van een klas | Stap 2, kop TOETSROOSTER | makkelijk | Een planner die klaar is voor de komende toetsweek |
| Een Word-overzicht in plaats van Excel | Stap 2, "Wat je oplevert" | makkelijk | Een printbaar plan |
| Een vraag extra ("welke dag wil je vrijhouden?") | Stap 2, "Wat je nodig hebt" | gemiddeld | Ruimte voor sport of bijbaan |
| Zelfcontrole op de regels | Stap 2, "Wat je oplevert" (groene kader stap 5) | gemiddeld | Minder fouten om zelf te vinden |
| Rooster als bestand op SharePoint | Kennis, met Microsoft 365 Copilot-licentie | gemiddeld | Een rooster dat de roostermaker bijwerkt, niet jij |
| Een agendabestand (.ics) erbij | Stap 2, "Wat je oplevert" | moeilijk | Copilot maakt alleen Office-bestanden; vraag om een tabel die de leerling in Outlook importeert, of gebruik de Dify-versie |
Drie opdrachten
- Jouw regels. Vraag twee mentoren welke drie planregels zij hun leerlingen meegeven. Zet die in de instructie in plaats van de onze en voer hetzelfde testgesprek. Vergelijk de plannen: welk plan zou een leerling echt volgen?
- Vind de fout. Neem het plan uit je test en loop het regel voor regel na. Schrijf op wat niet klopt en leg het de agent voor, zoals in stap 5. Dat is de kern van werken met agents: jij blijft de controleur.
- Van Excel naar agenda. Vraag de agent om het plan als tabel met de kolommen Subject, Start Date, Start Time, End Date, End Time, zodat een leerling het als CSV in Outlook of Google Agenda kan importeren. Kijk of het lukt en wat er misgaat.
Checklist voordat je eigen materiaal gebruikt
- Het rooster in de instructie bevat geen namen of klassenlijsten
- De regel "geen cijfers, oordelen of voorspellingen" staat erin en je hebt hem getest
- Je weet in wiens OneDrive het bestand komt, en dat vind je goed
- Iemand heeft een handvol plannen aan de regels getoetst voordat leerlingen de agent krijgen
- Bij leerlingen: de school heeft Copilot Chat voor leerlingen ingericht en de privacyfunctionaris weet ervan
- Er is een eigenaar die het rooster elke toetsweek bijwerkt en op Bijwerken klikt
En verder
Drie agents, drie patronen: een die uit een document voorleest (1), een die regels toepast op een tekst (2), en een die rekent en een bestand maakt (3). Meer kan ook in Copilot: agents die in SharePoint zoeken, in Teams-kanalen lezen of acties uitvoeren in andere systemen. Daarvoor is de betaalde Microsoft 365 Copilot-licentie of Copilot Studio nodig; de instructie die je nu schrijft, blijft daar hetzelfde.