From 54f2c36eba40dc108e70252525f09d73028558d0 Mon Sep 17 00:00:00 2001 From: colinislit Date: Mon, 1 Dec 2025 16:14:30 +0100 Subject: [PATCH] finalize ai assistenat --- app/api/docs/chat/route.ts | 2 +- components/docs-chat/docs-chat-widget.tsx | 2 +- components/docs-chat/use-docs-chat.ts | 2 +- content/nl/documentatie/_index.json | 8 + .../ai-documentatie-assistent.mdx | 190 ++++++++++++++++++ 5 files changed, 201 insertions(+), 3 deletions(-) create mode 100644 content/nl/documentatie/ai-documentatie-assistent.mdx diff --git a/app/api/docs/chat/route.ts b/app/api/docs/chat/route.ts index 72817d1..48ebef3 100644 --- a/app/api/docs/chat/route.ts +++ b/app/api/docs/chat/route.ts @@ -6,7 +6,7 @@ import { detectCategories } from '@/lib/docs/category-detector' import { loadKnowledgeSections } from '@/lib/docs/knowledge-loader' import { buildSystemPrompt } from '@/lib/docs/prompt-builder' -const DOCS_ASSISTANT_MODEL = process.env.DOCS_ASSISTANT_MODEL ?? 'claude-3-5-sonnet-20240620' +const DOCS_ASSISTANT_MODEL = process.env.DOCS_ASSISTANT_MODEL ?? 'claude-sonnet-4-20250514' const MAX_HISTORY_MESSAGES = 10 const MAX_USER_MESSAGE_LENGTH = 2000 diff --git a/components/docs-chat/docs-chat-widget.tsx b/components/docs-chat/docs-chat-widget.tsx index 5bb6e46..3c5be97 100644 --- a/components/docs-chat/docs-chat-widget.tsx +++ b/components/docs-chat/docs-chat-widget.tsx @@ -65,7 +65,7 @@ export function DocsChatWidget() {

- Documentatie Assistent + EPD Assistent

Stel vragen over het EPD diff --git a/components/docs-chat/use-docs-chat.ts b/components/docs-chat/use-docs-chat.ts index 5f6f6e0..17bcc9e 100644 --- a/components/docs-chat/use-docs-chat.ts +++ b/components/docs-chat/use-docs-chat.ts @@ -44,7 +44,7 @@ const WELCOME_MESSAGE: ChatMessage = { id: 'welcome', role: 'assistant', content: - 'Hallo! Ik ben de documentatie assistent voor het Mini-EPD. Stel me een vraag over het systeem, bijvoorbeeld:\n\n• Hoe maak ik een intake aan?\n• Hoe werkt de spraakherkenning?\n• Waar vind ik het behandelplan?', + 'Hallo! Ik ben je EPD assistent voor het Mini-EPD. Stel me een vraag over het systeem, bijvoorbeeld:\n\n• Hoe maak ik een intake aan?\n• Hoe werkt de spraakherkenning?\n• Waar vind ik het behandelplan?', } /** diff --git a/content/nl/documentatie/_index.json b/content/nl/documentatie/_index.json index 474163b..c7bd40a 100644 --- a/content/nl/documentatie/_index.json +++ b/content/nl/documentatie/_index.json @@ -131,6 +131,14 @@ "order": 11, "status": "completed" }, + { + "slug": "ai-documentatie-assistent", + "title": "AI Documentatie Assistent", + "group": "features", + "description": "Chat widget voor hulp bij het gebruik van het EPD", + "order": 13, + "status": "completed" + }, { "slug": "voice-controlled-reporting", "title": "Spraakgestuurd Rapporteren (v2)", diff --git a/content/nl/documentatie/ai-documentatie-assistent.mdx b/content/nl/documentatie/ai-documentatie-assistent.mdx new file mode 100644 index 0000000..2b559ac --- /dev/null +++ b/content/nl/documentatie/ai-documentatie-assistent.mdx @@ -0,0 +1,190 @@ +--- +title: "AI Documentatie Assistent" +category: "ai-documentatie-assistent" +group: "features" +version: "1.0.0" +releaseDate: "2024-12-01" +status: "completed" +description: "Stel vragen over het EPD en krijg direct antwoord via de AI-gestuurde chat widget" +--- + +## Overview + +De AI Documentatie Assistent is een slimme chatbot die u helpt bij het gebruik van het Mini-EPD. Stel vragen in gewoon Nederlands en krijg direct antwoord over functies, procedures en navigatie binnen het systeem. + +**Kernvoordelen:** +- Direct antwoord op uw vragen over het EPD +- Beschikbaar op elke pagina binnen het EPD +- Begrijpt context en vervolgvragen +- Verwijst naar relevante menu's en knoppen + +--- + +## Hoe te gebruiken + +### Stap 1: Open de assistent + +Klik op de **oranje knop met sparkles-icoon** rechtsonder in het scherm. Deze knop is zichtbaar op alle pagina's binnen het EPD. + +**Wat u ziet:** +- Een chatvenster opent met een slide-in animatie +- Een welkomstbericht met voorbeeldvragen verschijnt +- De knop verandert in het chatvenster + +### Stap 2: Stel uw vraag + +Typ uw vraag in het tekstveld onderaan het chatvenster. Voorbeeldvragen: + +- "Hoe maak ik een nieuwe cliënt aan?" +- "Waar vind ik de screeningresultaten?" +- "Hoe start ik een intake?" +- "Hoe werkt de spraakherkenning?" + +**Tips voor betere antwoorden:** +- Stel specifieke vragen over één onderwerp +- Gebruik Nederlandse termen zoals die in het EPD staan +- Bij vervolgvragen hoeft u niet te herhalen - de assistent onthoudt de context + +### Stap 3: Verstuur de vraag + +Verstuur uw vraag op twee manieren: +- Druk op **Enter** op uw toetsenbord +- Klik op de **oranje verstuurknop** rechts van het tekstveld + +**Shift + Enter** voegt een nieuwe regel toe zonder te versturen. + +### Stap 4: Lees het antwoord + +Het antwoord verschijnt woord-voor-woord in het chatvenster. Dit streaming-effect toont dat de assistent actief aan het antwoorden is. + +**Herkenningspunten:** +- Uw vraag staat rechts (oranje achtergrond) +- Het antwoord staat links (grijze achtergrond) +- Tijdens het typen ziet u een knipperende cursor + +### Stap 5: Stel vervolgvragen + +U kunt direct vervolgvragen stellen. De assistent onthoudt de vorige vragen en antwoorden binnen de sessie. + +**Voorbeeld:** +1. "Hoe maak ik een intake aan?" +2. "En hoe voeg ik notities toe?" (de assistent begrijpt dat dit over intakes gaat) + +### Stap 6: Sluit het venster + +Klik op het **X-icoon** rechtsboven in het chatvenster om het te sluiten. De conversatie blijft bewaard zolang u ingelogd bent. + +--- + +## Functionaliteit + +### Onderwerpen waarover u kunt vragen + +De assistent kent de volgende onderwerpen: + +| Categorie | Voorbeeldvragen | +|-----------|-----------------| +| **Cliëntbeheer** | "Hoe zoek ik een cliënt?", "Hoe maak ik een dossier aan?" | +| **Intake** | "Hoe start ik een intake?", "Waar voeg ik notities toe?" | +| **Screening** | "Wat betekent de screeningscore?", "Welke vragenlijsten zijn er?" | +| **Behandelplan** | "Hoe maak ik een behandeldoel aan?", "Wat zijn interventies?" | +| **Spraakherkenning** | "Hoe gebruik ik de microfoon?", "Waarom werkt dicteren niet?" | +| **Inloggen** | "Hoe reset ik mijn wachtwoord?", "Waarom kan ik niet inloggen?" | +| **Interface** | "Waar vind ik het menu?", "Hoe navigeer ik naar rapportages?" | + +### Wat de assistent NIET doet + +De assistent is specifiek voor documentatie-hulp: + +- **Geen medisch advies** - Vraag geen behandelsuggesties of diagnoses +- **Geen data toegang** - De assistent kan geen cliëntgegevens inzien +- **Geen acties uitvoeren** - De assistent kan niets wijzigen in het EPD +- **Geen externe informatie** - Alleen EPD-documentatie wordt gebruikt + +### Streaming antwoorden + +Antwoorden verschijnen in real-time, woord voor woord. Dit zorgt voor: +- Snellere eerste feedback (binnen 2 seconden) +- Mogelijkheid om al te lezen terwijl het antwoord nog komt +- Visuele bevestiging dat de vraag wordt verwerkt + +### Sessie-geheugen + +De assistent onthoudt uw conversatie tijdens de huidige sessie: +- Vervolgvragen worden begrepen in context +- Na uitloggen wordt de conversatie gewist +- Bij herladen van de pagina blijft de conversatie behouden + +--- + +## Veelgestelde vragen + +### Waar vind ik de chatknop? + +De oranje knop met sparkles-icoon staat rechtsonder op elke EPD-pagina. Als u de knop niet ziet: +- Controleer of u bent ingelogd +- Scroll naar beneden (de knop is fixed gepositioneerd) + +### Waarom krijg ik geen antwoord? + +Mogelijke oorzaken: +- **Netwerkprobleem**: Controleer uw internetverbinding +- **Sessie verlopen**: Log opnieuw in +- **Te lange vraag**: Houd vragen onder 2000 karakters + +Bij aanhoudende problemen verschijnt een rode foutmelding in het chatvenster. + +### Kan de assistent mijn cliëntgegevens zien? + +Nee. De assistent heeft geen toegang tot de database of cliëntdossiers. De assistent gebruikt alleen de systeemdocumentatie om vragen te beantwoorden. + +### Hoe nauwkeurig zijn de antwoorden? + +De antwoorden zijn gebaseerd op de officiële EPD-documentatie. De assistent: +- Geeft alleen informatie die in de documentatie staat +- Zegt eerlijk wanneer informatie ontbreekt +- Verzint nooit functies die niet bestaan + +### Wordt mijn gesprek opgeslagen? + +Nee. Gesprekken worden niet permanent opgeslagen: +- De conversatie bestaat alleen in uw browser-sessie +- Na uitloggen wordt alles gewist +- Gesprekken worden niet gelogd of geanalyseerd + +### In welke taal kan ik vragen stellen? + +De assistent is geoptimaliseerd voor **Nederlands**. U krijgt ook antwoorden in het Nederlands. + +--- + +## Bekende beperkingen + +- **Alleen EPD-documentatie**: Geen algemene kennis of externe bronnen +- **Geen acties**: De assistent kan niets wijzigen in het systeem +- **Sessie-gebonden**: Conversatie verdwijnt na uitloggen +- **Tekst-only**: Geen ondersteuning voor afbeeldingen of bestanden + +--- + +## Keyboard shortcuts + +| Actie | Shortcut | +|-------|----------| +| Vraag versturen | Enter | +| Nieuwe regel | Shift + Enter | +| Chat sluiten | Klik X of Escape | + +--- + +## Gerelateerde documentatie + +- [Spraakgestuurde Verslaglegging](/documentatie/spraakgestuurde-verslaglegging) - Dicteren van rapportages +- [Interface Design System](/documentatie/interface-design) - UI patterns en navigatie +- [Authentication System](/documentatie/authentication) - Inloggen en toegangsbeheer + +--- + +## Feedback + +Heeft u suggesties voor de AI Documentatie Assistent? Ontbreekt er informatie of krijgt u onjuiste antwoorden? Meld dit bij de beheerder zodat we de documentatie kunnen verbeteren.