9dc2b4f216
- Add in-memory rate limiter (10 requests/minute per user) - Show informative message when limit reached explaining demo context - Display countdown timer showing when chat becomes available again - Auto-reset rate limit when timer expires - Update documentation with rate limit FAQ and category selection flow 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
209 lines
7.1 KiB
Plaintext
209 lines
7.1 KiB
Plaintext
---
|
|
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 verschijnt
|
|
- Drie categorieën om uit te kiezen: Cliënten & Dossiers, Intake & Screening, Spraak & Rapportage
|
|
|
|
### Stap 2: Kies een onderwerp of stel een vraag
|
|
|
|
U kunt op twee manieren beginnen:
|
|
|
|
**Optie A: Kies een categorie**
|
|
Klik op een van de drie categorieën om voorbeeldvragen te zien:
|
|
- **Cliënten & Dossiers** - Vragen over cliëntbeheer en dossiers
|
|
- **Intake & Screening** - Vragen over intakes en screenings
|
|
- **Spraak & Rapportage** - Vragen over spraakherkenning en dicteren
|
|
|
|
Na het kiezen van een categorie ziet u drie voorbeeldvragen. Klik op een vraag om deze direct te stellen.
|
|
|
|
**Optie B: Typ uw eigen vraag**
|
|
Typ uw vraag in het tekstveld onderaan het chatvenster.
|
|
|
|
**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.
|
|
|
|
### Waarom zie ik "Even pauze"?
|
|
|
|
Dit is een demo-omgeving met een vraaglimiet van **10 vragen per minuut**. Deze limiet voorkomt overbelasting van het systeem.
|
|
|
|
**Wat u ziet:**
|
|
- Een oranje melding met uitleg over de limiet
|
|
- Een countdown timer die aftelt tot u weer vragen kunt stellen
|
|
- Een overzicht van onderwerpen waarvoor de assistent geschikt is
|
|
|
|
Wacht tot de timer op 0 staat - de chat wordt automatisch weer actief.
|
|
|
|
---
|
|
|
|
## 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
|
|
- **Vraaglimiet**: Maximaal 10 vragen per minuut (demo-omgeving)
|
|
|
|
---
|
|
|
|
## 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.
|