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