diff --git a/03-schoolcommunicatie/video-schoolcommunicatie.mp4 b/03-schoolcommunicatie/video-schoolcommunicatie-1.mp4 similarity index 52% rename from 03-schoolcommunicatie/video-schoolcommunicatie.mp4 rename to 03-schoolcommunicatie/video-schoolcommunicatie-1.mp4 index ab10dfa..006a11f 100644 Binary files a/03-schoolcommunicatie/video-schoolcommunicatie.mp4 and b/03-schoolcommunicatie/video-schoolcommunicatie-1.mp4 differ diff --git a/03-schoolcommunicatie/video-schoolcommunicatie-1.srt b/03-schoolcommunicatie/video-schoolcommunicatie-1.srt new file mode 100644 index 0000000..fb97eea --- /dev/null +++ b/03-schoolcommunicatie/video-schoolcommunicatie-1.srt @@ -0,0 +1,356 @@ +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. + diff --git a/03-schoolcommunicatie/video-schoolcommunicatie-2.mp4 b/03-schoolcommunicatie/video-schoolcommunicatie-2.mp4 new file mode 100644 index 0000000..700dc28 Binary files /dev/null and b/03-schoolcommunicatie/video-schoolcommunicatie-2.mp4 differ diff --git a/03-schoolcommunicatie/video-schoolcommunicatie-2.srt b/03-schoolcommunicatie/video-schoolcommunicatie-2.srt new file mode 100644 index 0000000..967d706 --- /dev/null +++ b/03-schoolcommunicatie/video-schoolcommunicatie-2.srt @@ -0,0 +1,304 @@ +1 +00:00:00,000 --> 00:00:06,048 +Welkom bij handleiding 3 van de reeks AI Agents met Dify voor school, deel 2 van 2. + +2 +00:00:06,098 --> 00:00:12,660 +In deel 1 zette je de schrijfwijzer in de kennisbank en bouwde je de Ouderbrief-assistent. + +3 +00:00:12,710 --> 00:00:14,423 +Nu bouw je Schoolnieuws: + +4 +00:00:14,473 --> 00:00:24,782 +een workflow die van één formulier drie berichten maakt, voor de website, de ouderapp en sociale media, elk volgens de regels van dat kanaal. + +5 +00:00:24,832 --> 00:00:26,325 +Je hebt deel 1 nodig: + +6 +00:00:26,375 --> 00:00:31,224 +de kennisbank met de schrijfwijzer en de bijgewerkte beschrijving. + +7 +00:00:32,024 --> 00:00:32,575 +Deel C: + +8 +00:00:32,625 --> 00:00:33,690 +Schoolnieuws. + +9 +00:00:33,740 --> 00:00:37,207 +Eén bericht komt bijna nooit op één plek. + +10 +00:00:37,257 --> 00:00:48,103 +De website wil 200 woorden met een kop, de ouderapp 80 woorden op een telefoonscherm, sociale media 60 woorden met een hashtag. + +11 +00:00:48,153 --> 00:00:53,165 +In plaats van drie keer schrijven, vul je één formulier in. + +12 +00:00:53,215 --> 00:00:56,082 +Zo ziet de workflow er straks uit: + +13 +00:00:56,132 --> 00:01:01,280 +User Input, Knowledge Retrieval, drie LLM-stappen en Output. + +14 +00:01:02,080 --> 00:01:08,853 +Maak een nieuwe Workflow met de naam Schoolnieuws en geef User Input drie velden. + +15 +00:01:08,903 --> 00:01:11,296 +Kernboodschap, een Paragraph: + +16 +00:01:11,346 --> 00:01:14,918 +wat is er gebeurd, wie, wat, waar, wanneer. + +17 +00:01:14,968 --> 00:01:17,024 +Afdeling, een Short Text: + +18 +00:01:17,074 --> 00:01:19,383 +voor welke klas of afdeling. + +19 +00:01:19,433 --> 00:01:22,416 +En toon, een Select met drie opties: + +20 +00:01:22,466 --> 00:01:25,280 +informatief, feestelijk, dringend. + +21 +00:01:25,330 --> 00:01:28,986 +Kies het Field Type vóór je begint te typen. + +22 +00:01:29,036 --> 00:01:36,112 +Verander je het type achteraf, dan sluit het venster soms en ben je je invoer kwijt. + +23 +00:01:36,912 --> 00:01:41,402 +Klik op het plusje achter User Input en kies Knowledge Retrieval. + +24 +00:01:41,452 --> 00:01:46,152 +Als zoekvraag kies je de kernboodschap, en je koppelt de kennisbank. + +25 +00:01:46,202 --> 00:01:53,486 +Dat de zoekvraag de kernboodschap is en niet het woord schrijfwijzer, werkt omdat de kennisbank klein is: + +26 +00:01:53,536 --> 00:01:56,400 +de schrijfwijzer komt vrijwel altijd mee. + +27 +00:01:57,200 --> 00:02:04,976 +Nu drie LLM-blokken achter elkaar, elk met hetzelfde model en dezelfde context, maar een eigen prompt. + +28 +00:02:05,026 --> 00:02:05,513 +Blok 1: + +29 +00:02:05,563 --> 00:02:10,501 +model gpt-5-mini, bij Context kies je Knowledge Retrieval result. + +30 +00:02:10,551 --> 00:02:11,575 +Dan de prompt: + +31 +00:02:11,625 --> 00:02:28,225 +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. + +32 +00:02:28,275 --> 00:02:31,524 +Onder de prompt vier regels met variabelen: + +33 +00:02:31,574 --> 00:02:34,977 +schrijfwijzer, afdeling, toon, kernboodschap. + +34 +00:02:35,027 --> 00:02:39,964 +Elke keer een schuine streep, en Context staat onderaan het menu. + +35 +00:02:40,014 --> 00:02:40,501 +Let op: + +36 +00:02:40,551 --> 00:02:46,870 +de context werkt alleen als je hem ook echt in de prompt zet via de schuine streep. + +37 +00:02:46,920 --> 00:02:53,288 +Alleen het veld Context vullen is niet genoeg; Dify waarschuwt daar in oranje voor. + +38 +00:02:54,088 --> 00:02:59,475 +Klik op de naam LLM bovenin het paneel en hernoem het blok naar Website. + +39 +00:02:59,525 --> 00:03:02,848 +Dat houdt de drie blokken straks uit elkaar. + +40 +00:03:03,648 --> 00:03:08,440 +Blok 2 op dezelfde manier, met de prompt voor de ouderapp: + +41 +00:03:08,490 --> 00:03:15,536 +maximaal 80 woorden, één boodschap, één datum, één actie, geen inleiding en geen kop. + +42 +00:03:15,586 --> 00:03:17,373 +Hernoem naar Ouderapp. + +43 +00:03:17,423 --> 00:03:18,959 +Blok 3 voor Social: + +44 +00:03:19,009 --> 00:03:30,396 +maximaal 60 woorden, warm en concreet, geen jubeltaal, maximaal drie hashtags waarvan altijd Voorbeeldcollege, geen namen van leerlingen. + +45 +00:03:30,446 --> 00:03:32,066 +Hernoem naar Social. + +46 +00:03:32,116 --> 00:03:36,657 +De drie prompts verschillen alleen in de eerste alinea. + +47 +00:03:36,707 --> 00:03:39,996 +Dat is de plek voor jullie kanaalregels: + +48 +00:03:40,046 --> 00:03:43,002 +geen Instagram maar een nieuwsbrief? + +49 +00:03:43,052 --> 00:03:44,304 +Vervang blok 3. + +50 +00:03:45,104 --> 00:03:46,204 +Achter Social: + +51 +00:03:46,254 --> 00:03:49,080 +Output, met drie uitvoervariabelen: + +52 +00:03:49,130 --> 00:03:55,784 +website, ouderapp en social, elk gekoppeld aan de text van het bijbehorende blok. + +53 +00:03:56,584 --> 00:03:57,277 +Test Run. + +54 +00:03:57,327 --> 00:03:59,259 +Vul de kernboodschap in: + +55 +00:03:59,309 --> 00:04:09,665 +op donderdag 8 oktober om half acht is er een ouderavond voor klas 2 in de aula, aanmelden tot 5 oktober via het ouderportaal. + +56 +00:04:09,715 --> 00:04:12,473 +Afdeling klas 2, toon informatief. + +57 +00:04:12,523 --> 00:04:13,299 +Start Run. + +58 +00:04:13,349 --> 00:04:22,714 +De blokken kleuren een voor een groen, en rechts komen de drie teksten, met de labels WEBSITE, OUDERAPP en SOCIAL. + +59 +00:04:22,764 --> 00:04:23,623 +Controleer: + +60 +00:04:23,673 --> 00:04:35,515 +het websitebericht heeft een kop en sluit af met contact, het ouderappbericht is één alinea zonder kop, het socialbericht eindigt op de hashtag. + +61 +00:04:35,565 --> 00:04:40,768 +En het contactnummer komt uit de schoolgids, niet uit de lucht. + +62 +00:04:41,568 --> 00:04:45,556 +Publish, en dan in het linkermenu Toegangspunt: + +63 +00:04:45,606 --> 00:04:47,790 +daar staat de webapp-link. + +64 +00:04:47,840 --> 00:04:50,968 +Formulier links, drie teksten rechts. + +65 +00:04:51,018 --> 00:04:53,424 +Dat is wat een collega ziet. + +66 +00:04:54,224 --> 00:04:55,818 +De controlelijst: + +67 +00:04:55,868 --> 00:04:56,978 +drie velden? + +68 +00:04:57,028 --> 00:04:59,878 +Knowledge Retrieval gekoppeld? + +69 +00:04:59,928 --> 00:05:04,325 +Drie blokken met de context echt in de prompt? + +70 +00:05:04,375 --> 00:05:06,645 +Drie teksten met labels? + +71 +00:05:06,695 --> 00:05:09,739 +Contactnummer uit de schoolgids? + +72 +00:05:09,789 --> 00:05:11,336 +En gepubliceerd? + +73 +00:05:12,136 --> 00:05:19,843 +De handleiding, de prompts en de beelden staan in de repository; de app staat live op udify punt app. + +74 +00:05:19,893 --> 00:05:23,760 +In de volgende video gaan we naar de Agent Console: + +75 +00:05:23,810 --> 00:05:30,672 +de Toetsweekplanner, met een bestand, een tool en een sandbox die een Excel-bestand maakt. + +76 +00:05:30,722 --> 00:05:31,336 +Tot dan. + diff --git a/03-schoolcommunicatie/video-schoolcommunicatie.srt b/03-schoolcommunicatie/video-schoolcommunicatie.srt deleted file mode 100644 index 330c3a4..0000000 --- a/03-schoolcommunicatie/video-schoolcommunicatie.srt +++ /dev/null @@ -1,588 +0,0 @@ -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. - diff --git a/03-schoolcommunicatie/video-script.md b/03-schoolcommunicatie/video-script-1.md similarity index 55% rename from 03-schoolcommunicatie/video-script.md rename to 03-schoolcommunicatie/video-script-1.md index 0ed63ff..cea20a8 100644 --- a/03-schoolcommunicatie/video-script.md +++ b/03-schoolcommunicatie/video-script-1.md @@ -1,15 +1,15 @@ -# titel: Dify voor schoolcommunicatie -# ondertitel: Handleiding 3 · Ouderbrief-assistent, Schoolnieuws en de Balie-stand +# titel: Schoolcommunicatie, deel 1 +# ondertitel: Handleiding 3 · schrijfwijzer, Ouderbrief-assistent en Balie-stand # stem: nl-NL-FennaNeural # tempo: -5% -# uitvoer: video-schoolcommunicatie +# uitvoer: video-schoolcommunicatie-1 # reeks: Reeks AI Agents met Dify voor school # bron: git.lexconsultancy.nl/guido/dify-handleidingen [titel] -Welkom bij de derde handleiding van de reeks AI Agents met Dify voor school. In handleiding 1 bouwde je een workflow, in handleiding 2 een agent met een kennisbank. Nu zet je die twee vormen in voor een echt team: de mensen die op school schrijven aan ouders, voor de website en voor de ouderapp. +Welkom bij de derde handleiding van de reeks AI Agents met Dify voor school, deel 1 van 2. In handleiding 1 bouwde je een workflow, in handleiding 2 een agent met een kennisbank. Nu zet je die twee vormen in voor een echt team: de mensen die op school schrijven aan ouders. -Drie apps voor Het Voorbeeldcollege: 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. +In dit deel: 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. Schoolnieuws, de workflow die van één formulier drie berichten maakt, komt in deel 2. [kaart: Voorbereiding | Handleiding 2 gedaan: de kennisbank en de Schoolgids-assistent staan op je account | De schrijfwijzer van Het Voorbeeldcollege, twee pagina's, zit bij de handleiding | Model op gpt-5-mini | Vier delen: A schrijfwijzer in de kennisbank, B Ouderbrief-assistent, C Schoolnieuws, D Balie-stand] Je hebt handleiding 2 gedaan, dus de kennisbank Schoolgids Voorbeeldcollege staat op je account. Nu komt daar de schrijfwijzer bij: twee pagina's met regels over taalniveau, aanspreekvorm, te vermijden woorden en de lengte per kanaal. 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. @@ -51,44 +51,8 @@ Krijg je een antwoord zonder Used Knowledge? Controleer dan de beschrijving uit [beeld: b09-publish2.jpg | Deel B, stap 9. Publiceren] Publish, Publish Update. Zonder deze stap krijgt de webapp je instructie en kennisbank niet; een agent-app is bij het aanmaken al gepubliceerd, maar leeg. -[beeld: c17-hele-flow.jpg | Deel C. Schoolnieuws] -Deel C: Schoolnieuws. Eén bericht komt bijna nooit op één plek. De website wil 200 woorden met een kop, de ouderapp 80 woorden op een telefoonscherm, sociale media 60 woorden met een hashtag. In plaats van drie keer schrijven, vul je één formulier in. - -Zo ziet de workflow er straks uit: User Input, Knowledge Retrieval, drie LLM-stappen en Output. - -[beeld: c04-drie-velden.jpg | Deel C, stap 11. Drie invoervelden] -Maak een nieuwe Workflow met de naam Schoolnieuws en geef User Input drie velden. Kernboodschap, een Paragraph: wat is er gebeurd, wie, wat, waar, wanneer. Afdeling, een Short Text: voor welke klas of afdeling. En toon, een Select met drie opties: informatief, feestelijk, dringend. - -Kies het Field Type vóór je begint te typen. Verander je het type achteraf, dan sluit het venster soms en ben je je invoer kwijt. - -[beeld: c07-kr3.jpg | Deel C, stap 12. Knowledge Retrieval] -Klik op het plusje achter User Input en kies Knowledge Retrieval. Als zoekvraag kies je de kernboodschap, en je koppelt de kennisbank. Dat de zoekvraag de kernboodschap is en niet het woord schrijfwijzer, werkt omdat de kennisbank klein is: de schrijfwijzer komt vrijwel altijd mee. - -[beeld: c09-website2.jpg | Deel C, stap 13. Het eerste LLM-blok] -Nu drie LLM-blokken achter elkaar, elk met hetzelfde model en dezelfde context, maar een eigen prompt. Blok 1: model gpt-5-mini, bij Context kies je Knowledge Retrieval result. Dan de prompt: 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. - -Onder de prompt vier regels met variabelen: schrijfwijzer, afdeling, toon, kernboodschap. Elke keer een schuine streep, en Context staat onderaan het menu. - -Let op: de context werkt alleen als je hem ook echt in de prompt zet via de schuine streep. Alleen het veld Context vullen is niet genoeg; Dify waarschuwt daar in oranje voor. - -[beeld: c10-website3.jpg | Deel C, stap 13. Hernoemen] -Klik op de naam LLM bovenin het paneel en hernoem het blok naar Website. Dat houdt de drie blokken straks uit elkaar. - -[beeld: c13-ouderapp-klaar.jpg | Deel C, stap 13. Ouderapp en Social] -Blok 2 op dezelfde manier, met de prompt voor de ouderapp: maximaal 80 woorden, één boodschap, één datum, één actie, geen inleiding en geen kop. Hernoem naar Ouderapp. Blok 3 voor Social: maximaal 60 woorden, warm en concreet, geen jubeltaal, maximaal drie hashtags waarvan altijd Voorbeeldcollege, geen namen van leerlingen. Hernoem naar Social. - -De drie prompts verschillen alleen in de eerste alinea. Dat is de plek voor jullie kanaalregels: geen Instagram maar een nieuwsbrief? Vervang blok 3. - -[beeld: c16-output.jpg | Deel C, stap 14. Output] -Achter Social: Output, met drie uitvoervariabelen: website, ouderapp en social, elk gekoppeld aan de text van het bijbehorende blok. - -[beeld: c20-testrun-social.jpg | Deel C, stap 15. Test Run] -Test Run. Vul de kernboodschap in: op donderdag 8 oktober om half acht is er een ouderavond voor klas 2 in de aula, aanmelden tot 5 oktober via het ouderportaal. Afdeling klas 2, toon informatief. Start Run. - -De blokken kleuren een voor een groen, en rechts komen de drie teksten, met de labels WEBSITE, OUDERAPP en SOCIAL. Controleer: het websitebericht heeft een kop en sluit af met contact, het ouderappbericht is één alinea zonder kop, het socialbericht eindigt op de hashtag. En het contactnummer komt uit de schoolgids, niet uit de lucht. - -[beeld: c23-webapp.jpg | Deel C, stap 16. De webapp] -Publish, en dan in het linkermenu Toegangspunt: daar staat de webapp-link. Formulier links, drie teksten rechts. Dat is wat een collega ziet. +[kaart: Deel D. De Balie-stand | De derde wens van het team: een vraagbaak voor de receptie | Kopiëren met Duplicate kan, maar met vijf apps zit de sandbox vol | De Schoolgids-assistent heeft de schrijfwijzer al in zijn kennisbank | Eén app, twee gebruikers, met een schakelwoord] +De derde wens van het team was een vraagbaak voor de receptie: een ouder mailt of belt, de baliemedewerker wil snel een correct antwoord in de huisstijl. [beeld: d01-studio-vijf-apps.jpg | Deel D. Vijf apps: de sandbox is vol] Deel D. De derde wens van het team was een vraagbaak voor de receptie. Je zou de Schoolgids-assistent kunnen kopiëren met Duplicate, maar kijk naar Studio: met vijf apps zit een sandbox-account vol. @@ -105,8 +69,8 @@ Het antwoord haalt ziekmelding en inhaalmoment uit twee hoofdstukken van de scho Vergeet Publish Update niet; anders kent de webapp de Balie-stand niet. Het woord Balie is een afspraak, geen techniek: kies een woord dat jullie team logisch vindt. -[kaart: Controleren of het gelukt is | De kennisbank heeft twee documenten en een beschrijving die beide noemt | De Ouderbrief-assistent antwoordt met Used Knowledge en INVULLEN waar iets ontbreekt | Schoolnieuws geeft drie teksten met de labels WEBSITE, OUDERAPP en SOCIAL | Het contactnummer komt uit de schoolgids | Balie, dubbele punt, geeft een antwoord in u-vorm met hoofdstukverwijzing | Alle drie de apps zijn gepubliceerd met Publish Update] -De controlelijst: twee documenten in de kennisbank met een beschrijving die beide noemt? Used Knowledge en INVULLEN bij de Ouderbrief-assistent? Drie teksten met labels uit Schoolnieuws? Contactnummer uit de schoolgids? Een u-antwoord op Balie? En alles gepubliceerd? +[kaart: Controleren of het gelukt is | De kennisbank heeft twee documenten en een beschrijving die beide noemt | De Ouderbrief-assistent antwoordt met Used Knowledge en INVULLEN waar iets ontbreekt | Balie, dubbele punt, geeft een antwoord in u-vorm met hoofdstukverwijzing | Beide apps zijn gepubliceerd met Publish Update] +De controlelijst: twee documenten in de kennisbank met een beschrijving die beide noemt? Used Knowledge en INVULLEN bij de Ouderbrief-assistent? Een u-antwoord op Balie? En allebei gepubliceerd? -[slot: Drie apps, één kennisbank, één team.] -De handleiding, de schrijfwijzer en de beelden staan in de repository; de apps staan live op udify punt app. In de volgende video gaan we naar de nieuwe Agent Console: de Toetsweekplanner, met een bestand, een tool en een sandbox die een Excel-bestand maakt. Tot dan. +[slot: Eén kennisbank, twee apps, één team.] +De handleiding, de schrijfwijzer en de beelden staan in de repository; de apps staan live op udify punt app. In deel 2 bouwen we Schoolnieuws: één formulier, drie berichten. Tot zo. diff --git a/03-schoolcommunicatie/video-script-2.md b/03-schoolcommunicatie/video-script-2.md new file mode 100644 index 0000000..2944aba --- /dev/null +++ b/03-schoolcommunicatie/video-script-2.md @@ -0,0 +1,57 @@ +# titel: Schoolnieuws +# ondertitel: Handleiding 3, deel 2 · een workflow die van één formulier drie berichten maakt +# stem: nl-NL-FennaNeural +# tempo: -5% +# uitvoer: video-schoolcommunicatie-2 +# reeks: Reeks AI Agents met Dify voor school +# bron: git.lexconsultancy.nl/guido/dify-handleidingen + +[titel] +Welkom bij handleiding 3 van de reeks AI Agents met Dify voor school, deel 2 van 2. In deel 1 zette je de schrijfwijzer in de kennisbank en bouwde je de Ouderbrief-assistent. Nu bouw je Schoolnieuws: een workflow die van één formulier drie berichten maakt, voor de website, de ouderapp en sociale media, elk volgens de regels van dat kanaal. + +Je hebt deel 1 nodig: de kennisbank met de schrijfwijzer en de bijgewerkte beschrijving. + +[beeld: c17-hele-flow.jpg | Deel C. Schoolnieuws] +Deel C: Schoolnieuws. Eén bericht komt bijna nooit op één plek. De website wil 200 woorden met een kop, de ouderapp 80 woorden op een telefoonscherm, sociale media 60 woorden met een hashtag. In plaats van drie keer schrijven, vul je één formulier in. + +Zo ziet de workflow er straks uit: User Input, Knowledge Retrieval, drie LLM-stappen en Output. + +[beeld: c04-drie-velden.jpg | Deel C, stap 11. Drie invoervelden] +Maak een nieuwe Workflow met de naam Schoolnieuws en geef User Input drie velden. Kernboodschap, een Paragraph: wat is er gebeurd, wie, wat, waar, wanneer. Afdeling, een Short Text: voor welke klas of afdeling. En toon, een Select met drie opties: informatief, feestelijk, dringend. + +Kies het Field Type vóór je begint te typen. Verander je het type achteraf, dan sluit het venster soms en ben je je invoer kwijt. + +[beeld: c07-kr3.jpg | Deel C, stap 12. Knowledge Retrieval] +Klik op het plusje achter User Input en kies Knowledge Retrieval. Als zoekvraag kies je de kernboodschap, en je koppelt de kennisbank. Dat de zoekvraag de kernboodschap is en niet het woord schrijfwijzer, werkt omdat de kennisbank klein is: de schrijfwijzer komt vrijwel altijd mee. + +[beeld: c09-website2.jpg | Deel C, stap 13. Het eerste LLM-blok] +Nu drie LLM-blokken achter elkaar, elk met hetzelfde model en dezelfde context, maar een eigen prompt. Blok 1: model gpt-5-mini, bij Context kies je Knowledge Retrieval result. Dan de prompt: 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. + +Onder de prompt vier regels met variabelen: schrijfwijzer, afdeling, toon, kernboodschap. Elke keer een schuine streep, en Context staat onderaan het menu. + +Let op: de context werkt alleen als je hem ook echt in de prompt zet via de schuine streep. Alleen het veld Context vullen is niet genoeg; Dify waarschuwt daar in oranje voor. + +[beeld: c10-website3.jpg | Deel C, stap 13. Hernoemen] +Klik op de naam LLM bovenin het paneel en hernoem het blok naar Website. Dat houdt de drie blokken straks uit elkaar. + +[beeld: c13-ouderapp-klaar.jpg | Deel C, stap 13. Ouderapp en Social] +Blok 2 op dezelfde manier, met de prompt voor de ouderapp: maximaal 80 woorden, één boodschap, één datum, één actie, geen inleiding en geen kop. Hernoem naar Ouderapp. Blok 3 voor Social: maximaal 60 woorden, warm en concreet, geen jubeltaal, maximaal drie hashtags waarvan altijd Voorbeeldcollege, geen namen van leerlingen. Hernoem naar Social. + +De drie prompts verschillen alleen in de eerste alinea. Dat is de plek voor jullie kanaalregels: geen Instagram maar een nieuwsbrief? Vervang blok 3. + +[beeld: c16-output.jpg | Deel C, stap 14. Output] +Achter Social: Output, met drie uitvoervariabelen: website, ouderapp en social, elk gekoppeld aan de text van het bijbehorende blok. + +[beeld: c20-testrun-social.jpg | Deel C, stap 15. Test Run] +Test Run. Vul de kernboodschap in: op donderdag 8 oktober om half acht is er een ouderavond voor klas 2 in de aula, aanmelden tot 5 oktober via het ouderportaal. Afdeling klas 2, toon informatief. Start Run. + +De blokken kleuren een voor een groen, en rechts komen de drie teksten, met de labels WEBSITE, OUDERAPP en SOCIAL. Controleer: het websitebericht heeft een kop en sluit af met contact, het ouderappbericht is één alinea zonder kop, het socialbericht eindigt op de hashtag. En het contactnummer komt uit de schoolgids, niet uit de lucht. + +[beeld: c23-webapp.jpg | Deel C, stap 16. De webapp] +Publish, en dan in het linkermenu Toegangspunt: daar staat de webapp-link. Formulier links, drie teksten rechts. Dat is wat een collega ziet. + +[kaart: Controleren of het gelukt is | Drie invoervelden: kernboodschap, afdeling en toon | Knowledge Retrieval met de kernboodschap als zoekvraag | Drie LLM-blokken met de context in de prompt, hernoemd naar Website, Ouderapp en Social | Test Run geeft drie teksten met de labels WEBSITE, OUDERAPP en SOCIAL | Het contactnummer komt uit de schoolgids | Gepubliceerd, met de link onder Toegangspunt] +De controlelijst: drie velden? Knowledge Retrieval gekoppeld? Drie blokken met de context echt in de prompt? Drie teksten met labels? Contactnummer uit de schoolgids? En gepubliceerd? + +[slot: Eén formulier, drie kanalen.] +De handleiding, de prompts en de beelden staan in de repository; de app staat live op udify punt app. In de volgende video gaan we naar de Agent Console: de Toetsweekplanner, met een bestand, een tool en een sandbox die een Excel-bestand maakt. Tot dan. diff --git a/08-chatflow-studiecoach/video-script.md b/08-chatflow-studiecoach/video-script-1.md similarity index 57% rename from 08-chatflow-studiecoach/video-script.md rename to 08-chatflow-studiecoach/video-script-1.md index 371ab5d..6a6238d 100644 --- a/08-chatflow-studiecoach/video-script.md +++ b/08-chatflow-studiecoach/video-script-1.md @@ -1,15 +1,15 @@ -# titel: De Studiecoach -# ondertitel: Handleiding 8 · Chatflow met vier routes, geheugen en een docent in de lus +# titel: De Studiecoach, deel 1 +# ondertitel: Handleiding 8 · Chatflow met vraagherkenning, geheugen en drie routes # stem: nl-NL-FennaNeural # tempo: -5% -# uitvoer: video-studiecoach +# uitvoer: video-studiecoach-1 # reeks: Reeks AI Agents met Dify voor school # bron: git.lexconsultancy.nl/guido/dify-handleidingen [titel] -Welkom bij de achtste en laatste handleiding van de reeks AI Agents met Dify voor school. Tot nu toe ging het over de organisatie van de school. Deze gaat over de les. Je bouwt een Studiecoach biologie voor 3 havo, thema Ecologie: een chat waarmee een leerling de stof kan doorvragen, de planning kan checken en hulp kan vragen bij opdrachten, zonder dat de coach de antwoorden voorzegt. +Welkom bij de achtste en laatste handleiding van de reeks AI Agents met Dify voor school, deel 1 van 2. Tot nu toe ging het over de organisatie van de school. Deze gaat over de les. Je bouwt een Studiecoach biologie voor 3 havo, thema Ecologie: een chat waarmee een leerling de stof kan doorvragen, de planning kan checken en hulp kan vragen bij opdrachten, zonder dat de coach de antwoorden voorzegt. -En als een leerling iets persoonlijks schrijft, gaat het bericht naar de docent, die antwoordt in dezelfde chat. Dat is een mens in de lus. +In dit deel: de kennisbank, de Chatflow met de vraagherkenning, en de drie routes uitleg, hint en planning. De vierde route, een persoonlijk bericht dat naar de docent gaat, komt in deel 2. [kaart: Drie nieuwe bouwstenen | Question Classifier: herkent wat voor vraag de leerling stelt en stuurt hem een andere kant op | Memory: de coach onthoudt het gesprek, zodat en waarom is dat zo werkt | Human Input: de workflow stopt, mailt de docent, en gaat verder met wat de docent invult | Vier routes: uitleg, hint, planning, persoonlijk] Daarvoor gebruik je de appvorm Chatflow: het workflow-canvas dat je kent, maar dan als gesprek. Drie dingen zijn nieuw. De Question Classifier herkent wat voor vraag een leerling stelt. Memory zorgt dat de coach het gesprek onthoudt. En Human Input stopt de workflow, mailt de docent, en gaat verder met wat de docent invult. @@ -68,29 +68,8 @@ Waarom twee keer dezelfde kennisbank? Omdat elk blok zijn eigen zoekvraag en eig [beeld: d11-overzicht.jpg | Deel D. Drie routes klaar] Zo ziet het canvas er nu uit: drie routes klaar, klasse 4 nog leeg. -[beeld: e02-human-input.jpg | Deel E, stap 13. Route 4: Human Input] -Deel E is het stuk dat een studiecoach verantwoord maakt. Een leerling die schrijft ik snap er niks van en iedereen lacht me uit, heeft geen model nodig maar een docent. Klik op het plusje achter Class 4 en kies onder Logic: Human Input. Het blok heeft een bezorgmethode, een formulier, acties en een time-out. - -[beeld: e05-email-ingevuld.jpg | Deel E, stap 13. De mail aan de docent] -Bij Delivery Method kies je Email. Klik op Not configured en vul het mailbericht in: een leerling van 3 havo stelde de Studiecoach een persoonlijke vraag; lees het gesprek en schrijf een kort antwoord, dat krijgt de leerling in de chat te zien. Save, en zet de schakelaar achter Email aan. - -Let op Debug Mode: die stuurt de mail alleen naar het adres van je eigen Dify-account, niet naar de ontvanger. Zo test je zonder dat er mail naar een collega gaat. Zet hem uit als de app echt in gebruik gaat. - -[beeld: e09-form-klaar.jpg | Deel E, stap 14. Het formulier] -Klik in Form Content. Typ: bericht van de leerling, dubbele punt, schuine streep, User Input query. Dan: jouw antwoord aan de leerling, dit komt letterlijk in de chat, en druk op Ctrl schuine streep voor een invoerveld: Paragraph, opslaan als antwoord docent. Bij User Actions een knop: Verstuur aan de leerling. - -[beeld: e12-docent.jpg | Deel E, stap 14. Het blok Docent] -Hernoem het blok naar Docent en laat de time-out op drie dagen. Het blok heeft twee uitgangen: Verstuur, de docent klikte op de knop, en Timeout, drie dagen niets. - -[beeld: e15-hele-flow.jpg | Deel E, stap 15. Drie berichten aan de leerling] -Drie berichten aan de leerling. Achter Verstuur een Answer: bericht van je docent, en dan de variabele antwoord docent. Achter Timeout een Answer, Geen reactie: je docent heeft nog niet kunnen reageren, spreek je docent of mentor morgen aan, en gaat het echt niet goed, bel of chat met De Kindertelefoon. - -En op de classifier, onder Class 4, Add Parallel Node, een Answer met de naam Doorgestuurd: dank je dat je dit vertelt, dit is iets voor een mens, ik heb je bericht doorgestuurd naar je docent, wil je nu meteen met iemand praten, ga naar je mentor of bel De Kindertelefoon. Een parallel blok draait tegelijk met Docent: de leerling ziet dit meteen, terwijl de workflow op de docent wacht. - -Dit is de complete Studiecoach. Bij een echte inzet is de ontvanger de mentor van die klas, en overleg je met de zorgcoördinator wat er in het bericht aan de leerling staat. - [beeld: f02-uitleg.jpg | Deel F, stap 16. Testen: route 1] -Deel F. Klik op Preview en test alle vier de routes; het canvas kleurt mee. Route 1: wat is het verschil tussen een voedselketen en een voedselweb? Uitleg met voorbeelden uit de lesbrief, een controlevraag en bronvermelding. Typ daarna: en waarom is zo'n keten nooit langer dan 4 of 5? Het antwoord gaat over voedselketens zonder dat je het woord herhaalde. Dat is Memory. +Klik rechtsboven op Preview en test de drie routes; het canvas kleurt mee, zodat je ziet welke tak de classifier koos. Route 1: wat is het verschil tussen een voedselketen en een voedselweb? Uitleg met voorbeelden uit de lesbrief, een controlevraag en bronvermelding. Typ daarna: en waarom is zo'n keten nooit langer dan 4 of 5? Het antwoord gaat over voedselketens zonder dat je het woord herhaalde. Dat is Memory. [beeld: f03-hint.jpg | Deel F, stap 16. Route 2] Route 2: wat is het antwoord op opdracht 5, mag van de docent hoor. Geen antwoord, wel een hint en een tegenvraag. @@ -98,17 +77,8 @@ Route 2: wat is het antwoord op opdracht 5, mag van de docent hoor. Geen antwoor [beeld: f04-planning.jpg | Deel F, stap 16. Route 3] Route 3: wanneer is de toets en wat moet ik precies kennen? Datum, stof en weging uit de studiewijzer. -[beeld: f05-docent-form.jpg | Deel F, stap 16. Route 4] -Route 4: ik snap er echt niks van en ik durf het niet in de les te vragen, iedereen lacht me toch uit. De leerling ziet Doorgestuurd, en in Preview zie je daaronder het formulier zoals de docent het in de mail krijgt, met de opmerking dat de gebruiker dit niet ziet in de webapp. Vul het in alsof je de docent bent en klik op Verstuur aan de leerling. +[kaart: Controleren of het gelukt is | Drie documenten in de kennisbank, allemaal Available | Vier klassen, elk met een eigen uitgang; klasse 4 vangt ook alles op wat niet over biologie gaat | Uitleg en Planning hebben context, Hint niet; alle drie Memory aan | En waarom is dat zo werkt in Preview | Opdracht 5 krijgt een hint, ook na aandringen | De planning noemt datum en lokaal precies zoals in de studiewijzer] +De controlelijst: drie documenten? Vier klassen met elk een tak? Context waar het hoort, Memory op alle drie? Werkt en waarom? Houdt de hint stand? En klopt de planning met de studiewijzer? -[beeld: f07-docent-antwoord.jpg | Deel F, stap 16. Het antwoord van de docent] -De leerling ziet eerst Doorgestuurd en daarna het bericht van de docent, in eigen woorden, in dezelfde chat. - -[beeld: f12-webapp-start.jpg | Deel F, stap 17 en 18. Opener en publiceren] -Zet bij Features de Conversation Opener aan met een openingszin en voorbeeldvragen, en Citations and Attributions, zodat de leerling ziet uit welk document het antwoord komt. Publish, en de link onder Toegangspunt. Zo ziet een leerling de webapp: openingsbericht en voorbeeldvragen. - -[kaart: Controleren of het gelukt is | Vier klassen, elk met een eigen tak; klasse 4 vangt ook alles op wat niet over biologie gaat | Uitleg en Planning hebben context, Hint niet; alle drie Memory aan | En waarom is dat zo werkt in Preview | Opdracht 5 krijgt een hint, ook na aandringen | Route 4 geeft Doorgestuurd, een mail in Debug Mode, en daarna het antwoord van de docent | Citations aan, gepubliceerd] -De controlelijst: vier klassen met elk een tak? Context waar het hoort, Memory op alle drie? Werkt en waarom? Houdt de hint stand? Komt route 4 bij de docent uit en daarna terug in de chat? En zijn citations aan en is de app gepubliceerd? - -[slot: Waar hoort de mens? Bouw dat als eerste.] -Dat was de reeks: acht apps, van een workflow met twee stappen tot een chatflow met een docent in de lus. Alles staat in de repository, met de ontwerpkaart, de ontwerppatronen en de bijlage over wat mag. Kies het eenvoudigste patroon dat werkt, en ontwerp voor de fout. Dank voor het kijken. +[slot: Drie routes, één gesprek.] +De handleiding, het lesmateriaal en de beelden staan in de repository. In deel 2 bouwen we de vierde route: een persoonlijk bericht gaat naar de docent, en het antwoord komt terug in de chat. Tot zo. diff --git a/08-chatflow-studiecoach/video-script-2.md b/08-chatflow-studiecoach/video-script-2.md new file mode 100644 index 0000000..403871f --- /dev/null +++ b/08-chatflow-studiecoach/video-script-2.md @@ -0,0 +1,48 @@ +# titel: De Studiecoach, deel 2 +# ondertitel: Handleiding 8 · een mens in de lus met Human Input, en publiceren +# stem: nl-NL-FennaNeural +# tempo: -5% +# uitvoer: video-studiecoach-2 +# reeks: Reeks AI Agents met Dify voor school +# bron: git.lexconsultancy.nl/guido/dify-handleidingen + +[titel] +Welkom bij handleiding 8 van de reeks AI Agents met Dify voor school, deel 2 van 2. In deel 1 bouwde je de Studiecoach met drie routes: uitleg, hint en planning. Nu komt het stuk dat een studiecoach verantwoord maakt: de vierde route, waarin een persoonlijk bericht van een leerling naar de docent gaat, en het antwoord van de docent terugkomt in dezelfde chat. + +Je hebt deel 1 nodig: de Chatflow met de classifier en de drie routes. + +[beeld: e02-human-input.jpg | Deel E, stap 13. Route 4: Human Input] +Deel E is het stuk dat een studiecoach verantwoord maakt. Een leerling die schrijft ik snap er niks van en iedereen lacht me uit, heeft geen model nodig maar een docent. Klik op het plusje achter Class 4 en kies onder Logic: Human Input. Het blok heeft een bezorgmethode, een formulier, acties en een time-out. + +[beeld: e05-email-ingevuld.jpg | Deel E, stap 13. De mail aan de docent] +Bij Delivery Method kies je Email. Klik op Not configured en vul het mailbericht in: een leerling van 3 havo stelde de Studiecoach een persoonlijke vraag; lees het gesprek en schrijf een kort antwoord, dat krijgt de leerling in de chat te zien. Save, en zet de schakelaar achter Email aan. + +Let op Debug Mode: die stuurt de mail alleen naar het adres van je eigen Dify-account, niet naar de ontvanger. Zo test je zonder dat er mail naar een collega gaat. Zet hem uit als de app echt in gebruik gaat. + +[beeld: e09-form-klaar.jpg | Deel E, stap 14. Het formulier] +Klik in Form Content. Typ: bericht van de leerling, dubbele punt, schuine streep, User Input query. Dan: jouw antwoord aan de leerling, dit komt letterlijk in de chat, en druk op Ctrl schuine streep voor een invoerveld: Paragraph, opslaan als antwoord docent. Bij User Actions een knop: Verstuur aan de leerling. + +[beeld: e12-docent.jpg | Deel E, stap 14. Het blok Docent] +Hernoem het blok naar Docent en laat de time-out op drie dagen. Het blok heeft twee uitgangen: Verstuur, de docent klikte op de knop, en Timeout, drie dagen niets. + +[beeld: e15-hele-flow.jpg | Deel E, stap 15. Drie berichten aan de leerling] +Drie berichten aan de leerling. Achter Verstuur een Answer: bericht van je docent, en dan de variabele antwoord docent. Achter Timeout een Answer, Geen reactie: je docent heeft nog niet kunnen reageren, spreek je docent of mentor morgen aan, en gaat het echt niet goed, bel of chat met De Kindertelefoon. + +En op de classifier, onder Class 4, Add Parallel Node, een Answer met de naam Doorgestuurd: dank je dat je dit vertelt, dit is iets voor een mens, ik heb je bericht doorgestuurd naar je docent, wil je nu meteen met iemand praten, ga naar je mentor of bel De Kindertelefoon. Een parallel blok draait tegelijk met Docent: de leerling ziet dit meteen, terwijl de workflow op de docent wacht. + +Dit is de complete Studiecoach. Bij een echte inzet is de ontvanger de mentor van die klas, en overleg je met de zorgcoördinator wat er in het bericht aan de leerling staat. + +[beeld: f05-docent-form.jpg | Deel F, stap 16. Route 4] +Route 4: ik snap er echt niks van en ik durf het niet in de les te vragen, iedereen lacht me toch uit. De leerling ziet Doorgestuurd, en in Preview zie je daaronder het formulier zoals de docent het in de mail krijgt, met de opmerking dat de gebruiker dit niet ziet in de webapp. Vul het in alsof je de docent bent en klik op Verstuur aan de leerling. + +[beeld: f07-docent-antwoord.jpg | Deel F, stap 16. Het antwoord van de docent] +De leerling ziet eerst Doorgestuurd en daarna het bericht van de docent, in eigen woorden, in dezelfde chat. + +[beeld: f12-webapp-start.jpg | Deel F, stap 17 en 18. Opener en publiceren] +Zet bij Features de Conversation Opener aan met een openingszin en voorbeeldvragen, en Citations and Attributions, zodat de leerling ziet uit welk document het antwoord komt. Publish, en de link onder Toegangspunt. Zo ziet een leerling de webapp: openingsbericht en voorbeeldvragen. + +[kaart: Controleren of het gelukt is | Route 4 geeft meteen Doorgestuurd met een hulplijn | De mail komt aan, in Debug Mode op je eigen adres | Het formulier toont het bericht van de leerling en een antwoordveld | Na Verstuur ziet de leerling het antwoord van de docent in de chat | Na drie dagen zonder reactie komt het bericht Geen reactie | Citations aan, gepubliceerd] +De controlelijst: Doorgestuurd meteen? Mail in Debug Mode? Formulier compleet? Antwoord van de docent in de chat? Vangnet na drie dagen? En gepubliceerd met citations? + +[slot: Waar hoort de mens? Bouw dat als eerste.] +Dat was de reeks: acht apps, van een workflow met twee stappen tot een chatflow met een docent in de lus. Alles staat in de repository, met de ontwerpkaart, de ontwerppatronen en de bijlage over wat mag. Kies het eenvoudigste patroon dat werkt, en ontwerp voor de fout. Dank voor het kijken. diff --git a/08-chatflow-studiecoach/video-studiecoach.mp4 b/08-chatflow-studiecoach/video-studiecoach-1.mp4 similarity index 62% rename from 08-chatflow-studiecoach/video-studiecoach.mp4 rename to 08-chatflow-studiecoach/video-studiecoach-1.mp4 index 3d2c555..25d8c1e 100644 Binary files a/08-chatflow-studiecoach/video-studiecoach.mp4 and b/08-chatflow-studiecoach/video-studiecoach-1.mp4 differ diff --git a/08-chatflow-studiecoach/video-studiecoach-1.srt b/08-chatflow-studiecoach/video-studiecoach-1.srt new file mode 100644 index 0000000..c5e4093 --- /dev/null +++ b/08-chatflow-studiecoach/video-studiecoach-1.srt @@ -0,0 +1,528 @@ +1 +00:00:00,000 --> 00:00:07,650 +Welkom bij de achtste en laatste handleiding van de reeks AI Agents met Dify voor school, deel 1 van 2. + +2 +00:00:07,700 --> 00:00:11,686 +Tot nu toe ging het over de organisatie van de school. + +3 +00:00:11,736 --> 00:00:13,331 +Deze gaat over de les. + +4 +00:00:13,381 --> 00:00:17,966 +Je bouwt een Studiecoach biologie voor 3 havo, thema Ecologie: + +5 +00:00:18,016 --> 00:00:29,627 +een chat waarmee een leerling de stof kan doorvragen, de planning kan checken en hulp kan vragen bij opdrachten, zonder dat de coach de antwoorden voorzegt. + +6 +00:00:29,677 --> 00:00:30,524 +In dit deel: + +7 +00:00:30,574 --> 00:00:37,551 +de kennisbank, de Chatflow met de vraagherkenning, en de drie routes uitleg, hint en planning. + +8 +00:00:37,601 --> 00:00:43,656 +De vierde route, een persoonlijk bericht dat naar de docent gaat, komt in deel 2. + +9 +00:00:44,456 --> 00:00:47,505 +Daarvoor gebruik je de appvorm Chatflow: + +10 +00:00:47,555 --> 00:00:51,689 +het workflow-canvas dat je kent, maar dan als gesprek. + +11 +00:00:51,739 --> 00:00:53,471 +Drie dingen zijn nieuw. + +12 +00:00:53,521 --> 00:00:58,507 +De Question Classifier herkent wat voor vraag een leerling stelt. + +13 +00:00:58,557 --> 00:01:02,148 +Memory zorgt dat de coach het gesprek onthoudt. + +14 +00:01:02,198 --> 00:01:09,198 +En Human Input stopt de workflow, mailt de docent, en gaat verder met wat de docent invult. + +15 +00:01:09,248 --> 00:01:10,128 +Vier routes: + +16 +00:01:10,178 --> 00:01:19,088 +uitleg uit de lesbrief, een hint bij een opdracht, de planning uit de studiewijzer, en persoonlijk, naar de docent. + +17 +00:01:19,888 --> 00:01:22,920 +Bij de handleiding zitten drie documenten: + +18 +00:01:22,970 --> 00:01:30,403 +de lesbrief, de studiewijzer met de afspraken, en een echte open module van VO-content onder CC BY-SA. + +19 +00:01:30,453 --> 00:01:32,018 +Die licentie betekent: + +20 +00:01:32,068 --> 00:01:39,428 +je mag het gebruiken en bewerken, als je de bron noemt en je bewerking onder dezelfde licentie deelt. + +21 +00:01:39,478 --> 00:01:45,568 +Vervang je dit door je eigen vak, let dan op met methodemateriaal van een uitgever. + +22 +00:01:46,368 --> 00:01:46,855 +Deel A. + +23 +00:01:46,905 --> 00:01:53,841 +Maak een kennisbank met de lesbrief en de studiewijzer, in de sandbox één bestand per keer. + +24 +00:01:53,891 --> 00:01:58,984 +Zet de delimiter op twee keer backslash n en klik op Preview Chunk: + +25 +00:01:59,034 --> 00:02:07,045 +de lesbrief valt uiteen in veertien stukken van ongeveer duizend tekens, elk een alinea met echte inhoud. + +26 +00:02:07,095 --> 00:02:08,400 +Save and Process. + +27 +00:02:09,200 --> 00:02:10,149 +Bij Settings: + +28 +00:02:10,199 --> 00:02:19,828 +naam Biologie 3 havo ecologie, en een beschrijving die de begrippen uit de lesbrief en de afspraken uit de studiewijzer noemt. + +29 +00:02:19,878 --> 00:02:27,176 +Maximaal 400 tekens; is hij langer, dan krijg je Modified unsuccessfully, zonder uitleg waarom. + +30 +00:02:27,976 --> 00:02:35,510 +Voeg met Add file de Stercollectie-module toe, weer met de delimiter op twee keer backslash n. + +31 +00:02:35,560 --> 00:02:38,464 +Drie documenten, allemaal Available. + +32 +00:02:39,264 --> 00:02:39,849 +Deel B. + +33 +00:02:39,899 --> 00:02:44,385 +Studio, Create, Create from Blank, kaart Chatflow. + +34 +00:02:44,435 --> 00:02:47,924 +Dify zet alvast een standaardflow neer: + +35 +00:02:47,974 --> 00:02:50,101 +User Input, LLM, Answer. + +36 +00:02:50,151 --> 00:02:56,089 +Die twee blokken passen niet in ons plan; verwijder Answer en LLM. + +37 +00:02:56,139 --> 00:03:01,714 +Alleen User Input blijft over, en de invoer is sys punt query: + +38 +00:03:01,764 --> 00:03:04,032 +de vraag van de leerling. + +39 +00:03:04,832 --> 00:03:06,071 +Bij User Input: + +40 +00:03:06,121 --> 00:03:10,112 +Select next step, en onder Question Understand: + +41 +00:03:10,162 --> 00:03:11,831 +Question Classifier. + +42 +00:03:11,881 --> 00:03:13,292 +Model gpt-5-mini. + +43 +00:03:13,342 --> 00:03:20,169 +Een klasse is een beschrijving in gewone taal; het model kiest de best passende. + +44 +00:03:20,219 --> 00:03:22,060 +Class 1, begripsvraag: + +45 +00:03:22,110 --> 00:03:26,015 +de leerling wil iets uit de lesstof begrijpen. + +46 +00:03:26,065 --> 00:03:27,992 +Class 2, huiswerkvraag: + +47 +00:03:28,042 --> 00:03:35,385 +de leerling vraagt het antwoord op een opdracht of wil dat het huiswerk gemaakt wordt. + +48 +00:03:35,435 --> 00:03:37,448 +Class 3, planningsvraag: + +49 +00:03:37,498 --> 00:03:41,402 +de toets, de datum, het huiswerk, de steunles. + +50 +00:03:41,452 --> 00:03:44,325 +Class 4, persoonlijk of zorgelijk: + +51 +00:03:44,375 --> 00:03:51,459 +het lukt niet, stress, problemen thuis, gepest worden, of wil met de docent praten. + +52 +00:03:51,509 --> 00:03:54,776 +Ook alles wat niet over biologie gaat. + +53 +00:03:55,576 --> 00:03:57,210 +Scroll naar Next Step: + +54 +00:03:57,260 --> 00:04:00,195 +elke klasse heeft nu een eigen uitgang. + +55 +00:04:00,245 --> 00:04:02,491 +Let op het einde van klasse 4: + +56 +00:04:02,541 --> 00:04:05,399 +ook alles wat niet over biologie gaat. + +57 +00:04:05,449 --> 00:04:06,471 +Dat is bewust. + +58 +00:04:06,521 --> 00:04:14,967 +Alles wat nergens past, komt zo bij een mens terecht in plaats van bij een model dat toch een antwoord verzint. + +59 +00:04:15,017 --> 00:04:19,456 +Zet je vangnet altijd in de klasse die naar een mens gaat. + +60 +00:04:20,256 --> 00:04:21,752 +Deel C, route 1: + +61 +00:04:21,802 --> 00:04:23,974 +uitleg uit de lesbrief. + +62 +00:04:24,024 --> 00:04:25,326 +Onder Class 1: + +63 +00:04:25,376 --> 00:04:31,510 +Knowledge Retrieval, met de kennisbank Biologie 3 havo ecologie. + +64 +00:04:31,560 --> 00:04:35,424 +De zoekvraag staat al op sys punt query. + +65 +00:04:36,224 --> 00:04:41,869 +Dan een LLM-blok, gpt-5-mini, Context op Knowledge Retrieval result. + +66 +00:04:41,919 --> 00:04:42,706 +De prompt: + +67 +00:04:42,756 --> 00:04:55,184 +je bent de studiecoach biologie van Het Voorbeeldcollege, je legt de lesstof over ecologie uit in gewoon Nederlands, met voorbeelden uit de lesbrief. + +68 +00:04:55,234 --> 00:04:59,958 +Gebruik alleen de lesstof; staat het er niet in, zeg dat. + +69 +00:05:00,008 --> 00:05:08,249 +Je-vorm, maximaal acht zinnen, eindig met een controlevraag, en geef geen antwoorden op opdrachten. + +70 +00:05:08,299 --> 00:05:09,002 +Onderaan: + +71 +00:05:09,052 --> 00:05:11,816 +Lesstof, schuine streep, Context. + +72 +00:05:12,616 --> 00:05:13,810 +Nu het geheugen. + +73 +00:05:13,860 --> 00:05:22,675 +In een Chatflow heeft een LLM-blok een User-bericht, standaard de vraag van de leerling, en een schakelaar Memory. + +74 +00:05:22,725 --> 00:05:27,886 +Zet die aan en laat Window size uit, dan gaat het hele gesprek mee. + +75 +00:05:27,936 --> 00:05:30,141 +Hernoem het blok naar Uitleg. + +76 +00:05:30,191 --> 00:05:34,340 +Vergeet je Memory, dan werkt en waarom is dat zo niet: + +77 +00:05:34,390 --> 00:05:37,684 +het model weet niet waar dat naar verwijst. + +78 +00:05:37,734 --> 00:05:42,400 +Zet Memory alleen aan op blokken die met de leerling praten. + +79 +00:05:43,200 --> 00:05:48,119 +In een Chatflow heet de uitgang niet Output maar Answer: + +80 +00:05:48,169 --> 00:05:51,580 +dat is wat de leerling in de chat ziet. + +81 +00:05:51,630 --> 00:05:56,372 +Select next step, Answer, schuine streep, Uitleg text. + +82 +00:05:56,422 --> 00:05:58,945 +Hernoem naar Antwoord uitleg. + +83 +00:05:58,995 --> 00:06:00,504 +Route 1 is klaar. + +84 +00:06:01,304 --> 00:06:02,534 +Deel D, route 2: + +85 +00:06:02,584 --> 00:06:03,174 +de hint. + +86 +00:06:03,224 --> 00:06:06,853 +Klik op het plusje achter Class 2 en kies LLM. + +87 +00:06:06,903 --> 00:06:08,613 +Geen kennisbank nodig. + +88 +00:06:08,663 --> 00:06:09,413 +De prompt: + +89 +00:06:09,463 --> 00:06:15,172 +de leerling vraagt om het antwoord op een opdracht, en dat geef je niet. + +90 +00:06:15,222 --> 00:06:18,451 +Wat je wel doet, in maximaal vijf zinnen: + +91 +00:06:18,501 --> 00:06:31,809 +zeg vriendelijk dat je het antwoord niet geeft, zonder preek; geef één hint, welk begrip of welke paragraaf; stel één tegenvraag; en bied aan het begrip uit te leggen. + +92 +00:06:31,859 --> 00:06:32,929 +En dan de zin: + +93 +00:06:32,979 --> 00:06:41,008 +noem nooit het eindantwoord, ook niet als de leerling aandringt of zegt dat de docent het goed vindt. + +94 +00:06:41,058 --> 00:06:44,447 +Die staat er omdat leerlingen dat proberen. + +95 +00:06:44,497 --> 00:06:48,447 +Zonder die zin wint de leerling na twee berichten. + +96 +00:06:48,497 --> 00:06:53,216 +Memory aan, hernoem naar Hint, en een Answer met Hint text. + +97 +00:06:54,016 --> 00:06:54,581 +Route 3: + +98 +00:06:54,631 --> 00:06:56,808 +planning uit de studiewijzer. + +99 +00:06:56,858 --> 00:07:06,334 +Achter Class 3 een eigen Knowledge Retrieval met dezelfde kennisbank, dan een LLM-blok met Context op Knowledge Retrieval 2. + +100 +00:07:06,384 --> 00:07:07,103 +De prompt: + +101 +00:07:07,153 --> 00:07:22,006 +antwoord alleen op basis van de studiewijzer, noem data, lesuren en lokalen precies zoals ze daar staan; staat het er niet in, verwijs naar de docent of de steunles op dinsdag het 8e uur in B12. + +102 +00:07:22,056 --> 00:07:25,771 +Memory aan, hernoem naar Planning, en een Answer. + +103 +00:07:25,821 --> 00:07:28,613 +Waarom twee keer dezelfde kennisbank? + +104 +00:07:28,663 --> 00:07:33,069 +Omdat elk blok zijn eigen zoekvraag en eigen prompt heeft. + +105 +00:07:33,119 --> 00:07:42,952 +Route 1 zoekt in de lesstof en legt uit; route 3 zoekt dezelfde kennisbank af, maar de prompt kijkt alleen naar de studiewijzer. + +106 +00:07:43,752 --> 00:07:46,338 +Zo ziet het canvas er nu uit: + +107 +00:07:46,388 --> 00:07:49,752 +drie routes klaar, klasse 4 nog leeg. + +108 +00:07:50,552 --> 00:07:59,748 +Klik rechtsboven op Preview en test de drie routes; het canvas kleurt mee, zodat je ziet welke tak de classifier koos. + +109 +00:07:59,798 --> 00:08:00,374 +Route 1: + +110 +00:08:00,424 --> 00:08:05,232 +wat is het verschil tussen een voedselketen en een voedselweb? + +111 +00:08:05,282 --> 00:08:11,187 +Uitleg met voorbeelden uit de lesbrief, een controlevraag en bronvermelding. + +112 +00:08:11,237 --> 00:08:12,049 +Typ daarna: + +113 +00:08:12,099 --> 00:08:15,810 +en waarom is zo'n keten nooit langer dan 4 of 5? + +114 +00:08:15,860 --> 00:08:21,373 +Het antwoord gaat over voedselketens zonder dat je het woord herhaalde. + +115 +00:08:21,423 --> 00:08:22,520 +Dat is Memory. + +116 +00:08:23,320 --> 00:08:23,990 +Route 2: + +117 +00:08:24,040 --> 00:08:29,210 +wat is het antwoord op opdracht 5, mag van de docent hoor. + +118 +00:08:29,260 --> 00:08:33,400 +Geen antwoord, wel een hint en een tegenvraag. + +119 +00:08:34,200 --> 00:08:34,855 +Route 3: + +120 +00:08:34,905 --> 00:08:39,259 +wanneer is de toets en wat moet ik precies kennen? + +121 +00:08:39,309 --> 00:08:43,008 +Datum, stof en weging uit de studiewijzer. + +122 +00:08:43,808 --> 00:08:45,401 +De controlelijst: + +123 +00:08:45,451 --> 00:08:46,948 +drie documenten? + +124 +00:08:46,998 --> 00:08:49,751 +Vier klassen met elk een tak? + +125 +00:08:49,801 --> 00:08:54,004 +Context waar het hoort, Memory op alle drie? + +126 +00:08:54,054 --> 00:08:55,550 +Werkt en waarom? + +127 +00:08:55,600 --> 00:08:57,483 +Houdt de hint stand? + +128 +00:08:57,533 --> 00:09:01,496 +En klopt de planning met de studiewijzer? + +129 +00:09:02,296 --> 00:09:07,723 +De handleiding, het lesmateriaal en de beelden staan in de repository. + +130 +00:09:07,773 --> 00:09:10,540 +In deel 2 bouwen we de vierde route: + +131 +00:09:10,590 --> 00:09:17,034 +een persoonlijk bericht gaat naar de docent, en het antwoord komt terug in de chat. + +132 +00:09:17,084 --> 00:09:17,632 +Tot zo. + diff --git a/08-chatflow-studiecoach/video-studiecoach-2.mp4 b/08-chatflow-studiecoach/video-studiecoach-2.mp4 new file mode 100644 index 0000000..bb8cc26 Binary files /dev/null and b/08-chatflow-studiecoach/video-studiecoach-2.mp4 differ diff --git a/08-chatflow-studiecoach/video-studiecoach-2.srt b/08-chatflow-studiecoach/video-studiecoach-2.srt new file mode 100644 index 0000000..6548ea0 --- /dev/null +++ b/08-chatflow-studiecoach/video-studiecoach-2.srt @@ -0,0 +1,252 @@ +1 +00:00:00,000 --> 00:00:06,062 +Welkom bij handleiding 8 van de reeks AI Agents met Dify voor school, deel 2 van 2. + +2 +00:00:06,112 --> 00:00:09,817 +In deel 1 bouwde je de Studiecoach met drie routes: + +3 +00:00:09,867 --> 00:00:11,658 +uitleg, hint en planning. + +4 +00:00:11,708 --> 00:00:15,708 +Nu komt het stuk dat een studiecoach verantwoord maakt: + +5 +00:00:15,758 --> 00:00:26,237 +de vierde route, waarin een persoonlijk bericht van een leerling naar de docent gaat, en het antwoord van de docent terugkomt in dezelfde chat. + +6 +00:00:26,287 --> 00:00:27,784 +Je hebt deel 1 nodig: + +7 +00:00:27,834 --> 00:00:31,368 +de Chatflow met de classifier en de drie routes. + +8 +00:00:32,168 --> 00:00:36,374 +Deel E is het stuk dat een studiecoach verantwoord maakt. + +9 +00:00:36,424 --> 00:00:44,662 +Een leerling die schrijft ik snap er niks van en iedereen lacht me uit, heeft geen model nodig maar een docent. + +10 +00:00:44,712 --> 00:00:48,694 +Klik op het plusje achter Class 4 en kies onder Logic: + +11 +00:00:48,744 --> 00:00:49,590 +Human Input. + +12 +00:00:49,640 --> 00:00:55,016 +Het blok heeft een bezorgmethode, een formulier, acties en een time-out. + +13 +00:00:55,816 --> 00:00:58,259 +Bij Delivery Method kies je Email. + +14 +00:00:58,309 --> 00:01:01,852 +Klik op Not configured en vul het mailbericht in: + +15 +00:01:01,902 --> 00:01:13,509 +een leerling van 3 havo stelde de Studiecoach een persoonlijke vraag; lees het gesprek en schrijf een kort antwoord, dat krijgt de leerling in de chat te zien. + +16 +00:01:13,559 --> 00:01:16,735 +Save, en zet de schakelaar achter Email aan. + +17 +00:01:16,785 --> 00:01:18,055 +Let op Debug Mode: + +18 +00:01:18,105 --> 00:01:24,727 +die stuurt de mail alleen naar het adres van je eigen Dify-account, niet naar de ontvanger. + +19 +00:01:24,777 --> 00:01:28,540 +Zo test je zonder dat er mail naar een collega gaat. + +20 +00:01:28,590 --> 00:01:31,816 +Zet hem uit als de app echt in gebruik gaat. + +21 +00:01:32,616 --> 00:01:34,309 +Klik in Form Content. + +22 +00:01:34,359 --> 00:01:34,641 +Typ: + +23 +00:01:34,691 --> 00:01:40,619 +bericht van de leerling, dubbele punt, schuine streep, User Input query. + +24 +00:01:40,669 --> 00:01:40,951 +Dan: + +25 +00:01:41,001 --> 00:01:50,415 +jouw antwoord aan de leerling, dit komt letterlijk in de chat, en druk op Ctrl schuine streep voor een invoerveld: + +26 +00:01:50,465 --> 00:01:53,652 +Paragraph, opslaan als antwoord docent. + +27 +00:01:53,702 --> 00:01:55,811 +Bij User Actions een knop: + +28 +00:01:55,861 --> 00:01:57,936 +Verstuur aan de leerling. + +29 +00:01:58,736 --> 00:02:03,701 +Hernoem het blok naar Docent en laat de time-out op drie dagen. + +30 +00:02:03,751 --> 00:02:06,089 +Het blok heeft twee uitgangen: + +31 +00:02:06,139 --> 00:02:11,552 +Verstuur, de docent klikte op de knop, en Timeout, drie dagen niets. + +32 +00:02:12,352 --> 00:02:14,507 +Drie berichten aan de leerling. + +33 +00:02:14,557 --> 00:02:16,428 +Achter Verstuur een Answer: + +34 +00:02:16,478 --> 00:02:20,624 +bericht van je docent, en dan de variabele antwoord docent. + +35 +00:02:20,674 --> 00:02:23,470 +Achter Timeout een Answer, Geen reactie: + +36 +00:02:23,520 --> 00:02:33,642 +je docent heeft nog niet kunnen reageren, spreek je docent of mentor morgen aan, en gaat het echt niet goed, bel of chat met De Kindertelefoon. + +37 +00:02:33,692 --> 00:02:40,115 +En op de classifier, onder Class 4, Add Parallel Node, een Answer met de naam Doorgestuurd: + +38 +00:02:40,165 --> 00:02:52,989 +dank je dat je dit vertelt, dit is iets voor een mens, ik heb je bericht doorgestuurd naar je docent, wil je nu meteen met iemand praten, ga naar je mentor of bel De Kindertelefoon. + +39 +00:02:53,039 --> 00:02:56,190 +Een parallel blok draait tegelijk met Docent: + +40 +00:02:56,240 --> 00:03:01,027 +de leerling ziet dit meteen, terwijl de workflow op de docent wacht. + +41 +00:03:01,077 --> 00:03:03,232 +Dit is de complete Studiecoach. + +42 +00:03:03,282 --> 00:03:13,312 +Bij een echte inzet is de ontvanger de mentor van die klas, en overleg je met de zorgcoördinator wat er in het bericht aan de leerling staat. + +43 +00:03:14,112 --> 00:03:14,600 +Route 4: + +44 +00:03:14,650 --> 00:03:20,853 +ik snap er echt niks van en ik durf het niet in de les te vragen, iedereen lacht me toch uit. + +45 +00:03:20,903 --> 00:03:32,688 +De leerling ziet Doorgestuurd, en in Preview zie je daaronder het formulier zoals de docent het in de mail krijgt, met de opmerking dat de gebruiker dit niet ziet in de webapp. + +46 +00:03:32,738 --> 00:03:37,512 +Vul het in alsof je de docent bent en klik op Verstuur aan de leerling. + +47 +00:03:38,312 --> 00:03:45,992 +De leerling ziet eerst Doorgestuurd en daarna het bericht van de docent, in eigen woorden, in dezelfde chat. + +48 +00:03:46,792 --> 00:03:59,629 +Zet bij Features de Conversation Opener aan met een openingszin en voorbeeldvragen, en Citations and Attributions, zodat de leerling ziet uit welk document het antwoord komt. + +49 +00:03:59,679 --> 00:04:02,518 +Publish, en de link onder Toegangspunt. + +50 +00:04:02,568 --> 00:04:04,814 +Zo ziet een leerling de webapp: + +51 +00:04:04,864 --> 00:04:07,456 +openingsbericht en voorbeeldvragen. + +52 +00:04:08,256 --> 00:04:09,993 +De controlelijst: + +53 +00:04:10,043 --> 00:04:12,094 +Doorgestuurd meteen? + +54 +00:04:12,144 --> 00:04:14,091 +Mail in Debug Mode? + +55 +00:04:14,141 --> 00:04:16,088 +Formulier compleet? + +56 +00:04:16,138 --> 00:04:19,661 +Antwoord van de docent in de chat? + +57 +00:04:19,711 --> 00:04:21,973 +Vangnet na drie dagen? + +58 +00:04:22,023 --> 00:04:25,176 +En gepubliceerd met citations? + +59 +00:04:25,976 --> 00:04:27,267 +Dat was de reeks: + +60 +00:04:27,317 --> 00:04:34,127 +acht apps, van een workflow met twee stappen tot een chatflow met een docent in de lus. + +61 +00:04:34,177 --> 00:04:41,776 +Alles staat in de repository, met de ontwerpkaart, de ontwerppatronen en de bijlage over wat mag. + +62 +00:04:41,826 --> 00:04:46,902 +Kies het eenvoudigste patroon dat werkt, en ontwerp voor de fout. + +63 +00:04:46,952 --> 00:04:48,608 +Dank voor het kijken. + diff --git a/08-chatflow-studiecoach/video-studiecoach.srt b/08-chatflow-studiecoach/video-studiecoach.srt deleted file mode 100644 index 7bbddc5..0000000 --- a/08-chatflow-studiecoach/video-studiecoach.srt +++ /dev/null @@ -1,708 +0,0 @@ -1 -00:00:00,000 --> 00:00:06,391 -Welkom bij de achtste en laatste handleiding van de reeks AI Agents met Dify voor school. - -2 -00:00:06,441 --> 00:00:10,299 -Tot nu toe ging het over de organisatie van de school. - -3 -00:00:10,349 --> 00:00:11,891 -Deze gaat over de les. - -4 -00:00:11,941 --> 00:00:16,378 -Je bouwt een Studiecoach biologie voor 3 havo, thema Ecologie: - -5 -00:00:16,428 --> 00:00:27,667 -een chat waarmee een leerling de stof kan doorvragen, de planning kan checken en hulp kan vragen bij opdrachten, zonder dat de coach de antwoorden voorzegt. - -6 -00:00:27,717 --> 00:00:35,772 -En als een leerling iets persoonlijks schrijft, gaat het bericht naar de docent, die antwoordt in dezelfde chat. - -7 -00:00:35,822 --> 00:00:37,704 -Dat is een mens in de lus. - -8 -00:00:38,504 --> 00:00:41,553 -Daarvoor gebruik je de appvorm Chatflow: - -9 -00:00:41,603 --> 00:00:45,737 -het workflow-canvas dat je kent, maar dan als gesprek. - -10 -00:00:45,787 --> 00:00:47,519 -Drie dingen zijn nieuw. - -11 -00:00:47,569 --> 00:00:52,555 -De Question Classifier herkent wat voor vraag een leerling stelt. - -12 -00:00:52,605 --> 00:00:56,196 -Memory zorgt dat de coach het gesprek onthoudt. - -13 -00:00:56,246 --> 00:01:03,246 -En Human Input stopt de workflow, mailt de docent, en gaat verder met wat de docent invult. - -14 -00:01:03,296 --> 00:01:04,176 -Vier routes: - -15 -00:01:04,226 --> 00:01:13,136 -uitleg uit de lesbrief, een hint bij een opdracht, de planning uit de studiewijzer, en persoonlijk, naar de docent. - -16 -00:01:13,936 --> 00:01:16,968 -Bij de handleiding zitten drie documenten: - -17 -00:01:17,018 --> 00:01:24,451 -de lesbrief, de studiewijzer met de afspraken, en een echte open module van VO-content onder CC BY-SA. - -18 -00:01:24,501 --> 00:01:26,066 -Die licentie betekent: - -19 -00:01:26,116 --> 00:01:33,476 -je mag het gebruiken en bewerken, als je de bron noemt en je bewerking onder dezelfde licentie deelt. - -20 -00:01:33,526 --> 00:01:39,616 -Vervang je dit door je eigen vak, let dan op met methodemateriaal van een uitgever. - -21 -00:01:40,416 --> 00:01:40,903 -Deel A. - -22 -00:01:40,953 --> 00:01:47,889 -Maak een kennisbank met de lesbrief en de studiewijzer, in de sandbox één bestand per keer. - -23 -00:01:47,939 --> 00:01:53,032 -Zet de delimiter op twee keer backslash n en klik op Preview Chunk: - -24 -00:01:53,082 --> 00:02:01,093 -de lesbrief valt uiteen in veertien stukken van ongeveer duizend tekens, elk een alinea met echte inhoud. - -25 -00:02:01,143 --> 00:02:02,448 -Save and Process. - -26 -00:02:03,248 --> 00:02:04,197 -Bij Settings: - -27 -00:02:04,247 --> 00:02:13,876 -naam Biologie 3 havo ecologie, en een beschrijving die de begrippen uit de lesbrief en de afspraken uit de studiewijzer noemt. - -28 -00:02:13,926 --> 00:02:21,224 -Maximaal 400 tekens; is hij langer, dan krijg je Modified unsuccessfully, zonder uitleg waarom. - -29 -00:02:22,024 --> 00:02:29,558 -Voeg met Add file de Stercollectie-module toe, weer met de delimiter op twee keer backslash n. - -30 -00:02:29,608 --> 00:02:32,512 -Drie documenten, allemaal Available. - -31 -00:02:33,312 --> 00:02:33,897 -Deel B. - -32 -00:02:33,947 --> 00:02:38,433 -Studio, Create, Create from Blank, kaart Chatflow. - -33 -00:02:38,483 --> 00:02:41,972 -Dify zet alvast een standaardflow neer: - -34 -00:02:42,022 --> 00:02:44,149 -User Input, LLM, Answer. - -35 -00:02:44,199 --> 00:02:50,137 -Die twee blokken passen niet in ons plan; verwijder Answer en LLM. - -36 -00:02:50,187 --> 00:02:55,762 -Alleen User Input blijft over, en de invoer is sys punt query: - -37 -00:02:55,812 --> 00:02:58,080 -de vraag van de leerling. - -38 -00:02:58,880 --> 00:03:00,119 -Bij User Input: - -39 -00:03:00,169 --> 00:03:04,160 -Select next step, en onder Question Understand: - -40 -00:03:04,210 --> 00:03:05,879 -Question Classifier. - -41 -00:03:05,929 --> 00:03:07,340 -Model gpt-5-mini. - -42 -00:03:07,390 --> 00:03:14,217 -Een klasse is een beschrijving in gewone taal; het model kiest de best passende. - -43 -00:03:14,267 --> 00:03:16,108 -Class 1, begripsvraag: - -44 -00:03:16,158 --> 00:03:20,063 -de leerling wil iets uit de lesstof begrijpen. - -45 -00:03:20,113 --> 00:03:22,040 -Class 2, huiswerkvraag: - -46 -00:03:22,090 --> 00:03:29,433 -de leerling vraagt het antwoord op een opdracht of wil dat het huiswerk gemaakt wordt. - -47 -00:03:29,483 --> 00:03:31,496 -Class 3, planningsvraag: - -48 -00:03:31,546 --> 00:03:35,450 -de toets, de datum, het huiswerk, de steunles. - -49 -00:03:35,500 --> 00:03:38,373 -Class 4, persoonlijk of zorgelijk: - -50 -00:03:38,423 --> 00:03:45,507 -het lukt niet, stress, problemen thuis, gepest worden, of wil met de docent praten. - -51 -00:03:45,557 --> 00:03:48,824 -Ook alles wat niet over biologie gaat. - -52 -00:03:49,624 --> 00:03:51,258 -Scroll naar Next Step: - -53 -00:03:51,308 --> 00:03:54,243 -elke klasse heeft nu een eigen uitgang. - -54 -00:03:54,293 --> 00:03:56,539 -Let op het einde van klasse 4: - -55 -00:03:56,589 --> 00:03:59,447 -ook alles wat niet over biologie gaat. - -56 -00:03:59,497 --> 00:04:00,519 -Dat is bewust. - -57 -00:04:00,569 --> 00:04:09,015 -Alles wat nergens past, komt zo bij een mens terecht in plaats van bij een model dat toch een antwoord verzint. - -58 -00:04:09,065 --> 00:04:13,504 -Zet je vangnet altijd in de klasse die naar een mens gaat. - -59 -00:04:14,304 --> 00:04:15,800 -Deel C, route 1: - -60 -00:04:15,850 --> 00:04:18,022 -uitleg uit de lesbrief. - -61 -00:04:18,072 --> 00:04:19,374 -Onder Class 1: - -62 -00:04:19,424 --> 00:04:25,558 -Knowledge Retrieval, met de kennisbank Biologie 3 havo ecologie. - -63 -00:04:25,608 --> 00:04:29,472 -De zoekvraag staat al op sys punt query. - -64 -00:04:30,272 --> 00:04:35,917 -Dan een LLM-blok, gpt-5-mini, Context op Knowledge Retrieval result. - -65 -00:04:35,967 --> 00:04:36,754 -De prompt: - -66 -00:04:36,804 --> 00:04:49,232 -je bent de studiecoach biologie van Het Voorbeeldcollege, je legt de lesstof over ecologie uit in gewoon Nederlands, met voorbeelden uit de lesbrief. - -67 -00:04:49,282 --> 00:04:54,006 -Gebruik alleen de lesstof; staat het er niet in, zeg dat. - -68 -00:04:54,056 --> 00:05:02,297 -Je-vorm, maximaal acht zinnen, eindig met een controlevraag, en geef geen antwoorden op opdrachten. - -69 -00:05:02,347 --> 00:05:03,050 -Onderaan: - -70 -00:05:03,100 --> 00:05:05,864 -Lesstof, schuine streep, Context. - -71 -00:05:06,664 --> 00:05:07,858 -Nu het geheugen. - -72 -00:05:07,908 --> 00:05:16,723 -In een Chatflow heeft een LLM-blok een User-bericht, standaard de vraag van de leerling, en een schakelaar Memory. - -73 -00:05:16,773 --> 00:05:21,934 -Zet die aan en laat Window size uit, dan gaat het hele gesprek mee. - -74 -00:05:21,984 --> 00:05:24,189 -Hernoem het blok naar Uitleg. - -75 -00:05:24,239 --> 00:05:28,388 -Vergeet je Memory, dan werkt en waarom is dat zo niet: - -76 -00:05:28,438 --> 00:05:31,732 -het model weet niet waar dat naar verwijst. - -77 -00:05:31,782 --> 00:05:36,448 -Zet Memory alleen aan op blokken die met de leerling praten. - -78 -00:05:37,248 --> 00:05:42,167 -In een Chatflow heet de uitgang niet Output maar Answer: - -79 -00:05:42,217 --> 00:05:45,628 -dat is wat de leerling in de chat ziet. - -80 -00:05:45,678 --> 00:05:50,420 -Select next step, Answer, schuine streep, Uitleg text. - -81 -00:05:50,470 --> 00:05:52,993 -Hernoem naar Antwoord uitleg. - -82 -00:05:53,043 --> 00:05:54,552 -Route 1 is klaar. - -83 -00:05:55,352 --> 00:05:56,582 -Deel D, route 2: - -84 -00:05:56,632 --> 00:05:57,222 -de hint. - -85 -00:05:57,272 --> 00:06:00,901 -Klik op het plusje achter Class 2 en kies LLM. - -86 -00:06:00,951 --> 00:06:02,661 -Geen kennisbank nodig. - -87 -00:06:02,711 --> 00:06:03,461 -De prompt: - -88 -00:06:03,511 --> 00:06:09,220 -de leerling vraagt om het antwoord op een opdracht, en dat geef je niet. - -89 -00:06:09,270 --> 00:06:12,499 -Wat je wel doet, in maximaal vijf zinnen: - -90 -00:06:12,549 --> 00:06:25,857 -zeg vriendelijk dat je het antwoord niet geeft, zonder preek; geef één hint, welk begrip of welke paragraaf; stel één tegenvraag; en bied aan het begrip uit te leggen. - -91 -00:06:25,907 --> 00:06:26,977 -En dan de zin: - -92 -00:06:27,027 --> 00:06:35,056 -noem nooit het eindantwoord, ook niet als de leerling aandringt of zegt dat de docent het goed vindt. - -93 -00:06:35,106 --> 00:06:38,495 -Die staat er omdat leerlingen dat proberen. - -94 -00:06:38,545 --> 00:06:42,495 -Zonder die zin wint de leerling na twee berichten. - -95 -00:06:42,545 --> 00:06:47,264 -Memory aan, hernoem naar Hint, en een Answer met Hint text. - -96 -00:06:48,064 --> 00:06:48,629 -Route 3: - -97 -00:06:48,679 --> 00:06:50,856 -planning uit de studiewijzer. - -98 -00:06:50,906 --> 00:07:00,382 -Achter Class 3 een eigen Knowledge Retrieval met dezelfde kennisbank, dan een LLM-blok met Context op Knowledge Retrieval 2. - -99 -00:07:00,432 --> 00:07:01,151 -De prompt: - -100 -00:07:01,201 --> 00:07:16,054 -antwoord alleen op basis van de studiewijzer, noem data, lesuren en lokalen precies zoals ze daar staan; staat het er niet in, verwijs naar de docent of de steunles op dinsdag het 8e uur in B12. - -101 -00:07:16,104 --> 00:07:19,819 -Memory aan, hernoem naar Planning, en een Answer. - -102 -00:07:19,869 --> 00:07:22,661 -Waarom twee keer dezelfde kennisbank? - -103 -00:07:22,711 --> 00:07:27,117 -Omdat elk blok zijn eigen zoekvraag en eigen prompt heeft. - -104 -00:07:27,167 --> 00:07:37,000 -Route 1 zoekt in de lesstof en legt uit; route 3 zoekt dezelfde kennisbank af, maar de prompt kijkt alleen naar de studiewijzer. - -105 -00:07:37,800 --> 00:07:40,386 -Zo ziet het canvas er nu uit: - -106 -00:07:40,436 --> 00:07:43,800 -drie routes klaar, klasse 4 nog leeg. - -107 -00:07:44,600 --> 00:07:48,806 -Deel E is het stuk dat een studiecoach verantwoord maakt. - -108 -00:07:48,856 --> 00:07:57,094 -Een leerling die schrijft ik snap er niks van en iedereen lacht me uit, heeft geen model nodig maar een docent. - -109 -00:07:57,144 --> 00:08:01,126 -Klik op het plusje achter Class 4 en kies onder Logic: - -110 -00:08:01,176 --> 00:08:02,022 -Human Input. - -111 -00:08:02,072 --> 00:08:07,448 -Het blok heeft een bezorgmethode, een formulier, acties en een time-out. - -112 -00:08:08,248 --> 00:08:10,691 -Bij Delivery Method kies je Email. - -113 -00:08:10,741 --> 00:08:14,284 -Klik op Not configured en vul het mailbericht in: - -114 -00:08:14,334 --> 00:08:25,941 -een leerling van 3 havo stelde de Studiecoach een persoonlijke vraag; lees het gesprek en schrijf een kort antwoord, dat krijgt de leerling in de chat te zien. - -115 -00:08:25,991 --> 00:08:29,167 -Save, en zet de schakelaar achter Email aan. - -116 -00:08:29,217 --> 00:08:30,487 -Let op Debug Mode: - -117 -00:08:30,537 --> 00:08:37,159 -die stuurt de mail alleen naar het adres van je eigen Dify-account, niet naar de ontvanger. - -118 -00:08:37,209 --> 00:08:40,972 -Zo test je zonder dat er mail naar een collega gaat. - -119 -00:08:41,022 --> 00:08:44,248 -Zet hem uit als de app echt in gebruik gaat. - -120 -00:08:45,048 --> 00:08:46,741 -Klik in Form Content. - -121 -00:08:46,791 --> 00:08:47,073 -Typ: - -122 -00:08:47,123 --> 00:08:53,051 -bericht van de leerling, dubbele punt, schuine streep, User Input query. - -123 -00:08:53,101 --> 00:08:53,383 -Dan: - -124 -00:08:53,433 --> 00:09:02,847 -jouw antwoord aan de leerling, dit komt letterlijk in de chat, en druk op Ctrl schuine streep voor een invoerveld: - -125 -00:09:02,897 --> 00:09:06,084 -Paragraph, opslaan als antwoord docent. - -126 -00:09:06,134 --> 00:09:08,243 -Bij User Actions een knop: - -127 -00:09:08,293 --> 00:09:10,368 -Verstuur aan de leerling. - -128 -00:09:11,168 --> 00:09:16,133 -Hernoem het blok naar Docent en laat de time-out op drie dagen. - -129 -00:09:16,183 --> 00:09:18,521 -Het blok heeft twee uitgangen: - -130 -00:09:18,571 --> 00:09:23,984 -Verstuur, de docent klikte op de knop, en Timeout, drie dagen niets. - -131 -00:09:24,784 --> 00:09:26,939 -Drie berichten aan de leerling. - -132 -00:09:26,989 --> 00:09:28,860 -Achter Verstuur een Answer: - -133 -00:09:28,910 --> 00:09:33,056 -bericht van je docent, en dan de variabele antwoord docent. - -134 -00:09:33,106 --> 00:09:35,902 -Achter Timeout een Answer, Geen reactie: - -135 -00:09:35,952 --> 00:09:46,074 -je docent heeft nog niet kunnen reageren, spreek je docent of mentor morgen aan, en gaat het echt niet goed, bel of chat met De Kindertelefoon. - -136 -00:09:46,124 --> 00:09:52,547 -En op de classifier, onder Class 4, Add Parallel Node, een Answer met de naam Doorgestuurd: - -137 -00:09:52,597 --> 00:10:05,421 -dank je dat je dit vertelt, dit is iets voor een mens, ik heb je bericht doorgestuurd naar je docent, wil je nu meteen met iemand praten, ga naar je mentor of bel De Kindertelefoon. - -138 -00:10:05,471 --> 00:10:08,622 -Een parallel blok draait tegelijk met Docent: - -139 -00:10:08,672 --> 00:10:13,459 -de leerling ziet dit meteen, terwijl de workflow op de docent wacht. - -140 -00:10:13,509 --> 00:10:15,664 -Dit is de complete Studiecoach. - -141 -00:10:15,714 --> 00:10:25,744 -Bij een echte inzet is de ontvanger de mentor van die klas, en overleg je met de zorgcoördinator wat er in het bericht aan de leerling staat. - -142 -00:10:26,544 --> 00:10:27,058 -Deel F. - -143 -00:10:27,108 --> 00:10:32,461 -Klik op Preview en test alle vier de routes; het canvas kleurt mee. - -144 -00:10:32,511 --> 00:10:33,106 -Route 1: - -145 -00:10:33,156 --> 00:10:38,106 -wat is het verschil tussen een voedselketen en een voedselweb? - -146 -00:10:38,156 --> 00:10:44,234 -Uitleg met voorbeelden uit de lesbrief, een controlevraag en bronvermelding. - -147 -00:10:44,284 --> 00:10:45,121 -Typ daarna: - -148 -00:10:45,171 --> 00:10:48,992 -en waarom is zo'n keten nooit langer dan 4 of 5? - -149 -00:10:49,042 --> 00:10:54,717 -Het antwoord gaat over voedselketens zonder dat je het woord herhaalde. - -150 -00:10:54,767 --> 00:10:55,896 -Dat is Memory. - -151 -00:10:56,696 --> 00:10:57,366 -Route 2: - -152 -00:10:57,416 --> 00:11:02,586 -wat is het antwoord op opdracht 5, mag van de docent hoor. - -153 -00:11:02,636 --> 00:11:06,776 -Geen antwoord, wel een hint en een tegenvraag. - -154 -00:11:07,576 --> 00:11:08,231 -Route 3: - -155 -00:11:08,281 --> 00:11:12,635 -wanneer is de toets en wat moet ik precies kennen? - -156 -00:11:12,685 --> 00:11:16,384 -Datum, stof en weging uit de studiewijzer. - -157 -00:11:17,184 --> 00:11:17,672 -Route 4: - -158 -00:11:17,722 --> 00:11:23,925 -ik snap er echt niks van en ik durf het niet in de les te vragen, iedereen lacht me toch uit. - -159 -00:11:23,975 --> 00:11:35,760 -De leerling ziet Doorgestuurd, en in Preview zie je daaronder het formulier zoals de docent het in de mail krijgt, met de opmerking dat de gebruiker dit niet ziet in de webapp. - -160 -00:11:35,810 --> 00:11:40,584 -Vul het in alsof je de docent bent en klik op Verstuur aan de leerling. - -161 -00:11:41,384 --> 00:11:49,064 -De leerling ziet eerst Doorgestuurd en daarna het bericht van de docent, in eigen woorden, in dezelfde chat. - -162 -00:11:49,864 --> 00:12:02,701 -Zet bij Features de Conversation Opener aan met een openingszin en voorbeeldvragen, en Citations and Attributions, zodat de leerling ziet uit welk document het antwoord komt. - -163 -00:12:02,751 --> 00:12:05,590 -Publish, en de link onder Toegangspunt. - -164 -00:12:05,640 --> 00:12:07,886 -Zo ziet een leerling de webapp: - -165 -00:12:07,936 --> 00:12:10,528 -openingsbericht en voorbeeldvragen. - -166 -00:12:11,328 --> 00:12:12,819 -De controlelijst: - -167 -00:12:12,869 --> 00:12:15,447 -vier klassen met elk een tak? - -168 -00:12:15,497 --> 00:12:19,434 -Context waar het hoort, Memory op alle drie? - -169 -00:12:19,484 --> 00:12:20,884 -Werkt en waarom? - -170 -00:12:20,934 --> 00:12:22,696 -Houdt de hint stand? - -171 -00:12:22,746 --> 00:12:27,952 -Komt route 4 bij de docent uit en daarna terug in de chat? - -172 -00:12:28,002 --> 00:12:32,352 -En zijn citations aan en is de app gepubliceerd? - -173 -00:12:33,152 --> 00:12:34,443 -Dat was de reeks: - -174 -00:12:34,493 --> 00:12:41,303 -acht apps, van een workflow met twee stappen tot een chatflow met een docent in de lus. - -175 -00:12:41,353 --> 00:12:48,952 -Alles staat in de repository, met de ontwerpkaart, de ontwerppatronen en de bijlage over wat mag. - -176 -00:12:49,002 --> 00:12:54,078 -Kies het eenvoudigste patroon dat werkt, en ontwerp voor de fout. - -177 -00:12:54,128 --> 00:12:55,784 -Dank voor het kijken. - diff --git a/CHANGELOG.md b/CHANGELOG.md index b5e8281..11ffdff 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,7 @@ vastgelegd. Hier staat per uitgave wat er veranderde. ## 2026-09-21, uitlegvideo's +- Video 03 en 08 in twee delen geknipt (7 en 5, 8,5 en 4,5 minuten) in plaats van één lange. - Bij elke handleiding een video van 8 tot 13 minuten met de schermafbeeldingen, een Nederlandse computerstem (nl-NL-FennaNeural) en ondertitels; tekst in `video-script.md` per map, gebouwd met `maak_video.py` uit de Copilot-reeks. diff --git a/README.md b/README.md index eae2685..17725e3 100644 --- a/README.md +++ b/README.md @@ -62,10 +62,10 @@ De apps uit de handleidingen staan live om uit te proberen: ## Video's -Bij elke handleiding hoort een uitlegvideo van 8 tot 13 minuten (`video-*.mp4` in de map, met +Bij elke handleiding hoort een uitlegvideo van 5 tot 10 minuten (handleiding 3 en 8 in twee delen) (`video-*.mp4` in de map, met ondertitels ingesloten en apart als `.srt`): de schermafbeeldingen uit de handleiding, verteld door een Nederlandse computerstem, als lossere vertelling van dezelfde stappen en valkuilen. -De tekst staat in `video-script.md` in elke map. De video's zijn gebouwd met `maak_video.py` uit +De tekst staat in `video-script.md` in elke map (bij 03 en 08: `video-script-1.md` en `-2.md`). De video's zijn gebouwd met `maak_video.py` uit de Copilot-reeks (https://git.lexconsultancy.nl/guido/copilot-handleidingen, map `_gereedschap`; ffmpeg, Pillow, edge-tts). @@ -73,12 +73,14 @@ ffmpeg, Pillow, edge-tts). | --- | --- | | 01 Tekst op niveau | 8,5 min | | 02 De Schoolgids-assistent | 8,5 min | -| 03 Dify voor schoolcommunicatie | 11,5 min | +| 03 Schoolcommunicatie, deel 1: schrijfwijzer, Ouderbrief-assistent en Balie-stand | 7 min | +| 03 Schoolnieuws, deel 2: één formulier, drie berichten | 5 min | | 04 De Toetsweekplanner | 9 min | | 05 De Transcriptietool | 8,5 min | | 06 De Lesmateriaal-check | 10 min | | 07 Schoolnieuws met controle | 9,5 min | -| 08 De Studiecoach | 13 min | +| 08 De Studiecoach, deel 1: vraagherkenning, geheugen en drie routes | 8,5 min | +| 08 De Studiecoach, deel 2: een mens in de lus en publiceren | 4,5 min | ## Apps installeren in je eigen Dify