dify-handleidingen/06-inclusief-lesmateriaal/video-lesmateriaal-check.srt

1
00:00:00,000 --> 00:00:05,237
Welkom bij de zesde handleiding van de reeks AI Agents met Dify voor school.

2
00:00:05,287 --> 00:00:07,394
Je bouwt de Lesmateriaal-check:

3
00:00:07,444 --> 00:00:21,655
een agent die een lesbrief beoordeelt op toegankelijkheid volgens Universal Design for Learning, drie bestanden schrijft, een docentnotitie en twee leerlingversies, en open leermateriaal zoekt op Wikiwijs.

4
00:00:21,705 --> 00:00:25,273
Dat laatste doet hij met een tool die je zelf maakt.

5
00:00:25,323 --> 00:00:27,916
Dat is het nieuwe in deze handleiding:

6
00:00:27,966 --> 00:00:31,584
een agent iets laten doen buiten zijn eigen sandbox.

7
00:00:32,384 --> 00:00:36,495
Deze agent werkt met lesmateriaal, niet met leerlingen.

8
00:00:36,545 --> 00:00:38,008
Toch drie afspraken:

9
00:00:38,058 --> 00:00:51,324
er gaan geen leerlinglijsten of handelingsplannen in, de agent vraagt naar behoeften in de klas en nooit naar namen, en aangepast materiaal is voor alle leerlingen beschikbaar.

10
00:00:51,374 --> 00:00:53,064
Dat is de kern van UDL.

11
00:00:53,114 --> 00:00:54,577
En let op de kosten:

12
00:00:54,627 --> 00:00:57,452
dit is de zwaarste agent uit de reeks.

13
00:00:57,502 --> 00:01:10,541
Eén complete beurt, lesbrief lezen, beoordelen, drie bestanden schrijven en vijf keer zoeken, kostte ruim driehonderdduizend tokens, ongeveer een euro via een eigen sleutel.

14
00:01:10,591 --> 00:01:15,584
Op Dify-credits is dat een flink deel van een sandbox in één keer.

15
00:01:16,384 --> 00:01:20,069
Klik op Agents, Create, Create from Blank.

16
00:01:20,119 --> 00:01:28,160
Naam Lesmateriaal-check, rol Toegankelijkheidscoach voor lesmateriaal, en een beschrijving.

17
00:01:28,210 --> 00:01:34,168
Klik op Create en zet het model op gpt-5.4, zoals in handleiding 4.

18
00:01:34,968 --> 00:01:37,664
Scroll naar Tools en klik op Add.

19
00:01:37,714 --> 00:01:40,161
Bovenaan staan vijf tabbladen:

20
00:01:40,211 --> 00:01:43,990
All, Toolplugin, Swagger API, Workflow en MCP.

21
00:01:44,040 --> 00:01:50,481
Elk tabblad is een manier om een agent iets te laten doen buiten zijn sandbox.

22
00:01:50,531 --> 00:01:58,138
Toolplugin zijn kant-en-klare tools uit de Marketplace, zoals CurrentTime uit handleiding 4.

23
00:01:58,188 --> 00:02:04,962
Swagger API is een website of dienst met een API die jij beschrijft in een schema.

24
00:02:05,012 --> 00:02:09,373
Workflow is een van je eigen Dify-workflows als tool.

25
00:02:09,423 --> 00:02:18,029
En MCP is de standaard waarmee AI-assistenten met systemen praten, bijvoorbeeld een leerlingvolgsysteem.

26
00:02:18,079 --> 00:02:21,857
Voor Wikiwijs bestaat geen kant-en-klare tool.

27
00:02:21,907 --> 00:02:25,519
Daarom maak je er zelf een, via Swagger API.

28
00:02:25,569 --> 00:02:27,816
Sluit de kiezer met Escape.

29
00:02:28,616 --> 00:02:41,298
Achter Wikiwijs zit Edurep, de zoekmachine van Kennisnet die open leermateriaal uit tientallen bronnen doorzoekbaar maakt, met een openbare zoekingang zonder sleutel.

30
00:02:41,348 --> 00:02:44,290
Je beschrijft die ingang in een schema:

31
00:02:44,340 --> 00:02:47,895
welk adres, welke parameters, wat er terugkomt.

32
00:02:47,945 --> 00:02:50,119
Dify maakt daar een tool van.

33
00:02:50,169 --> 00:02:56,255
Klik in het linkermenu op Integraties, dan op Swagger API as Tool, en op Create.

34
00:02:56,305 --> 00:02:56,639
Naam:

35
00:02:56,689 --> 00:02:57,713
Edurep zoeken.

36
00:02:57,763 --> 00:03:03,695
Plak bij Schema de tekst uit het bestand edurep zoeken punt openapi punt json.

37
00:03:03,745 --> 00:03:08,834
Zodra het schema klopt, verschijnt onder Available Tools één regel:

38
00:03:08,884 --> 00:03:10,522
zoekOpenLeermateriaal.

39
00:03:10,572 --> 00:03:13,820
Wat er in het schema staat, in gewone taal:

