dify-handleidingen/03-schoolcommunicatie/video-schoolcommunicatie.srt

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

2
00:00:05,213 --> 00:00:11,130
In handleiding 1 bouwde je een workflow, in handleiding 2 een agent met een kennisbank.

3
00:00:11,180 --> 00:00:14,423
Nu zet je die twee vormen in voor een echt team:

4
00:00:14,473 --> 00:00:20,047
de mensen die op school schrijven aan ouders, voor de website en voor de ouderapp.

5
00:00:20,097 --> 00:00:22,516
Drie apps voor Het Voorbeeldcollege:

6
00:00:22,566 --> 00:00:36,696
de Ouderbrief-assistent, die een conceptbrief herschrijft volgens de schrijfwijzer; Schoolnieuws, dat van één formulier drie berichten maakt; en de Balie-stand, een tweede gebruiker in de app die je al had.

7
00:00:37,496 --> 00:00:44,291
Je hebt handleiding 2 gedaan, dus de kennisbank Schoolgids Voorbeeldcollege staat op je account.

8
00:00:44,341 --> 00:00:46,715
Nu komt daar de schrijfwijzer bij:

9
00:00:46,765 --> 00:00:53,988
twee pagina's met regels over taalniveau, aanspreekvorm, te vermijden woorden en de lengte per kanaal.

10
00:00:54,038 --> 00:01:04,376
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.

11
00:01:05,176 --> 00:01:12,298
Open bij Knowledge de kennisbank Schoolgids Voorbeeldcollege en klik bij Documents op Add file.

12
00:01:12,348 --> 00:01:13,959
Kies de schrijfwijzer.

13
00:01:14,009 --> 00:01:20,200
In de sandbox kun je maar één bestand per keer uploaden; dat is geen fout van jou.

14
00:01:20,1000 --> 00:01:25,932
Dify onthoudt de instelling van het eerste document niet per se.

15
00:01:25,982 --> 00:01:31,770
Zet de delimiter opnieuw op twee keer backslash n en klik op Preview Chunk:

16
00:01:31,820 --> 00:01:35,273
een handvol stukken van een alinea of langer.

17
00:01:35,323 --> 00:01:39,010
Save and Process, en wacht op het groene vinkje.

18
00:01:39,060 --> 00:01:42,096
De kennisbank heeft nu twee documenten.

19
00:01:42,896 --> 00:01:49,369
Nu de beschrijving bijwerken, want de agent leest die om te beslissen of hij gaat zoeken.

20
00:01:49,419 --> 00:01:54,207
Nu er ook schrijfregels in staan, moet de beschrijving dat zeggen:

21
00:01:54,257 --> 00:02:05,494
twee documenten, schoolgids met de schoolregels, schrijfwijzer met hoe de school schrijft aan ouders, gebruik bij schoolregels en bij teksten voor ouders.

22
00:02:05,544 --> 00:02:06,007
Let op:

23
00:02:06,057 --> 00:02:09,305
de beschrijving mag maximaal 400 tekens zijn.

24
00:02:09,355 --> 00:02:14,363
Is hij langer, dan slaat Dify hem niet op en zie je geen foutmelding.

25
00:02:14,413 --> 00:02:18,224
Controleer na Save of de nieuwe tekst er echt staat.

26
00:02:19,024 --> 00:02:19,709
Deel B.

27
00:02:19,759 --> 00:02:26,644
Ga naar Studio, Create, Create from Blank, en kies de kaart Agent.

28
00:02:26,694 --> 00:02:27,170
Naam:

29
00:02:27,220 --> 00:02:29,376
Ouderbrief-assistent.

30
00:02:29,426 --> 00:02:32,368
Zet het model op gpt-5-mini.

31
00:02:33,168 --> 00:02:34,567
Plak de instructie.

32
00:02:34,617 --> 00:02:45,706
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.

33
00:02:45,756 --> 00:02:47,842
De werkwijze in vijf punten:

34
00:02:47,892 --> 00:02:52,190
raadpleeg altijd eerst de schrijfwijzer in je kennisbank.

35
00:02:52,240 --> 00:02:57,912
Vraag eerst voor wie de brief is als dat niet duidelijk is, ga niet gokken.

36
00:02:57,962 --> 00:03:08,287
Geef eerst de herschreven brief met onderwerpregel, daarna onder het kopje Wat ik heb veranderd maximaal vijf punten met de regel erbij.

