copilot-handleidingen/README.md

Copilot-handleidingen

Stap-voor-stap handleidingen voor het bouwen van AI-agents in Microsoft 365 Copilot (de Agent Builder) voor het onderwijs. De tegenhanger van de Dify-handleidingen: dezelfde fictieve school, dezelfde voorbeelden, maar gebouwd in de omgeving die de meeste scholen al hebben. Gemaakt door LeX Consultancy B.V. Alle voorbeelden spelen op Het Voorbeeldcollege (fictief); schermen vastgelegd in Microsoft 365 Copilot Chat op 21 september 2026, in een werkaccount zonder de betaalde Microsoft 365 Copilot-licentie.

Licentie: CC BY-SA 4.0 (documenten en beelden) en MIT (scripts), zie LICENSE.md. Eigenaar en contact: Guido van Dijk, guido@l-e-x.nl, guido@ai-netwerk-limburg.nl.

Inhoud

Map	Titel	Voor wie	Omvang
01-schoolgids-assistent	Bouwen in Microsoft 365 Copilot: de Schoolgids-assistent (agent die uit een document voorleest, met de kennis in de instructie)	Beginners	20 pp.
02-ouderbrief-assistent	Bouwen in Microsoft 365 Copilot: de Ouderbrief-assistent (agent die de schrijfwijzer toepast op een brief, en berichten maakt voor ouderapp en website)	Mentoren, teams communicatie	13 pp.
03-toetsweekplanner	Bouwen in Microsoft 365 Copilot: de Toetsweekplanner (agent die vragen stelt, plant en een Excel-bestand maakt)	Mentoren, Experimenteerruimte	15 pp.

Elke handleiding heeft een ingevulde ontwerpkaart, groene kaders "Zelf kiezen", een hoofdstuk "Maak hem van jou" met aanpassingen, opdrachten en een checklist, en een vergelijking met de Dify-versie van dezelfde app.

Waarvoor is welke agent

Agent	Wat hij doet	Voor wie	Patroon
Schoolgids-assistent (01)	Beantwoordt vragen over de schoolregels uit de schoolgids, met hoofdstukverwijzing; verwijst door als het antwoord er niet in staat	Collega's, leerlingen met schoolaccount	Kennis in de instructie
Ouderbrief-assistent (02)	Herschrijft een conceptbrief volgens de schrijfwijzer (B1, u, opbouw, lengte) en maakt er berichten voor ouderapp, website of sociale media van	Mentoren, teamleiders, team communicatie	Regels toepassen op een tekst
Toetsweekplanner (03)	Vraagt leermomenten en moeilijkheid, verdeelt de toetsstof over de dagen volgens vijf planregels en levert een Excel-bestand op OneDrive	Mentoren, leerlingen met schoolaccount	Vragen, rekenen, bestand maken

Wat je nodig hebt

• Een werkaccount van school met Microsoft 365 en toegang tot Copilot Chat (m365.cloud.microsoft).
• In het linkermenu van Copilot het kopje Agents met Nieuwe agent. Ontbreekt dat, dan heeft de beheerder het maken van agents uitgezet.
• Geen betaalde Microsoft 365 Copilot-licentie. Alles in deze reeks werkt in de gratis laag (Copilot Chat); waar de betaalde licentie iets toevoegt (bestanden en SharePoint als kennis), staat dat in een groen kader.

De agents zelf bouwen

Er is geen exportbestand zoals bij Dify: een Copilot-agent bestaat uit een naam, een beschrijving, een instructie en drie startvragen. Elke map bevat instructies.txt met de volledige instructie om te plakken; de rest staat in de handleiding. Vijf minuten per agent.

Zelf bouwen of aanpassen

Elke map heeft dezelfde structuur:

handleiding-*.md      bron (dit bewerk je)
handleiding-*.pdf     gebouwde uitvoer (staat in git)
beelden/              schermafbeeldingen
instructies.txt       de instructie van de agent
build.py              bouwt html, pdf en docx: python3 build.py

Alles in een keer: python3 _gereedschap/bouw_alles.py. Vereist python3-markdown, google-chrome en libreoffice. Opmaak, logo's en colofon staan in _gereedschap/build_handleiding.py.

De Dify-reeks staat op https://git.lexconsultancy.nl/guido/dify-handleidingen (Nederlands) en https://git.lexconsultancy.nl/guido/dify-guides (Engels).