40
00:03:13,870 --> 00:03:23,101
de servers-regel is het adres van de zoekmachine, het pad is de zoekingang, de parameters zijn de velden die je meegeeft.

41
00:03:23,151 --> 00:03:28,010
En de description-teksten zijn niet voor jou maar voor de agent:

42
00:03:28,060 --> 00:03:32,152
daaruit leert hij wanneer en hoe hij de tool gebruikt.

43
00:03:32,202 --> 00:03:35,960
Laat Authorization op None staan en klik op Save.

44
00:03:36,760 --> 00:03:41,694
Klik op de kaart, dan op Configure, en in de tabel op Test.

45
00:03:41,744 --> 00:03:43,469
Vul de parameters in:

46
00:03:43,519 --> 00:03:55,718
query voedselweb AND meta punt repository punt id exact wikiwijsmaken, operation searchRetrieve, version 1.2, recordSchema lom, maximumRecords 3.

47
00:03:55,768 --> 00:03:56,817
Klik op Test.

48
00:03:56,867 --> 00:04:01,379
Onder Test Results verschijnt XML met numberOfRecords:

49
00:04:01,429 --> 00:04:05,265
dertig resultaten voor voedselweb op Wikiwijs.

50
00:04:05,315 --> 00:04:06,870
Let op de zoektaal.

51
00:04:06,920 --> 00:04:10,503
Edurep wil losse woorden verbonden met AND.

52
00:04:10,553 --> 00:04:18,613
Typ je ecologie voedselweb zonder AND, dan krijg je Query Feature Unsupported en nul resultaten.

53
00:04:18,663 --> 00:04:28,159
Het stuk met wikiwijsmaken beperkt tot Wikiwijs; laat je het weg, dan zoek je ook in bronnen als Groen Kennisnet.

54
00:04:28,209 --> 00:04:32,890
Elke dienst met een openbare API kan zo een tool worden:

55
00:04:32,940 --> 00:04:36,607
het KNMI, het CBS, een bibliotheekcatalogus.

56
00:04:36,657 --> 00:04:39,952
Het schema is altijd hetzelfde patroon.

57
00:04:40,752 --> 00:04:42,275
Terug naar de agent.

58
00:04:42,325 --> 00:04:44,555
Plak de instructie in Prompt.

59
00:04:44,606 --> 00:04:47,465
Dezelfde opbouw als in handleiding 4:

60
00:04:47,515 --> 00:04:50,611
wie, werkwijze, wat je oplevert, regels.

61
00:04:50,661 --> 00:04:51,633
De werkwijze:

62
00:04:51,683 --> 00:04:56,902
vraag om het lesmateriaal, of gebruik de lesbrief uit je bestanden.

63
00:04:56,952 --> 00:05:01,464
Vraag welke ondersteuningsbehoeften voorkomen, zes keuzes.

64
00:05:01,514 --> 00:05:04,609
Beoordeel op zeven punten met een score.

65
00:05:04,659 --> 00:05:07,283
Maak drie bestanden in de sandbox:

66
00:05:07,333 --> 00:05:22,855
de docentnotitie met per behoefte drie aanpassingen in de les, de toegankelijke leerlingversie met korte zinnen, begrippenlijst en controlevragen, en de verdiepingsversie als hoogbegaafd is gekozen.

67
00:05:22,905 --> 00:05:32,1000
Zoek dan open leermateriaal met de tool, twee of drie zoekopdrachten, kies maximaal vijf bronnen met titel, webadres en licentie.

68
00:05:33,050 --> 00:05:35,044
En sluit af met een vraag.

69
00:05:35,094 --> 00:05:41,886
Stap 5 vertelt de agent precies hoe hij de tool moet aanroepen, inclusief de AND-regel.

70
00:05:41,936 --> 00:05:46,526
Zonder die zin probeert hij het eerst fout en dan pas goed.

71
00:05:46,576 --> 00:05:47,312
De regels:

72
00:05:47,363 --> 00:06:00,024
de stof verandert niet, alleen de vorm; geen namen of diagnoses; altijd de licentie erbij, en bij CC BY-SA zeggen dat een bewerking onder dezelfde licentie moet.

73
00:06:00,824 --> 00:06:04,467
Klik bij Bestanden op Add en upload de lesbrief.

74
00:06:04,517 --> 00:06:09,621
Klik bij Tools op Add, tabblad Swagger API, Edurep zoeken, Add all.

75
00:06:09,671 --> 00:06:20,288
De lesbrief in Bestanden is het voorbeeld voor de test; in de webapp stuurt een docent straks zijn eigen lesbrief mee via het paperclipje.

76
00:06:21,088 --> 00:06:23,091
Klik op Voorbeeld en typ:

77
00:06:23,141 --> 00:06:29,414
hoi, ik geef biologie in 3 havo, kun je mijn lesbrief over ecologie bekijken?

78
00:06:29,464 --> 00:06:39,842
De agent ziet de lesbrief bij zijn bestanden en stelt de vraag over ondersteuningsbehoeften, met de zes keuzes en weet ik niet.

