1 00:00:00,000 --> 00:00:05,434 Welkom bij de tweede handleiding van de reeks AI Agents met Dify voor school. 2 00:00:05,484 --> 00:00:10,206 In handleiding 1 bouwde je een workflow, en jij bepaalde elke stap. 3 00:00:10,256 --> 00:00:11,702 Nu bouw je een agent. 4 00:00:11,752 --> 00:00:20,676 Die krijgt een doel, een instructie en een kennisbank met jouw eigen document, en beslist zelf wanneer hij daarin gaat zoeken. 5 00:00:20,726 --> 00:00:32,976 Aan het eind heb je een chatbot met een eigen webadres die vragen over jouw document beantwoordt, met bronvermelding, en eerlijk zegt wanneer het antwoord er niet in staat. 6 00:00:33,776 --> 00:00:37,741 Je hebt een document nodig dat de agent moet kennen. 7 00:00:37,791 --> 00:00:44,225 Wij gebruiken een fictieve schoolgids van twee pagina's, die bij de handleiding zit. 8 00:00:44,275 --> 00:00:48,163 Kies je een eigen document, let dan op drie dingen: 9 00:00:48,213 --> 00:00:54,879 echte tekst en geen gescande afbeeldingen, geen persoonsgegevens, en liefst met kopjes. 10 00:00:54,929 --> 00:00:58,817 Alles wat je uploadt, staat op de servers van Dify. 11 00:00:58,867 --> 00:01:01,287 De handleiding heeft twee delen. 12 00:01:01,337 --> 00:01:05,120 Eerst de kennisbank, dan de agent die erin zoekt. 13 00:01:05,920 --> 00:01:12,477 Klik in het linkermenu op Knowledge en dan op Een gebruiksklare kennisbank maken. 14 00:01:12,527 --> 00:01:17,698 Laat Import from file staan, klik op Browse en kies je document. 15 00:01:17,748 --> 00:01:18,808 Klik op Next. 16 00:01:19,608 --> 00:01:23,264 Nu komt de stap die de kwaliteit bepaalt. 17 00:01:23,314 --> 00:01:27,060 Dify knipt je document in stukken, chunks. 18 00:01:27,110 --> 00:01:32,845 De agent zoekt straks in die stukken, niet in het hele document. 19 00:01:32,895 --> 00:01:34,834 Klik op Preview Chunk. 20 00:01:34,884 --> 00:01:42,065 Zie je veel stukken van één regel, zoals 1 punt Lestijden, of een losse lestijd? 21 00:01:42,115 --> 00:01:45,138 Dan knipt Dify op elke regeleinde. 22 00:01:45,188 --> 00:01:47,579 Dat gebeurt vaak bij PDF's. 23 00:01:47,629 --> 00:01:49,387 Hier zijn het er 46. 24 00:01:49,437 --> 00:01:54,408 Een stuk van twaalf tekens kan geen vraag beantwoorden. 25 00:01:55,208 --> 00:02:01,709 Klik in het veld Delimiter en vervang de inhoud door twee keer backslash n: 26 00:02:01,759 --> 00:02:05,989 dan knipt Dify op een lege regel, dus per alinea. 27 00:02:06,039 --> 00:02:08,610 Klik opnieuw op Preview Chunk. 28 00:02:08,660 --> 00:02:12,279 Nu zijn het vier stukken met echte inhoud. 29 00:02:12,329 --> 00:02:14,200 De rest laat je staan: 30 00:02:14,250 --> 00:02:19,878 maximum chunk length 1024, overlap 50, index method High Quality. 31 00:02:19,928 --> 00:02:22,112 Klik op Save and Process. 32 00:02:22,912 --> 00:02:26,275 Bij twee pagina's duurt dit een paar seconden. 33 00:02:26,325 --> 00:02:34,289 De status springt van Embedding Processing naar Embedding Completed, met een groen vinkje achter je bestand. 34 00:02:34,339 --> 00:02:39,904 Klik op Go to document; je document staat in de lijst met status Available. 35 00:02:40,704 --> 00:02:43,375 Klik in het linkermenu op Settings. 36 00:02:43,425 --> 00:02:49,437 Geef de kennisbank een naam, Schoolgids Voorbeeldcollege, en een beschrijving. 37 00:02:49,487 --> 00:02:52,080 Die beschrijving is niet voor jou. 38 00:02:52,130 --> 00:02:57,832 De agent leest hem om te beslissen of hij deze kennisbank moet raadplegen. 39 00:02:57,882 --> 00:03:00,242 Schrijf dus waar hij over gaat: 40 00:03:00,292 --> 00:03:13,300 gebruik deze kennisbank voor vragen over de schoolregels van Het Voorbeeldcollege, lestijden, ziek melden, verzuim en verlof, huiswerk en toetsen, telefoons, mentoraat. 41 00:03:13,350 --> 00:03:16,848 Scroll helemaal naar beneden en klik op Save. 42 00:03:17,648 --> 00:03:22,186 Dit is het moment waarop je ziet wat een kennisbank doet. 43 00:03:22,236 --> 00:03:25,648 Klik op Retrieval Testing en typ een vraag: 44 00:03:25,698 --> 00:03:28,787 hoe laat moet ik mijn kind ziek melden? 45 00:03:28,837 --> 00:03:29,833 Klik op Test. 46 00:03:29,883 --> 00:03:37,561 Je krijgt geen antwoord, maar de stukken tekst die het beste bij je vraag passen, met een score. 47 00:03:37,611 --> 00:03:44,242 Het stuk met de ziekmeldregels staat bovenaan met 0,86; de andere twee scoren laag. 48 00:03:44,292 --> 00:03:45,288 Zo hoort het. 49 00:03:45,338 --> 00:03:50,168 Staat het juiste stuk er niet bij, ga dan terug naar stap 2. 50 00:03:50,968 --> 00:03:51,803 Nu deel B. 51 00:03:51,853 --> 00:03:58,791 Klik op Studio, Create, Create from Blank, More basic app types, en kies Agent. 52 00:03:58,841 --> 00:03:59,234 Naam: 53 00:03:59,284 --> 00:04:01,091 Schoolgids-assistent. 54 00:04:01,141 --> 00:04:02,418 Klik op Create. 55 00:04:02,468 --> 00:04:07,195 Naast Orchestrate staat een oranje label Legacy Agent. 56 00:04:07,245 --> 00:04:11,088 Schrik daar niet van; de agent werkt gewoon. 57 00:04:11,138 --> 00:04:19,984 Dify bouwt aan een nieuwe manier om agents te maken, de Agent Console, en die komt in handleiding 4. 58 00:04:20,784 --> 00:04:28,815 Ook hier staat het model standaard op gpt-5, en ook hier is dat vijf keer zo duur als nodig. 59 00:04:28,865 --> 00:04:33,432 Klik rechtsboven op de modelnaam en kies gpt-5-mini. 60 00:04:34,232 --> 00:04:37,921 Bij een workflow schreef je per stap een prompt. 61 00:04:37,971 --> 00:04:40,414 Een agent krijgt één instructie: 62 00:04:40,464 --> 00:04:43,842 wie hij is, wat hij mag en wat hij niet mag. 63 00:04:43,892 --> 00:04:45,400 Typ in Instructions: 64 00:04:45,450 --> 00:04:55,216 je bent de schoolgids-assistent van Het Voorbeeldcollege, je beantwoordt vragen van ouders en leerlingen over de schoolregels. 65 00:04:55,266 --> 00:04:56,462 Dan vier regels. 66 00:04:56,512 --> 00:05:01,137 Baseer je antwoord alleen op de schoolgids in je kennisbank. 67 00:05:01,187 --> 00:05:08,615 Staat het antwoord er niet in, zeg dan eerlijk dat je het niet weet en verwijs naar de receptie. 68 00:05:08,665 --> 00:05:11,420 Antwoord kort, maximaal vijf zinnen. 69 00:05:11,470 --> 00:05:14,146 En noem waar het kan het hoofdstuk. 70 00:05:14,196 --> 00:05:17,652 Die eerste twee regels zijn de belangrijkste. 71 00:05:17,702 --> 00:05:21,391 Zonder die regels verzint hij er vrolijk op los. 72 00:05:21,441 --> 00:05:23,417 De rest mag je veranderen: 73 00:05:23,467 --> 00:05:27,440 de rol, de toon, u of je, Engels op Engelse vragen. 74 00:05:28,240 --> 00:05:34,158 Klik bij Knowledge op Add, kies Schoolgids Voorbeeldcollege en klik op Add. 75 00:05:34,208 --> 00:05:37,072 De kennisbank hangt nu aan de agent. 76 00:05:37,872 --> 00:05:40,058 Rechts staat Debug and Preview: 77 00:05:40,108 --> 00:05:44,531 een chatvenster om met de agent te praten voordat hij live is. 78 00:05:44,581 --> 00:05:46,335 Stel twee soorten vragen: 79 00:05:46,385 --> 00:05:50,591 een die in het document staat, en een die er niet in staat. 80 00:05:50,641 --> 00:05:51,024 Eerst: 81 00:05:51,074 --> 00:05:55,641 mijn dochter heeft een toets gemist, wanneer kan ze die inhalen? 82 00:05:55,691 --> 00:06:02,544 Boven het antwoord verschijnt het label Used Knowledge, en in het antwoord staat het hoofdstuk. 83 00:06:03,344 --> 00:06:06,683 Klik op Used Knowledge om het open te klappen. 84 00:06:06,733 --> 00:06:07,935 Kijk bij Request: 85 00:06:07,985 --> 00:06:12,650 daar staat de zoekopdracht die de agent zelf heeft geformuleerd. 86 00:06:12,700 --> 00:06:17,660 Jij hebt hem niet gezegd dat hij moest zoeken, en ook niet waarnaar. 87 00:06:17,710 --> 00:06:23,628 Hij besloot dat zelf, op basis van je vraag en de beschrijving van de kennisbank. 88 00:06:23,678 --> 00:06:27,656 Dat is het verschil met de workflow van handleiding 1. 89 00:06:28,456 --> 00:06:29,869 Dan de tweede vraag: 90 00:06:29,919 --> 00:06:32,796 wat kost het schoolkamp van de brugklas? 91 00:06:32,846 --> 00:06:38,575 De agent zegt dat het niet in de schoolgids staat en verwijst naar de receptie. 92 00:06:38,625 --> 00:06:42,014 Dat komt door de tweede regel in je instructie. 93 00:06:42,064 --> 00:06:45,086 Haal die regel weg en probeer het opnieuw: 94 00:06:45,136 --> 00:06:48,136 dan krijg je een keurig verzonnen bedrag. 95 00:06:48,936 --> 00:06:51,039 Klik rechtsboven op Publish. 96 00:06:51,089 --> 00:06:52,962 Let op wat het menu zegt: 97 00:06:53,012 --> 00:06:59,346 Latest Published, een paar minuten geleden, terwijl je nog niets gepubliceerd hebt. 98 00:06:59,396 --> 00:07:04,653 Dify publiceert een Agent-app namelijk al bij het aanmaken, dus leeg. 99 00:07:04,703 --> 00:07:10,036 De versie met jouw instructie en kennisbank staat onder Current Draft. 100 00:07:10,086 --> 00:07:15,624 Sla je Publish Update over, dan opent de webapp een agent zonder kennis. 101 00:07:16,424 --> 00:07:18,288 Klik op Publish Update. 102 00:07:18,338 --> 00:07:23,912 De melding Success verschijnt en onder de knop staat nu Up to date. 103 00:07:24,712 --> 00:07:27,508 Klik op Webapp openen en typ een vraag: 104 00:07:27,558 --> 00:07:31,158 mag mijn zoon zijn telefoon gebruiken in de pauze? 105 00:07:31,208 --> 00:07:35,756 Onder het antwoord staat Citations met de naam van je document. 106 00:07:35,806 --> 00:07:42,520 Dat is de link die je aan een collega geeft; hij werkt zonder inloggen, ook op een telefoon. 107 00:07:43,320 --> 00:07:44,581 De controlelijst: 108 00:07:44,631 --> 00:07:49,905 staat de kennisbank op Available, met een handvol stukken per pagina? 109 00:07:49,955 --> 00:07:52,991 Vindt Retrieval Testing het juiste stuk? 110 00:07:53,041 --> 00:07:56,308 Staat er Used Knowledge boven het antwoord? 111 00:07:56,358 --> 00:07:59,008 Zegt hij het als hij het niet weet? 112 00:07:59,058 --> 00:08:01,245 En toont de webapp Citations? 113 00:08:01,295 --> 00:08:05,334 Gaat het mis, dan is het meestal een van vier dingen: 114 00:08:05,384 --> 00:08:15,336 de delimiter, een lege beschrijving van de kennisbank, de ontbrekende regel zeg dat je het niet weet, of Publish Update vergeten. 115 00:08:16,136 --> 00:08:24,279 De handleiding, de schoolgids en de beelden staan in de repository; de agent staat live op udify punt app. 116 00:08:24,329 --> 00:08:30,075 In de volgende video zetten we drie apps in elkaar voor schoolcommunicatie: 117 00:08:30,125 --> 00:08:34,404 de Ouderbrief-assistent, Schoolnieuws en de Balie-stand. 118 00:08:34,454 --> 00:08:35,072 Tot dan.