Files
Guido van Dijk 23d899e4a8 feat(video): handleiding 3 en 8 in twee delen
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-21 18:20:19 +02:00

357 lines
8.6 KiB
Plaintext

1
00:00:00,000 --> 00:00:06,537
Welkom bij de derde handleiding van de reeks AI Agents met Dify voor school, deel 1 van 2.
2
00:00:06,587 --> 00:00:12,905
In handleiding 1 bouwde je een workflow, in handleiding 2 een agent met een kennisbank.
3
00:00:12,955 --> 00:00:16,418
Nu zet je die twee vormen in voor een echt team:
4
00:00:16,468 --> 00:00:19,712
de mensen die op school schrijven aan ouders.
5
00:00:19,762 --> 00:00:20,590
In dit deel:
6
00:00:20,640 --> 00:00:32,081
de schrijfwijzer in de kennisbank, de Ouderbrief-assistent die een conceptbrief herschrijft, en de Balie-stand, een tweede gebruiker in de app die je al had.
7
00:00:32,131 --> 00:00:38,352
Schoolnieuws, de workflow die van één formulier drie berichten maakt, komt in deel 2.
8
00:00:39,152 --> 00:00:45,947
Je hebt handleiding 2 gedaan, dus de kennisbank Schoolgids Voorbeeldcollege staat op je account.
9
00:00:45,997 --> 00:00:48,371
Nu komt daar de schrijfwijzer bij:
10
00:00:48,421 --> 00:00:55,644
twee pagina's met regels over taalniveau, aanspreekvorm, te vermijden woorden en de lengte per kanaal.
11
00:00:55,694 --> 00:01:06,032
Heeft jouw school een eigen huisstijlgids, dan gebruik je die; twee tot vijf pagina's met concrete regels werken beter dan dertig pagina's visie.
12
00:01:06,832 --> 00:01:13,954
Open bij Knowledge de kennisbank Schoolgids Voorbeeldcollege en klik bij Documents op Add file.
13
00:01:14,004 --> 00:01:15,615
Kies de schrijfwijzer.
14
00:01:15,665 --> 00:01:21,856
In de sandbox kun je maar één bestand per keer uploaden; dat is geen fout van jou.
15
00:01:22,656 --> 00:01:27,588
Dify onthoudt de instelling van het eerste document niet per se.
16
00:01:27,638 --> 00:01:33,426
Zet de delimiter opnieuw op twee keer backslash n en klik op Preview Chunk:
17
00:01:33,476 --> 00:01:36,929
een handvol stukken van een alinea of langer.
18
00:01:36,979 --> 00:01:40,666
Save and Process, en wacht op het groene vinkje.
19
00:01:40,716 --> 00:01:43,752
De kennisbank heeft nu twee documenten.
20
00:01:44,552 --> 00:01:51,025
Nu de beschrijving bijwerken, want de agent leest die om te beslissen of hij gaat zoeken.
21
00:01:51,075 --> 00:01:55,863
Nu er ook schrijfregels in staan, moet de beschrijving dat zeggen:
22
00:01:55,913 --> 00:02:07,150
twee documenten, schoolgids met de schoolregels, schrijfwijzer met hoe de school schrijft aan ouders, gebruik bij schoolregels en bij teksten voor ouders.
23
00:02:07,200 --> 00:02:07,663
Let op:
24
00:02:07,713 --> 00:02:10,961
de beschrijving mag maximaal 400 tekens zijn.
25
00:02:11,011 --> 00:02:16,019
Is hij langer, dan slaat Dify hem niet op en zie je geen foutmelding.
26
00:02:16,069 --> 00:02:19,880
Controleer na Save of de nieuwe tekst er echt staat.
27
00:02:20,680 --> 00:02:21,365
Deel B.
28
00:02:21,415 --> 00:02:28,300
Ga naar Studio, Create, Create from Blank, en kies de kaart Agent.
29
00:02:28,350 --> 00:02:28,826
Naam:
30
00:02:28,876 --> 00:02:31,032
Ouderbrief-assistent.
31
00:02:31,082 --> 00:02:34,024
Zet het model op gpt-5-mini.
32
00:02:34,824 --> 00:02:36,223
Plak de instructie.
33
00:02:36,273 --> 00:02:47,362
Een docent plakt een conceptbrief, de assistent maakt er een brief van die ouders in één keer begrijpen, en legt uit wat hij veranderde en waarom.
34
00:02:47,412 --> 00:02:49,498
De werkwijze in vijf punten:
35
00:02:49,548 --> 00:02:53,846
raadpleeg altijd eerst de schrijfwijzer in je kennisbank.
36
00:02:53,896 --> 00:02:59,568
Vraag eerst voor wie de brief is als dat niet duidelijk is, ga niet gokken.
37
00:02:59,618 --> 00:03:09,943
Geef eerst de herschreven brief met onderwerpregel, daarna onder het kopje Wat ik heb veranderd maximaal vijf punten met de regel erbij.
38
00:03:09,993 --> 00:03:16,275
Verzin geen data, namen of afspraken; ontbreekt iets, zet dan INVULLEN op die plek.
39
00:03:16,325 --> 00:03:19,784
En wees kort, geen inleiding, geen compliment.
40
00:03:19,834 --> 00:03:23,751
Punt drie bepaalt de vorm, en dat mag je veranderen.
41
00:03:23,801 --> 00:03:27,768
Punt vier houdt je uit de problemen; laat dat staan.
42
00:03:28,568 --> 00:03:33,807
Klik bij Knowledge op Add, vink Schoolgids Voorbeeldcollege aan.
43
00:03:33,857 --> 00:03:36,584
De kennisbank hangt aan de agent.
44
00:03:37,384 --> 00:03:40,156
Plak in Debug and Preview de testbrief:
45
00:03:40,206 --> 00:03:52,963
geachte ouders, middels dit schrijven willen wij u informeren omtrent de ouderavond die in het kader van de studiekeuze zal plaatsvinden, u wordt verzocht uw aanwezigheid z.s.m.
46
00:03:53,013 --> 00:03:53,976
door te geven.
47
00:03:54,026 --> 00:03:56,580
Alles wat de schrijfwijzer verbiedt.
48
00:03:56,630 --> 00:03:57,521
Het antwoord:
49
00:03:57,571 --> 00:04:04,684
een onderwerpregel, u-vorm, de eerste zin zegt waar het over gaat, en de verboden woorden zijn weg.
50
00:04:04,734 --> 00:04:11,608
Waar de conceptbrief iets niet zegt, een uiterste datum, een naam om te bellen, staat INVULLEN.
51
00:04:12,408 --> 00:04:13,099
Daaronder:
52
00:04:13,149 --> 00:04:17,919
Wat ik heb veranderd, met per punt de regel uit de schrijfwijzer.
53
00:04:17,969 --> 00:04:21,107
En boven het antwoord staat Used Knowledge:
54
00:04:21,157 --> 00:04:24,444
de agent heeft de schrijfwijzer echt gelezen.
55
00:04:24,494 --> 00:04:27,706
Krijg je een antwoord zonder Used Knowledge?
56
00:04:27,756 --> 00:04:30,820
Controleer dan de beschrijving uit stap 4.
57
00:04:30,870 --> 00:04:38,952
Een beschrijving die alleen over schoolregels gaat, zorgt dat de agent bij een schrijfvraag niet gaat zoeken.
58
00:04:39,752 --> 00:04:41,558
Publish, Publish Update.
59
00:04:41,608 --> 00:04:51,584
Zonder deze stap krijgt de webapp je instructie en kennisbank niet; een agent-app is bij het aanmaken al gepubliceerd, maar leeg.
60
00:04:52,384 --> 00:04:56,485
De derde wens van het team was een vraagbaak voor de receptie:
61
00:04:56,535 --> 00:05:02,560
een ouder mailt of belt, de baliemedewerker wil snel een correct antwoord in de huisstijl.
62
00:05:03,360 --> 00:05:03,824
Deel D.
63
00:05:03,874 --> 00:05:08,378
De derde wens van het team was een vraagbaak voor de receptie.
64
00:05:08,428 --> 00:05:14,547
Je zou de Schoolgids-assistent kunnen kopiëren met Duplicate, maar kijk naar Studio:
65
00:05:14,597 --> 00:05:17,632
met vijf apps zit een sandbox-account vol.
66
00:05:17,682 --> 00:05:21,010
Daarom doen we het anders, en eigenlijk beter.
67
00:05:21,060 --> 00:05:30,117
De Schoolgids-assistent heeft de schrijfwijzer al in zijn kennisbank; dat gebeurde in deel A zonder dat je de app aanraakte.
68
00:05:30,167 --> 00:05:35,088
Je hoeft hem alleen te vertellen wanneer hij als balie moet werken.
69
00:05:35,888 --> 00:05:40,632
Open de Schoolgids-assistent en plak onder de instructie een alinea:
70
00:05:40,682 --> 00:05:41,478
Balie-stand.
71
00:05:41,528 --> 00:05:58,749
Als een medewerker begint met Balie, dubbele punt, en daarna een vraag van een ouder plakt, schrijf dan het antwoord dat de medewerker naar die ouder kan sturen, volgens de schrijfwijzer, u-vorm, maximaal zes zinnen, met een contactmogelijkheid.
72
00:05:58,799 --> 00:06:05,144
Weet je het antwoord niet, schrijf dan een kort bericht dat je het navraagt, met INVULLEN.
73
00:06:05,944 --> 00:06:06,268
Plak:
74
00:06:06,318 --> 00:06:16,281
Balie, dubbele punt, hallo, mijn dochter zit in 1C en is morgen ziek, moet ik haar afmelden en krijgt ze de toets op een ander moment?
75
00:06:16,331 --> 00:06:27,041
Het antwoord haalt ziekmelding en inhaalmoment uit twee hoofdstukken van de schoolgids, spreekt de ouder aan met u, en sluit af met de receptie.
76
00:06:27,091 --> 00:06:33,990
Stel dezelfde vraag zonder Balie ervoor, en je krijgt het kortere antwoord uit handleiding 2.
77
00:06:34,040 --> 00:06:35,858
Eén app, twee gebruikers.
78
00:06:35,908 --> 00:06:41,163
Vergeet Publish Update niet; anders kent de webapp de Balie-stand niet.
79
00:06:41,213 --> 00:06:44,675
Het woord Balie is een afspraak, geen techniek:
80
00:06:44,725 --> 00:06:48,088
kies een woord dat jullie team logisch vindt.
81
00:06:48,888 --> 00:06:50,212
De controlelijst:
82
00:06:50,262 --> 00:06:55,871
twee documenten in de kennisbank met een beschrijving die beide noemt?
83
00:06:55,921 --> 00:07:00,318
Used Knowledge en INVULLEN bij de Ouderbrief-assistent?
84
00:07:00,368 --> 00:07:02,258
Een u-antwoord op Balie?
85
00:07:02,308 --> 00:07:04,248
En allebei gepubliceerd?
86
00:07:05,048 --> 00:07:14,332
De handleiding, de schrijfwijzer en de beelden staan in de repository; de apps staan live op udify punt app.
87
00:07:14,382 --> 00:07:17,184
In deel 2 bouwen we Schoolnieuws:
88
00:07:17,234 --> 00:07:19,777
één formulier, drie berichten.
89
00:07:19,827 --> 00:07:20,432
Tot zo.