DSL-export van de agents 04 en 06; kennisbankbeschrijving 03 onder de 400 tekens

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-21 11:54:54 +02:00
parent 2feaede14e
commit 17f1e5461d
6 changed files with 505 additions and 3 deletions
@@ -136,13 +136,15 @@ De agent leest de beschrijving van de kennisbank om te beslissen of hij erin gaa
 2. Vervang de tekst bij **Description**.

 ```
-Twee documenten van Het Voorbeeldcollege. De schoolgids: lestijden, ziek melden, verzuim en verlof, huiswerk en toetsen, telefoons en laptops, mentoraat en contactgegevens. De schrijfwijzer: hoe de school schrijft aan ouders en op website, ouderapp en sociale media (taalniveau B1, u of je, te vermijden woorden, opbouw van een ouderbrief, lengte per kanaal, namen en foto's van leerlingen). Gebruik deze kennisbank bij vragen over schoolregels en bij het schrijven of nakijken van teksten voor ouders.
+Twee documenten van Het Voorbeeldcollege. Schoolgids: lestijden, ziek melden, verzuim en verlof, huiswerk en toetsen, telefoons en laptops, mentoraat, contact. Schrijfwijzer: hoe de school schrijft aan ouders, op website, ouderapp en sociale media (niveau B1, u of je, te vermijden woorden, opbouw ouderbrief, lengte per kanaal, foto's). Gebruik bij schoolregels en bij teksten voor ouders.
 ```

 ![De bijgewerkte beschrijving](beelden/a05-settings.jpg)

 3. Scroll naar beneden en klik op **Save**.

+> De beschrijving mag maximaal 400 tekens lang zijn. Is hij langer, dan slaat Dify hem niet op en zie je geen foutmelding; de oude tekst blijft staan. Tel dus even mee (de tekst hierboven is 390 tekens) en controleer na Save of de nieuwe tekst er staat.
+
 > **Zelf kiezen: de beschrijving.** Schrijf de beschrijving alsof je aan een nieuwe collega uitlegt wanneer die dit mapje moet openen. Noem de onderwerpen, niet de bestandsnamen. Test daarna met **Retrieval Testing** (linkermenu) of een vraag als "mag ik je zeggen tegen een ouder?" het juiste stuk bovenaan zet.

 ---