37
00:03:08,337 --> 00:03:14,619
Verzin geen data, namen of afspraken; ontbreekt iets, zet dan INVULLEN op die plek.

38
00:03:14,669 --> 00:03:18,128
En wees kort, geen inleiding, geen compliment.

39
00:03:18,178 --> 00:03:22,095
Punt drie bepaalt de vorm, en dat mag je veranderen.

40
00:03:22,145 --> 00:03:26,112
Punt vier houdt je uit de problemen; laat dat staan.

41
00:03:26,912 --> 00:03:32,151
Klik bij Knowledge op Add, vink Schoolgids Voorbeeldcollege aan.

42
00:03:32,201 --> 00:03:34,928
De kennisbank hangt aan de agent.

43
00:03:35,728 --> 00:03:38,500
Plak in Debug and Preview de testbrief:

44
00:03:38,550 --> 00:03:51,307
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.

45
00:03:51,357 --> 00:03:52,320
door te geven.

46
00:03:52,370 --> 00:03:54,924
Alles wat de schrijfwijzer verbiedt.

47
00:03:54,974 --> 00:03:55,865
Het antwoord:

48
00:03:55,915 --> 00:04:03,028
een onderwerpregel, u-vorm, de eerste zin zegt waar het over gaat, en de verboden woorden zijn weg.

49
00:04:03,078 --> 00:04:09,952
Waar de conceptbrief iets niet zegt, een uiterste datum, een naam om te bellen, staat INVULLEN.

50
00:04:10,752 --> 00:04:11,443
Daaronder:

51
00:04:11,493 --> 00:04:16,263
Wat ik heb veranderd, met per punt de regel uit de schrijfwijzer.

52
00:04:16,313 --> 00:04:19,451
En boven het antwoord staat Used Knowledge:

53
00:04:19,501 --> 00:04:22,788
de agent heeft de schrijfwijzer echt gelezen.

54
00:04:22,838 --> 00:04:26,050
Krijg je een antwoord zonder Used Knowledge?

55
00:04:26,100 --> 00:04:29,164
Controleer dan de beschrijving uit stap 4.

56
00:04:29,214 --> 00:04:37,296
Een beschrijving die alleen over schoolregels gaat, zorgt dat de agent bij een schrijfvraag niet gaat zoeken.

57
00:04:38,096 --> 00:04:39,902
Publish, Publish Update.

58
00:04:39,952 --> 00:04:49,928
Zonder deze stap krijgt de webapp je instructie en kennisbank niet; een agent-app is bij het aanmaken al gepubliceerd, maar leeg.

59
00:04:50,728 --> 00:04:51,279
Deel C:

60
00:04:51,329 --> 00:04:52,394
Schoolnieuws.

61
00:04:52,444 --> 00:04:55,911
Eén bericht komt bijna nooit op één plek.

62
00:04:55,961 --> 00:05:06,807
De website wil 200 woorden met een kop, de ouderapp 80 woorden op een telefoonscherm, sociale media 60 woorden met een hashtag.

63
00:05:06,857 --> 00:05:11,869
In plaats van drie keer schrijven, vul je één formulier in.

64
00:05:11,919 --> 00:05:14,786
Zo ziet de workflow er straks uit:

65
00:05:14,836 --> 00:05:19,984
User Input, Knowledge Retrieval, drie LLM-stappen en Output.

66
00:05:20,784 --> 00:05:27,557
Maak een nieuwe Workflow met de naam Schoolnieuws en geef User Input drie velden.

67
00:05:27,607 --> 00:05:30,000
Kernboodschap, een Paragraph:

68
00:05:30,050 --> 00:05:33,622
wat is er gebeurd, wie, wat, waar, wanneer.

69
00:05:33,672 --> 00:05:35,728
Afdeling, een Short Text:

70
00:05:35,778 --> 00:05:38,087
voor welke klas of afdeling.

71
00:05:38,137 --> 00:05:41,120
En toon, een Select met drie opties:

72
00:05:41,170 --> 00:05:43,984
informatief, feestelijk, dringend.

73
00:05:44,034 --> 00:05:47,690
Kies het Field Type vóór je begint te typen.

74
00:05:47,740 --> 00:05:54,816
Verander je het type achteraf, dan sluit het venster soms en ben je je invoer kwijt.

