Waarom we dit doen
Een documentanalyse is niet beter dan de context die de AI heeft. Bij sommige documenttypen — bijv. een officiële waarschuwing op het werk — bepaalt één enkel gegeven of de analyse raak is of ernaast zit:
- Bent u de werknemer (u hebt de waarschuwing ontvangen) of de werkgever (u controleert uw eigen concept)?
- Waren er eerder al berispingen of waarschuwingen?
- Is er vóór het uitvaardigen een hoorgesprek gevoerd?
- Ligt er al een ontslag op tafel?
Zonder deze antwoorden moet de AI gissen. Mét deze antwoorden levert de AI een analyse die precies is afgestemd op uw rol en risicopositie — termijn, weerwoord, een verwijzing naar de termijn om ontslag aan te vechten (die per land verschilt).
Zo werkt het: drie triggerpunten
- Niveau 1 — aanbeveling vóór de analyse: Bij geselecteerde documenttypen (bijv. waarschuwing, ontslag, beëindigingsovereenkomst) opent na het uploaden een venster met twee gelijkwaardige knoppen: Ja, verduidelijkingsvragen ({prijs}/ronde) of Direct analyseren. Niets is voorgeselecteerd — u beslist actief.
- Niveau 2 — overschrijven tijdens de analyse: Ook wanneer geen standaardverduidelijking wordt aanbevolen, ziet u tijdens de lopende analyse een discrete link: „Context toevoegen voor een betere analyse?". Een klik opent hetzelfde venster met 2 tot 3 vrij geformuleerde contextvragen.
- Niveau 3 — verfijnen na de analyse: Onder het resultaat verschijnt de knop „Verduidelijkingsvragen toevoegen". U beantwoordt 1 tot 3 vragen die gericht zijn op leemten in de bestaande analyse — daarna wordt de analyse bijgewerkt.
Alle drie de wegen gebruiken hetzelfde betaalmechanisme (analysis_clarify_gather, standaard 1 credit/ronde, maximaal 3 rondes). Elke ronde toont vóór de afschrijving de exacte prijs. Uw antwoorden komen als een duidelijk gemarkeerd notitieblok in de uiteindelijke analyseprompt terecht, en caching wordt automatisch uitgeschakeld.
Wat er onder de motorkap gebeurt
- Model: google/gemini-2.5-flash-lite — snel en goedkoop, want het hoeft alleen vragen te formuleren, niet te analyseren.
- Tokenbudget: 800 outputtokens, temperatuur 0,2 — bondige vragen, geen romans.
- Vangnet: terugbetaling bij elke mislukte aanroep, controle van de daglimiet vóór elke ronde.
- Sturing per playbook: welke documenttypen Niveau 1 activeren, bepaalt de redactie in het admingedeelte (Playbooks → schakelaar „Verduidelijking vóór analyse actief" + motivering + slot-aanwijzingen). Per playbook regelt de schakelaar „Overschrijven toestaan" bovendien of Niveau 2 en 3 voor dat document beschikbaar zijn. Standaard: toegestaan.
- Terugvalpad: bij documenten zonder passend playbook staat het systeem Niveau 2 en 3 standaard toe — de AI formuleert dan 2 tot 3 open contextvragen die echt doorslaggevend zijn voor een rake analyse.
- Globale killswitch: de feature flag analysis_clarify_enabled (met max_gather_turns) — voor het geval de functie ooit gepauzeerd moet worden.
Wat het niet is
- Geen verplichting. Kent u het document al en staan de antwoorden toch al in de tekst, sla het venster dan over.
- Geen verborgen toeslag. De verduidelijkingsstap is een eigen post in uw creditgeschiedenis — reden-code analysis_clarify_gather.
- Geen vervanging van een advocaat. De verduidelijkingsvragen scherpen de context voor de AI-analyse aan. Voor de termijn van uw procedure tegen het ontslag blijft een gespecialiseerde advocaat de eerste keuze.
Tegelijk: verduidelijkingsvragen bij het opstellen van een brief
Hetzelfde mechanisme hebt u al langer in de Schreib-Assistent (reden-code writing_intake_gather): wanneer u een brief zonder sjabloon genereert — bijv. een waarschuwing als werkgever — stelt de AI gerichte vragen over de feiten, de bewijsmiddelen en de gewenste stelligheid voordat de definitieve brief wordt gemaakt. Ook daar: elke ronde met zichtbare prijs, altijd over te slaan.
Waar u het vandaag al ziet
- Vault → document uploaden → „Analyseren" — bij een actief playbook verschijnt het venster automatisch.
- Tijdens elke analyse: de discrete link „Context toevoegen" — ook zonder actief playbook.
- Na elke analyse: de knop „Verduidelijkingsvragen toevoegen" in de actievoettekst.
Standaard ingeschakelde playbooks (stand vandaag): Officiële waarschuwing op het werk (DE/AT/CH), Beëindigingsovereenkomst controleren (DE), Getuigschrift controleren (DE), Ontslag werknemer (DE), Ontslag arbeid (AT/CH), Huurverlaging (DE/AT), Afwijzing bouwvergunning (DE), Advocatenbrief/vordering (DE/AT/CH).
Er volgen meer playbooks. Suggesties waar verduidelijkingsvragen het verschil zouden maken? Gebruik de feedbackduim direct bij het resultaat.