@@ -0,0 +1,250 @@
+agent:
+  package_ref: agent_1
+agent_packages:
+  agent_1:
+    metadata:
+      description: 'Maakt met de leerling een persoonlijk studieplan voor de toetsweek:
+        verdeelt de toetsstof over de beschikbare momenten en levert het plan als
+        Excel en als agendabestand.'
+      icon: 🧸
+      icon_background: '#F5F3FF'
+      icon_type: emoji
+      name: Toetsweekplanner
+      role: Studieplanner voor leerlingen onderbouw
+    omitted_assets:
+    - hash: 9f2bc690949fca0b68eadb24f674c9502f1784aeed4cb08e1b7b2cebc7f8b60c
+      kind: file
+      mime_type: text/csv
+      name: toetsrooster-voorbeeld.csv
+      size: 608
+    schema_version: 1
+    soul:
+      app_features:
+        file_upload:
+          allowed_file_extensions:
+          - JPG
+          - JPEG
+          - PNG
+          - GIF
+          - WEBP
+          - SVG
+          allowed_file_types:
+          - document
+          - image
+          - audio
+          - video
+          allowed_file_upload_methods:
+          - local_file
+          - remote_url
+          enabled: true
+          image:
+            enabled: true
+          number_limits: 3
+        opening_statement: null
+        retriever_resource: null
+        sensitive_word_avoidance: null
+        speech_to_text: null
+        suggested_questions: null
+        suggested_questions_after_answer: null
+        text_to_speech: null
+      app_variables: []
+      config_files:
+      - file_id: ''
+        file_kind: upload_file
+        hash: 9f2bc690949fca0b68eadb24f674c9502f1784aeed4cb08e1b7b2cebc7f8b60c
+        is_missing: true
+        mime_type: text/csv
+        name: toetsrooster-voorbeeld.csv
+        size: 608
+      config_note: ''
+      config_skills: []
+      env:
+        secret_refs: []
+        variables: []
+      human:
+        contacts: []
+        tools: []
+      knowledge:
+        sets: []
+      memory:
+        artifacts: []
+        budget: null
+        scope: null
+      misc_legacy:
+        file_upload:
+          allowed_file_extensions:
+          - JPG
+          - JPEG
+          - PNG
+          - GIF
+          - WEBP
+          - SVG
+          allowed_file_types:
+          - document
+          - image
+          - audio
+          - video
+          allowed_file_upload_methods:
+          - local_file
+          - remote_url
+          enabled: true
+          image:
+            enabled: true
+          number_limits: 3
+        opening_statement: null
+        retriever_resource: null
+        sensitive_word_avoidance: null
+        speech_to_text: null
+        suggested_questions: null
+        suggested_questions_after_answer: null
+        text_to_speech: null
+      model:
+        credential_ref: null
+        model: gpt-5.4
+        model_provider: langgenius/openai/openai
+        model_settings:
+          frequency_penalty: null
+          max_tokens: null
+          presence_penalty: null
+          response_format: null
+          stop: null
+          temperature: null
+          top_p: null
+        plugin_id: langgenius/openai
+      prompt:
+        system_prompt: 'Je bent de Toetsweekplanner voor leerlingen in de onderbouw
+          van het voortgezet onderwijs. Je helpt een leerling een persoonlijk studieplan
+          te maken voor de toetsweek. Je spreekt de leerling aan met je, in korte
+          zinnen en gewoon Nederlands.
+
+
+          Wat je nodig hebt van de leerling:
+
+          1. Het toetsrooster. Staat het al in je bestanden (toetsrooster-voorbeeld.csv),
+          gebruik dat en vat het kort samen; anders vraag je ernaar.
+
+          2. De momenten waarop de leerling kan leren, per dag, vanaf vandaag tot
+          de laatste toets.
+
+          3. Per vak hoe moeilijk de leerling het vindt: makkelijk, gemiddeld of moeilijk.
+
+
+          Stel deze vragen een voor een, niet allemaal tegelijk. Ga pas plannen als
+          je alle drie hebt.
+
+
+          Planregels:
+
+          - Moeilijke vakken krijgen ongeveer twee keer zoveel tijd als makkelijke
+          vakken.
+
+          - Elk vak komt minstens twee keer terug, met minimaal een dag ertussen;
+          de laatste keer is de dag voor de toets.
+
+          - Een leerblok duurt 25 tot 45 minuten, met daarna 10 minuten pauze. Nooit
+          meer dan drie blokken achter elkaar.
+
+          - De avond voor een toets alleen herhalen, geen nieuwe stof.
+
+          - Plan niets op momenten die de leerling niet heeft opgegeven.
+
+
+          Wat je oplevert:
+
+          - Een overzicht in de chat: per dag de blokken met vak, tijd en wat er precies
+          geleerd wordt (welke hoofdstukken of paragrafen).
+
+          - Twee bestanden die je in de sandbox maakt: studieplan.xlsx (per rij: dag,
+          datum, begintijd, eindtijd, vak, stof) en studieplan.ics (elk leerblok als
+          agenda-afspraak), zodat de leerling het plan in de telefoonagenda kan zetten.
+
+          - Sluit af met een vraag of de leerling iets wil verschuiven.
+
+
+          Je geeft geen cijfers, oordelen of voorspellingen over hoe de toetsen zullen
+          gaan. Je bewaart niets over de leerling na het gesprek.'
+      sandbox:
+        config:
+          cpu: null
+          env: []
+          image: null
+          working_dir: null
+        provider: null
+      schema_version: 1
+      tools:
+        cli_tools: []
+        dify_tools:
+        - credential_ref: null
+          credential_type: unauthorized
+          description: null
+          enabled: true
+          name: null
+          plugin_id: null
+          provider: time
+          provider_id: time
+          provider_type: builtin
+          runtime_parameters: {}
+          tool_name: current_time
+        - credential_ref: null
+          credential_type: unauthorized
+          description: null
+          enabled: true
+          name: null
+          plugin_id: null
+          provider: time
+          provider_id: time
+          provider_type: builtin
+          runtime_parameters: {}
+          tool_name: localtime_to_timestamp
+        - credential_ref: null
+          credential_type: unauthorized
+          description: null
+          enabled: true
+          name: null
+          plugin_id: null
+          provider: time
+          provider_id: time
+          provider_type: builtin
+          runtime_parameters: {}
+          tool_name: timestamp_to_localtime
+        - credential_ref: null
+          credential_type: unauthorized
+          description: null
+          enabled: true
+          name: null
+          plugin_id: null
+          provider: time
+          provider_id: time
+          provider_type: builtin
+          runtime_parameters: {}
+          tool_name: timezone_conversion
+        - credential_ref: null
+          credential_type: unauthorized
+          description: null
+          enabled: true
+          name: null
+          plugin_id: null
+          provider: time
+          provider_id: time
+          provider_type: builtin
+          runtime_parameters: {}
+          tool_name: weekday
+    workspace_skills: []
+app:
+  description: 'Maakt met de leerling een persoonlijk studieplan voor de toetsweek:
+    verdeelt de toetsstof over de beschikbare momenten en levert het plan als Excel
+    en als agendabestand.'
+  icon: 🧸
+  icon_background: '#F5F3FF'
+  icon_type: emoji
+  mode: agent
+  name: Toetsweekplanner
+  use_icon_as_answer_icon: false
+dependencies:
+- current_identifier: null
+  type: marketplace
+  value:
+    marketplace_plugin_unique_identifier: langgenius/openai:1.0.5@51583313a5988d5dca405063831ffeeacdc1f2e95f32a8c10b4c281ceef39ebb
+    version: null
+kind: app
+version: 0.7.0
@@ -0,0 +1,242 @@
+agent:
+  package_ref: agent_1
+agent_packages:
+  agent_1:
+    metadata:
+      description: Beoordeelt lesmateriaal op toegankelijkheid voor leerlingen met
+        een ondersteuningsbehoefte (UDL), maakt aangepaste versies voor docent en
+        leerling en zoekt open leermateriaal op Wikiwijs.
+      icon: 🧸
+      icon_background: '#F5F3FF'
+      icon_type: emoji
+      name: Lesmateriaal-check
+      role: Toegankelijkheidscoach voor lesmateriaal
+    omitted_assets:
+    - hash: fae3fc0910c5e1c43a03b78d79ca02142fea6c82871a0dab9d3c660d85093b1b
+      kind: file
+      mime_type: application/pdf
+      name: lesbrief-ecologie.pdf
+      size: 79082
+    schema_version: 1
+    soul:
+      app_features:
+        file_upload:
+          allowed_file_extensions:
+          - JPG
+          - JPEG
+          - PNG
+          - GIF
+          - WEBP
+          - SVG
+          allowed_file_types:
+          - document
+          - image
+          - audio
+          - video
+          allowed_file_upload_methods:
+          - local_file
+          - remote_url
+          enabled: true
+          image:
+            enabled: true
+          number_limits: 3
+        opening_statement: null
+        retriever_resource: null
+        sensitive_word_avoidance: null
+        speech_to_text: null
+        suggested_questions: null
+        suggested_questions_after_answer: null
+        text_to_speech: null
+      app_variables: []
+      config_files:
+      - file_id: ''
+        file_kind: upload_file
+        hash: fae3fc0910c5e1c43a03b78d79ca02142fea6c82871a0dab9d3c660d85093b1b
+        is_missing: true
+        mime_type: application/pdf
+        name: lesbrief-ecologie.pdf
+        size: 79082
+      config_note: ''
+      config_skills: []
+      env:
+        secret_refs: []
+        variables: []
+      human:
+        contacts: []
+        tools: []
+      knowledge:
+        sets: []
+      memory:
+        artifacts: []
+        budget: null
+        scope: null
+      misc_legacy:
+        file_upload:
+          allowed_file_extensions:
+          - JPG
+          - JPEG
+          - PNG
+          - GIF
+          - WEBP
+          - SVG
+          allowed_file_types:
+          - document
+          - image
+          - audio
+          - video
+          allowed_file_upload_methods:
+          - local_file
+          - remote_url
+          enabled: true
+          image:
+            enabled: true
+          number_limits: 3
+        opening_statement: null
+        retriever_resource: null
+        sensitive_word_avoidance: null
+        speech_to_text: null
+        suggested_questions: null
+        suggested_questions_after_answer: null
+        text_to_speech: null
+      model:
+        credential_ref: null
+        model: gpt-5.4
+        model_provider: langgenius/openai/openai
+        model_settings:
+          frequency_penalty: null
+          max_tokens: null
+          presence_penalty: null
+          response_format: null
+          stop: null
+          temperature: null
+          top_p: null
+        plugin_id: langgenius/openai
+      prompt:
+        system_prompt: 'Je bent de Lesmateriaal-check: een coach die docenten helpt
+          hun lesmateriaal toegankelijk te maken voor alle leerlingen, ook leerlingen
+          met een ondersteuningsbehoefte. Je werkt volgens Universal Design for Learning
+          (UDL): meerdere manieren om informatie aan te bieden, meerdere manieren
+          om te laten zien wat je geleerd hebt, en meerdere manieren om betrokken
+          te raken. Je spreekt de docent aan met je, zakelijk en zonder jargon.
+
+
+          Zo werk je:
+
+          1. Vraag om het lesmateriaal als het er nog niet is. Staat er al een bestand
+          in je bestanden (lesbrief-ecologie.pdf), gebruik dat dan als de docent niets
+          uploadt.
+
+          2. Vraag welke ondersteuningsbehoeften in de klas voorkomen. Bied deze keuzes:
+          dyslexie, taalzwak of NT2, TOS (taalontwikkelingsstoornis), moeite met concentratie
+          of executieve functies, hoogbegaafd, slechtziend of screenreader. De docent
+          mag er meerdere kiezen en mag "weet ik niet" zeggen; dan neem je dyslexie
+          en taalzwak/NT2 als uitgangspunt.
+
+          3. Beoordeel het materiaal. Geef een kort rapport met per punt een score
+          (goed, matig, zwak) en een zin uitleg: zinslengte en leesniveau, vakbegrippen
+          en of ze worden uitgelegd, structuur en kopjes, voorkennis die stilzwijgend
+          wordt verwacht, visuele ondersteuning (schema''s, tekeningen), variatie
+          in verwerking (alleen lezen of ook doen), en of een leerling zelf kan kiezen
+          hoe hij laat zien wat hij geleerd heeft.
+
+          4. Maak op basis van de gekozen ondersteuningsbehoeften bestanden in je
+          sandbox en lever ze op:
+
+          - docent-notitie.md: per gekozen ondersteuningsbehoefte drie concrete aanpassingen
+          in de les (niet in de tekst), plus wat je in de tekst hebt veranderd en
+          waarom.
+
+          - leerling-versie-toegankelijk.md: dezelfde inhoud als het materiaal, maar
+          met korte zinnen (maximaal 15 woorden), elk vakbegrip bij de eerste keer
+          uitgelegd, een begrippenlijst bovenaan, tussenkopjes per alinea, en na elke
+          paragraaf een controlevraag. Laat geen inhoud weg; vereenvoudig de vorm,
+          niet de stof.
+
+          - leerling-versie-verdieping.md, alleen als hoogbegaafd is gekozen: dezelfde
+          stof met twee verdiepende vragen per paragraaf en een onderzoeksopdracht.
+
+          5. Zoek open leermateriaal met de tool Edurep zoeken. Verbind de zoekwoorden
+          met AND, bijvoorbeeld: ecologie AND voedselweb AND meta.repository.id exact
+          wikiwijsmaken (het laatste deel beperkt tot Wikiwijs). Doe twee of drie
+          zoekopdrachten met verschillende kernbegrippen. Kies uit de resultaten maximaal
+          vijf bronnen die passen bij het onderwerp en het niveau, en geef per bron:
+          titel, webadres, licentie, en voor welke ondersteuningsbehoefte dit materiaal
+          helpt (bijvoorbeeld: veel beeld, korte teksten, oefeningen). Noem alleen
+          bronnen die echt in de zoekresultaten stonden; verzin geen bronnen.
+
+          6. Koppel het materiaal aan het landelijke curriculum met de tool SLO leerdoelen:
+          zoek op twee of drie kernbegrippen (bijvoorbeeld: voedselweb, kringloop)
+          met Accept application/json. Geef onder het kopje "Leerdoelen (SLO)" maximaal
+          vijf doelen uit de resultaten (@type Doel of Kerndoel) die het materiaal
+          dekt, letterlijk geciteerd, en noem één doel uit de resultaten dat het materiaal
+          niet of nauwelijks raakt. Noem alleen doelen die in de resultaten stonden.
+
+          7. Sluit af met de vraag of de docent een van de versies wil aanpassen,
+          of een andere ondersteuningsbehoefte wil toevoegen.
+
+
+          Regels:
+
+          - Je verandert de leerdoelen en de stof niet; je verandert de vorm.
+
+          - Je noemt geen namen van leerlingen en je vraagt er niet naar. Je werkt
+          met behoeften, niet met diagnoses van personen.
+
+          - Je geeft geen medisch of psychologisch advies en stelt geen diagnoses.
+
+          - Vermeld bij open leermateriaal altijd de licentie en de bron; bij CC BY-SA
+          moet een bewerking onder dezelfde licentie gedeeld worden, zeg dat erbij.
+
+          - Alle bestanden schrijf je in het Nederlands, in markdown.'
+      sandbox:
+        config:
+          cpu: null
+          env: []
+          image: null
+          working_dir: null
+        provider: null
+      schema_version: 1
+      tools:
+        cli_tools: []
+        dify_tools:
+        - credential_ref: null
+          credential_type: unauthorized
+          description: null
+          enabled: true
+          name: null
+          plugin_id: null
+          provider: Edurep zoeken
+          provider_id: 63c42578-cc2d-4037-a8d7-1c6b191cd56d
+          provider_type: api
+          runtime_parameters: {}
+          tool_name: zoekOpenLeermateriaal
+        - credential_ref: null
+          credential_type: unauthorized
+          description: null
+          enabled: true
+          name: null
+          plugin_id: null
+          provider: SLO leerdoelen
+          provider_id: 8c398625-30ee-4184-856f-f83f181fc582
+          provider_type: api
+          runtime_parameters: {}
+          tool_name: zoekLeerdoelen
+    workspace_skills: []
+app:
+  description: Beoordeelt lesmateriaal op toegankelijkheid voor leerlingen met een
+    ondersteuningsbehoefte (UDL), maakt aangepaste versies voor docent en leerling
+    en zoekt open leermateriaal op Wikiwijs.
+  icon: 🧸
+  icon_background: '#F5F3FF'
+  icon_type: emoji
+  mode: agent
+  name: Lesmateriaal-check
+  use_icon_as_answer_icon: false
+dependencies:
+- current_identifier: null
+  type: marketplace
+  value:
+    marketplace_plugin_unique_identifier: langgenius/openai:1.0.5@51583313a5988d5dca405063831ffeeacdc1f2e95f32a8c10b4c281ceef39ebb
+    version: null
+kind: app
+version: 0.7.0
@@ -5,6 +5,8 @@ vastgelegd. Hier staat per uitgave wat er veranderde.

 ## 2026-09-21, DSL-bestanden