75
00:05:55,616 --> 00:06:00,106
Klik op het plusje achter User Input en kies Knowledge Retrieval.

76
00:06:00,156 --> 00:06:04,856
Als zoekvraag kies je de kernboodschap, en je koppelt de kennisbank.

77
00:06:04,906 --> 00:06:12,190
Dat de zoekvraag de kernboodschap is en niet het woord schrijfwijzer, werkt omdat de kennisbank klein is:

78
00:06:12,240 --> 00:06:15,104
de schrijfwijzer komt vrijwel altijd mee.

79
00:06:15,904 --> 00:06:23,680
Nu drie LLM-blokken achter elkaar, elk met hetzelfde model en dezelfde context, maar een eigen prompt.

80
00:06:23,730 --> 00:06:24,217
Blok 1:

81
00:06:24,267 --> 00:06:29,205
model gpt-5-mini, bij Context kies je Knowledge Retrieval result.

82
00:06:29,255 --> 00:06:30,279
Dan de prompt:

83
00:06:30,329 --> 00:06:46,929
begin je antwoord met de regel WEBSITE, schrijf een nieuwsbericht van maximaal 200 woorden, een actieve kop van acht woorden, wie wat waar wanneer in de eerste alinea, houd je aan de schrijfwijzer, verzin geen feiten.

84
00:06:46,979 --> 00:06:50,228
Onder de prompt vier regels met variabelen:

85
00:06:50,278 --> 00:06:53,681
schrijfwijzer, afdeling, toon, kernboodschap.

86
00:06:53,731 --> 00:06:58,668
Elke keer een schuine streep, en Context staat onderaan het menu.

87
00:06:58,718 --> 00:06:59,205
Let op:

88
00:06:59,255 --> 00:07:05,574
de context werkt alleen als je hem ook echt in de prompt zet via de schuine streep.

89
00:07:05,624 --> 00:07:11,992
Alleen het veld Context vullen is niet genoeg; Dify waarschuwt daar in oranje voor.

90
00:07:12,792 --> 00:07:18,179
Klik op de naam LLM bovenin het paneel en hernoem het blok naar Website.

91
00:07:18,229 --> 00:07:21,552
Dat houdt de drie blokken straks uit elkaar.

92
00:07:22,352 --> 00:07:27,144
Blok 2 op dezelfde manier, met de prompt voor de ouderapp:

93
00:07:27,194 --> 00:07:34,240
maximaal 80 woorden, één boodschap, één datum, één actie, geen inleiding en geen kop.

94
00:07:34,290 --> 00:07:36,077
Hernoem naar Ouderapp.

95
00:07:36,127 --> 00:07:37,663
Blok 3 voor Social:

96
00:07:37,713 --> 00:07:49,100
maximaal 60 woorden, warm en concreet, geen jubeltaal, maximaal drie hashtags waarvan altijd Voorbeeldcollege, geen namen van leerlingen.

97
00:07:49,150 --> 00:07:50,770
Hernoem naar Social.

98
00:07:50,820 --> 00:07:55,361
De drie prompts verschillen alleen in de eerste alinea.

99
00:07:55,411 --> 00:07:58,700
Dat is de plek voor jullie kanaalregels:

100
00:07:58,750 --> 00:08:01,706
geen Instagram maar een nieuwsbrief?

101
00:08:01,756 --> 00:08:03,008
Vervang blok 3.

102
00:08:03,808 --> 00:08:04,908
Achter Social:

103
00:08:04,958 --> 00:08:07,784
Output, met drie uitvoervariabelen:

104
00:08:07,834 --> 00:08:14,488
website, ouderapp en social, elk gekoppeld aan de text van het bijbehorende blok.

105
00:08:15,288 --> 00:08:15,981
Test Run.

106
00:08:16,031 --> 00:08:17,963
Vul de kernboodschap in:

107
00:08:18,013 --> 00:08:28,369
op donderdag 8 oktober om half acht is er een ouderavond voor klas 2 in de aula, aanmelden tot 5 oktober via het ouderportaal.

108
00:08:28,419 --> 00:08:31,177
Afdeling klas 2, toon informatief.

109
00:08:31,227 --> 00:08:32,003
Start Run.

