Guido van Dijk
5.3 KiB
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.