+- Ook de agents van 04 en 06 als `.dify.yml` (Toetsweekplanner, Lesmateriaal-check); bestanden en eigen tools komen niet mee, zie de README.
+- Handleiding 03, stap 4: de beschrijving van de kennisbank ingekort tot onder de 400 tekens, de grens die Dify zonder melding hanteert; de kennisbank zelf is bijgewerkt.
 - Elke Studio-app staat als `.dify.yml` in de map van zijn handleiding, te importeren via Studio, Create, Import DSL file. Installatie-instructie in de README.

 ## 2026-09-20, eerste uitgave
@@ -73,8 +73,12 @@ DSL-export van Dify. Zo zet je hem in je eigen werkruimte (online of zelf gehost
   voorbeelddocument uit dezelfde map (handleiding 02, stap 1 tot 5).
 5. **Publish**.

-De bestanden bevatten geen sleutels. De Agent Console-apps van 04 en 06 kennen (nog) geen export;
-die bouw je met de handleiding na.
+De bestanden bevatten geen sleutels. Een Agent Console-app (04, 06) importeer je op dezelfde
+manier, maar vanaf de pagina **Agents** (**Create**, **Import DSL file**). De export van een agent
+noemt het geüploade bestand wel, maar bevat het niet: upload na het importeren de CSV of PDF uit de
+map van de handleiding opnieuw onder **FILES**. Voor 06 maak je eerst de twee eigen tools aan
+(Integrations, Swagger API as Tool, schema's uit de map; de SLO-tool met je eigen sleutel) en zet
+je ze opnieuw onder **TOOLS**.

 | Bestand | Handleiding |
 | --- | --- |
@@ -82,7 +86,9 @@ die bouw je met de handleiding na.
 | 02-agent-kennisbank/schoolgids-assistent.dify.yml | 02 (inclusief de Balie-stand uit 03) |
 | 03-schoolcommunicatie/ouderbrief-assistent.dify.yml | 03 |
 | 03-schoolcommunicatie/schoolnieuws.dify.yml | 03 en 07 (versie 2, met Controleur en Poortwachter) |
+| 04-agent-console/toetsweekplanner.dify.yml | 04 (Agent Console; toetsrooster-voorbeeld.csv opnieuw uploaden) |
 | 05-transcriptietool/transcriptietool.dify.yml | 05 |
+| 06-inclusief-lesmateriaal/lesmateriaal-check.dify.yml | 06 (Agent Console; tools opnieuw aanmaken, lesbrief opnieuw uploaden) |
 | 08-chatflow-studiecoach/studiecoach-biologie.dify.yml | 08 |

 ## Zelf bouwen of bewerken