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