dify-handleidingen/02-agent-kennisbank/video-schoolgids-assistent.srt

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.