110
00:08:32,053 --> 00:08:41,418
De blokken kleuren een voor een groen, en rechts komen de drie teksten, met de labels WEBSITE, OUDERAPP en SOCIAL.

111
00:08:41,468 --> 00:08:42,327
Controleer:

112
00:08:42,377 --> 00:08:54,219
het websitebericht heeft een kop en sluit af met contact, het ouderappbericht is één alinea zonder kop, het socialbericht eindigt op de hashtag.

113
00:08:54,269 --> 00:08:59,472
En het contactnummer komt uit de schoolgids, niet uit de lucht.

114
00:09:00,272 --> 00:09:04,260
Publish, en dan in het linkermenu Toegangspunt:

115
00:09:04,310 --> 00:09:06,494
daar staat de webapp-link.

116
00:09:06,544 --> 00:09:09,672
Formulier links, drie teksten rechts.

117
00:09:09,722 --> 00:09:12,128
Dat is wat een collega ziet.

118
00:09:12,928 --> 00:09:13,392
Deel D.

119
00:09:13,442 --> 00:09:17,946
De derde wens van het team was een vraagbaak voor de receptie.

120
00:09:17,996 --> 00:09:24,115
Je zou de Schoolgids-assistent kunnen kopiëren met Duplicate, maar kijk naar Studio:

121
00:09:24,165 --> 00:09:27,200
met vijf apps zit een sandbox-account vol.

122
00:09:27,250 --> 00:09:30,578
Daarom doen we het anders, en eigenlijk beter.

123
00:09:30,628 --> 00:09:39,685
De Schoolgids-assistent heeft de schrijfwijzer al in zijn kennisbank; dat gebeurde in deel A zonder dat je de app aanraakte.

124
00:09:39,735 --> 00:09:44,656
Je hoeft hem alleen te vertellen wanneer hij als balie moet werken.

125
00:09:45,456 --> 00:09:50,200
Open de Schoolgids-assistent en plak onder de instructie een alinea:

126
00:09:50,250 --> 00:09:51,046
Balie-stand.

127
00:09:51,096 --> 00:10:08,317
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.

128
00:10:08,367 --> 00:10:14,712
Weet je het antwoord niet, schrijf dan een kort bericht dat je het navraagt, met INVULLEN.

129
00:10:15,512 --> 00:10:15,836
Plak:

130
00:10:15,886 --> 00:10:25,849
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?

131
00:10:25,899 --> 00:10:36,609
Het antwoord haalt ziekmelding en inhaalmoment uit twee hoofdstukken van de schoolgids, spreekt de ouder aan met u, en sluit af met de receptie.

132
00:10:36,659 --> 00:10:43,558
Stel dezelfde vraag zonder Balie ervoor, en je krijgt het kortere antwoord uit handleiding 2.

133
00:10:43,608 --> 00:10:45,426
Eén app, twee gebruikers.

134
00:10:45,476 --> 00:10:50,731
Vergeet Publish Update niet; anders kent de webapp de Balie-stand niet.

135
00:10:50,781 --> 00:10:54,243
Het woord Balie is een afspraak, geen techniek:

136
00:10:54,293 --> 00:10:57,656
kies een woord dat jullie team logisch vindt.

137
00:10:58,456 --> 00:10:59,796
De controlelijst:

138
00:10:59,846 --> 00:11:05,518
twee documenten in de kennisbank met een beschrijving die beide noemt?

139
00:11:05,568 --> 00:11:10,014
Used Knowledge en INVULLEN bij de Ouderbrief-assistent?

140
00:11:10,064 --> 00:11:13,366
Drie teksten met labels uit Schoolnieuws?

141
00:11:13,416 --> 00:11:15,982
Contactnummer uit de schoolgids?

142
00:11:16,032 --> 00:11:17,944
Een u-antwoord op Balie?

143
00:11:17,994 --> 00:11:19,792
En alles gepubliceerd?

144
00:11:20,592 --> 00:11:28,789
De handleiding, de schrijfwijzer en de beelden staan in de repository; de apps staan live op udify punt app.

145
00:11:28,839 --> 00:11:33,218
In de volgende video gaan we naar de nieuwe Agent Console:

146
00:11:33,268 --> 00:11:40,091
de Toetsweekplanner, met een bestand, een tool en een sandbox die een Excel-bestand maakt.

147
00:11:40,141 --> 00:11:40,752
Tot dan.