feat: uitlegvideo bij elke handleiding (schermafbeeldingen, Nederlandse stem, ondertitels)
- video-script.md, video-*.mp4 en .srt in de acht mappen - README-sectie Video's en CHANGELOG Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Guido van Dijk
Binary file not shown.
@@ -0,0 +1,480 @@
|
||||
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.
|
||||
|
||||
@@ -0,0 +1,83 @@
|
||||
# titel: De Lesmateriaal-check
|
||||
# ondertitel: Handleiding 6 · bouwen in de Agent Console: UDL en een eigen zoektool
|
||||
# stem: nl-NL-FennaNeural
|
||||
# tempo: -5%
|
||||
# uitvoer: video-lesmateriaal-check
|
||||
# reeks: Reeks AI Agents met Dify voor school
|
||||
# bron: git.lexconsultancy.nl/guido/dify-handleidingen
|
||||
|
||||
[titel]
|
||||
Welkom bij de zesde handleiding van de reeks AI Agents met Dify voor school. Je bouwt de Lesmateriaal-check: 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.
|
||||
|
||||
Dat laatste doet hij met een tool die je zelf maakt. Dat is het nieuwe in deze handleiding: een agent iets laten doen buiten zijn eigen sandbox.
|
||||
|
||||
[kaart: Lees dit eerst | Lesmateriaal erin, geen leerlinglijsten of handelingsplannen; behoeften, geen namen | Je eigen lesbrief mag bewerkt worden, materiaal van een uitgever alleen als de licentie het toestaat | Aangepast materiaal is voor alle leerlingen, niet alleen voor wie een indicatie heeft | Dit is de zwaarste agent uit de reeks: één beurt kost ruim 300.000 tokens, ongeveer een euro via een eigen sleutel]
|
||||
Deze agent werkt met lesmateriaal, niet met leerlingen. Toch drie afspraken: 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. Dat is de kern van UDL.
|
||||
|
||||
En let op de kosten: dit is de zwaarste agent uit de reeks. 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. Op Dify-credits is dat een flink deel van een sandbox in één keer.
|
||||
|
||||
[beeld: 02-configureren-model.jpg | Stap 1. De agent]
|
||||
Klik op Agents, Create, Create from Blank. Naam Lesmateriaal-check, rol Toegankelijkheidscoach voor lesmateriaal, en een beschrijving. Klik op Create en zet het model op gpt-5.4, zoals in handleiding 4.
|
||||
|
||||
[beeld: 03-tools-kiezer.jpg | Stap 2. Welke tools zijn er?]
|
||||
Scroll naar Tools en klik op Add. Bovenaan staan vijf tabbladen: All, Toolplugin, Swagger API, Workflow en MCP. Elk tabblad is een manier om een agent iets te laten doen buiten zijn sandbox.
|
||||
|
||||
Toolplugin zijn kant-en-klare tools uit de Marketplace, zoals CurrentTime uit handleiding 4. Swagger API is een website of dienst met een API die jij beschrijft in een schema. Workflow is een van je eigen Dify-workflows als tool. En MCP is de standaard waarmee AI-assistenten met systemen praten, bijvoorbeeld een leerlingvolgsysteem.
|
||||
|
||||
Voor Wikiwijs bestaat geen kant-en-klare tool. Daarom maak je er zelf een, via Swagger API. Sluit de kiezer met Escape.
|
||||
|
||||
[beeld: 05-custom-tool-schema.jpg | Stap 3. Een eigen tool: Edurep zoeken]
|
||||
Achter Wikiwijs zit Edurep, de zoekmachine van Kennisnet die open leermateriaal uit tientallen bronnen doorzoekbaar maakt, met een openbare zoekingang zonder sleutel. Je beschrijft die ingang in een schema: 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, en op Create. Naam: Edurep zoeken. Plak bij Schema de tekst uit het bestand edurep zoeken punt openapi punt json. Zodra het schema klopt, verschijnt onder Available Tools één regel: zoekOpenLeermateriaal.
|
||||
|
||||
Wat er in het schema staat, in gewone taal: de servers-regel is het adres van de zoekmachine, het pad is de zoekingang, de parameters zijn de velden die je meegeeft. En de description-teksten zijn niet voor jou maar voor de agent: daaruit leert hij wanneer en hoe hij de tool gebruikt. Laat Authorization op None staan en klik op Save.
|
||||
|
||||
[beeld: 10-tool-test-resultaat.jpg | Stap 3. De tool testen]
|
||||
Klik op de kaart, dan op Configure, en in de tabel op Test. Vul de parameters in: query voedselweb AND meta punt repository punt id exact wikiwijsmaken, operation searchRetrieve, version 1.2, recordSchema lom, maximumRecords 3. Klik op Test. Onder Test Results verschijnt XML met numberOfRecords: dertig resultaten voor voedselweb op Wikiwijs.
|
||||
|
||||
Let op de zoektaal. Edurep wil losse woorden verbonden met AND. Typ je ecologie voedselweb zonder AND, dan krijg je Query Feature Unsupported en nul resultaten. Het stuk met wikiwijsmaken beperkt tot Wikiwijs; laat je het weg, dan zoek je ook in bronnen als Groen Kennisnet.
|
||||
|
||||
Elke dienst met een openbare API kan zo een tool worden: het KNMI, het CBS, een bibliotheekcatalogus. Het schema is altijd hetzelfde patroon.
|
||||
|
||||
[beeld: 11-prompt-ingevuld.jpg | Stap 4. De instructie]
|
||||
Terug naar de agent. Plak de instructie in Prompt. Dezelfde opbouw als in handleiding 4: wie, werkwijze, wat je oplevert, regels.
|
||||
|
||||
De werkwijze: vraag om het lesmateriaal, of gebruik de lesbrief uit je bestanden. Vraag welke ondersteuningsbehoeften voorkomen, zes keuzes. Beoordeel op zeven punten met een score. Maak drie bestanden in de sandbox: 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. Zoek dan open leermateriaal met de tool, twee of drie zoekopdrachten, kies maximaal vijf bronnen met titel, webadres en licentie. En sluit af met een vraag.
|
||||
|
||||
Stap 5 vertelt de agent precies hoe hij de tool moet aanroepen, inclusief de AND-regel. Zonder die zin probeert hij het eerst fout en dan pas goed. De regels: 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.
|
||||
|
||||
[beeld: 13-lesbrief-geupload.jpg | Stap 5. Lesbrief en tool toevoegen]
|
||||
Klik bij Bestanden op Add en upload de lesbrief. Klik bij Tools op Add, tabblad Swagger API, Edurep zoeken, Add all. De lesbrief in Bestanden is het voorbeeld voor de test; in de webapp stuurt een docent straks zijn eigen lesbrief mee via het paperclipje.
|
||||
|
||||
[beeld: 15-test-eerste-antwoord.jpg | Stap 6. Testen als docent]
|
||||
Klik op Voorbeeld en typ: 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. Antwoord: dyslexie, taalzwak of NT2, en hoogbegaafd.
|
||||
|
||||
[beeld: 16-test-bezig.jpg | Stap 6. De agent aan het werk]
|
||||
Nu gaat de agent aan het werk, ruim een minuut. Boven het antwoord zie je wat hij doet: vier keer Opdrachten uitgevoerd, dat is de lesbrief lezen en de drie bestanden schrijven, en vijf keer zoekOpenLeermateriaal, de eigen tool.
|
||||
|
||||
[beeld: 17-rapport-begin.jpg | Stap 6. Het rapport]
|
||||
Het antwoord begint met het korte rapport: zeven punten met score en 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.
|
||||
|
||||
[beeld: 18-rapport-bestanden.jpg | Stap 6. De drie bestanden]
|
||||
Daaronder de gemaakte bestanden als links: de docentnotitie, de toegankelijke leerlingversie, en omdat hoogbegaafd is gekozen ook de verdiepingsversie.
|
||||
|
||||
[beeld: 19-open-leermateriaal.jpg | Stap 6. Open leermateriaal]
|
||||
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.
|
||||
|
||||
[beeld: 21-zoekopdracht-detail.jpg | Stap 6. Wat de agent deed]
|
||||
Klik op Aan het nadenken en dan 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: 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.
|
||||
|
||||
[beeld: 23-leerlingversie-paragraaf.jpg | Stap 6. De leerlingversie]
|
||||
Vraag: laat de begrippenlijst en paragraaf 1 uit de toegankelijke versie 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 zijn markdown, te openen in elke editor en te plakken in Word. Wil je meteen een Word-bestand, zet dan in de instructie docx in plaats van md; de agent maakt het dan met een programmaatje.
|
||||
|
||||
[beeld: 25-toegangspunt.jpg | Stap 7. Publiceren]
|
||||
Klik op Update publiceren en dan op Toegangspunt voor de webapp-link. Wie de link krijgt, stuurt zijn eigen lesbrief mee via het paperclipje en krijgt hetzelfde rapport, dezelfde bestanden en dezelfde zoekresultaten.
|
||||
|
||||
[kaart: Controleren of het gelukt is | Onder Integraties staat de tool Edurep zoeken met één actie, en de test geeft records terug | De agent vraagt eerst naar behoeften en beoordeelt pas daarna | Het rapport heeft zeven punten met score | Drie bestanden, waarvan de verdiepingsversie alleen bij hoogbegaafd | Vijf bronnen met licentie, en de CC BY-SA-waarschuwing | Onder Aan het nadenken staan opdrachten en zoekopdrachten]
|
||||
De controlelijst: werkt de tool bij Integraties? Vraagt de agent eerst naar behoeften? Zeven punten met score? Drie bestanden? Vijf bronnen met licentie? En zie je onder Aan het nadenken wat hij deed?
|
||||
|
||||
[slot: Een eigen tool, en een agent die leert van zijn fout.]
|
||||
De handleiding, de lesbrief, het toolschema en de beelden staan in de repository; de agent staat live op udify punt app. In de volgende video bouwen we verder aan Schoolnieuws: zelfkritiek en een poortwachter, met een mens die goedkeurt. Tot dan.
|
||||
Reference in New Issue
Block a user