finalize ai assistenat

This commit is contained in:
colinislit
2025-12-01 16:14:30 +01:00
parent 1782809599
commit 54f2c36eba
5 changed files with 201 additions and 3 deletions

View File

@@ -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

View File

@@ -65,7 +65,7 @@ export function DocsChatWidget() {
</div>
<div>
<h2 className="font-semibold text-slate-900 text-sm">
Documentatie Assistent
EPD Assistent
</h2>
<p className="text-xs text-slate-500">
Stel vragen over het EPD

View File

@@ -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?',
}
/**

View File

@@ -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)",

View File

@@ -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.