79
00:06:39,892 --> 00:06:40,581
Antwoord:

80
00:06:40,631 --> 00:06:44,080
dyslexie, taalzwak of NT2, en hoogbegaafd.

81
00:06:44,880 --> 00:06:48,199
Nu gaat de agent aan het werk, ruim een minuut.

82
00:06:48,249 --> 00:06:50,995
Boven het antwoord zie je wat hij doet:

83
00:06:51,045 --> 00:07:01,080
vier keer Opdrachten uitgevoerd, dat is de lesbrief lezen en de drie bestanden schrijven, en vijf keer zoekOpenLeermateriaal, de eigen tool.

84
00:07:01,880 --> 00:07:05,134
Het antwoord begint met het korte rapport:

85
00:07:05,184 --> 00:07:07,729
zeven punten met score en uitleg.

86
00:07:07,779 --> 00:07:09,224
Voor onze lesbrief:

87
00:07:09,274 --> 00:07:23,432
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.

88
00:07:24,232 --> 00:07:27,206
Daaronder de gemaakte bestanden als links:

89
00:07:27,256 --> 00:07:35,032
de docentnotitie, de toegankelijke leerlingversie, en omdat hoogbegaafd is gekozen ook de verdiepingsversie.

90
00:07:35,832 --> 00:07:39,295
Als laatste het open leermateriaal uit Wikiwijs:

91
00:07:39,345 --> 00:07:44,931
vijf bronnen met webadres, licentie, voor welke behoefte ze helpen en waarom.

92
00:07:44,981 --> 00:07:52,836
Twee ervan zijn CC BY-SA, met de waarschuwing dat een bewerking onder dezelfde licentie gedeeld moet worden.

93
00:07:52,886 --> 00:07:59,400
De eerste bron is de Stercollectie-module van VO-content die ook bij handleiding 8 hoort.

94
00:08:00,200 --> 00:08:05,224
Klik op Aan het nadenken en dan op de eerste zoekOpenLeermateriaal.

95
00:08:05,274 --> 00:08:12,040
Je ziet de Request, de zoekvraag die de agent zelf formuleerde, en de Response van Edurep.

96
00:08:12,090 --> 00:08:15,448
In onze test ging de eerste zoekopdracht mis:

97
00:08:15,498 --> 00:08:24,384
drie woorden los achter elkaar, Edurep antwoordde Query Feature Unsupported, en de agent probeerde het daarna met AND.

98
00:08:24,434 --> 00:08:27,413
Dat is precies het gedrag van een agent:

99
00:08:27,463 --> 00:08:29,432
proberen, kijken, opnieuw.

100
00:08:30,232 --> 00:08:30,634
Vraag:

101
00:08:30,684 --> 00:08:37,187
laat de begrippenlijst en paragraaf 1 uit de toegankelijke versie hier in de chat zien.

102
00:08:37,237 --> 00:08:42,460
De begrippenlijst heeft negentien begrippen, elk in één zin uitgelegd.

103
00:08:42,510 --> 00:08:48,335
Paragraaf 1 heeft tussenkopjes, korte zinnen en na elk stuk een controlevraag.

104
00:08:48,385 --> 00:08:51,498
Vergelijk met de oorspronkelijke lesbrief:

105
00:08:51,548 --> 00:08:54,285
de inhoud is hetzelfde, de vorm niet.

106
00:08:54,335 --> 00:08:59,935
De bestanden zijn markdown, te openen in elke editor en te plakken in Word.

107
00:08:59,985 --> 00:09:09,400
Wil je meteen een Word-bestand, zet dan in de instructie docx in plaats van md; de agent maakt het dan met een programmaatje.

108
00:09:10,200 --> 00:09:15,118
Klik op Update publiceren en dan op Toegangspunt voor de webapp-link.

109
00:09:15,168 --> 00:09:25,680
Wie de link krijgt, stuurt zijn eigen lesbrief mee via het paperclipje en krijgt hetzelfde rapport, dezelfde bestanden en dezelfde zoekresultaten.

110
00:09:26,480 --> 00:09:28,033
De controlelijst:

111
00:09:28,083 --> 00:09:30,861
werkt de tool bij Integraties?

112
00:09:30,911 --> 00:09:34,349
Vraagt de agent eerst naar behoeften?

113
00:09:34,399 --> 00:09:36,517
Zeven punten met score?

114
00:09:36,567 --> 00:09:37,931
Drie bestanden?

115
00:09:37,981 --> 00:09:40,382
Vijf bronnen met licentie?

116
00:09:40,432 --> 00:09:44,768
En zie je onder Aan het nadenken wat hij deed?

117
00:09:45,568 --> 00:09:54,905
De handleiding, de lesbrief, het toolschema en de beelden staan in de repository; de agent staat live op udify punt app.

118
00:09:54,955 --> 00:09:59,207
In de volgende video bouwen we verder aan Schoolnieuws:

119
00:09:59,257 --> 00:10:03,900
zelfkritiek en een poortwachter, met een mens die goedkeurt.

120
00:10:03,950 --> 00:10:04,576
Tot dan.