Documentatie van GRITT en FUGA

2.1 GRITT: ons softwarepakket

GRITT is een general purpose chatbot met een aantal speciale functies die haar een voorsprong geven op de concurrentie. Behalve de functies die je gewend bent, kun je GRITT trainen op data uit je eigen documenten. Daarnaast zitten in GRITT onder meer een privédocumentlaag, een Ghostlink-systeem, spraakfuncties en — wanneer FUGA is ingeschakeld — een uitgebreide studielaag.

2.2 Gewone chatfuncties en knoppen

De chatinterface in /index.html is het algemene gespreksscherm van GRITT. Daar zie je een hamburgerknop, een centrale logomarkering, navigatieknoppen zoals Chat, Fuga, Documenten, Account, een FUGA-aan/FUGA-uit-knop, links het sessiegedeelte, een bronpaneel en onderaan de tekstinvoer met spraakknoppen.

2.3 Sessies

Een sessie is een afzonderlijk gesprekstraject in de chat. Je kunt sessies aanmaken, selecteren, hernoemen en verwijderen. In de interface staat daarvoor links een New-knop, een keuzelijst, een hernoemknop en een verwijderknop. GRITT onthoudt bovendien de laatst gebruikte sessie.

In de praktijk betekent dit dat je meerdere parallelle gesprekken kunt bijhouden: bijvoorbeeld een sessie voor een studieproject, een sessie voor een creatief idee, en een sessie voor gewone dagelijkse vragen. Dat voorkomt dat alles in één lange chat verstrikt raakt.

2.4 Bronnen, bronvermeldingen en symbolen

GRITT kan bij antwoorden bronvermeldingen tonen. In de interface gebeurt dat via kleine kaarten of symbolen. Die verwijzen niet allemaal naar dezelfde herkomst. Een bronkaart kan bijvoorbeeld slaan op eigen documenten, op materiaal uit een kenniscorpus, op FUGA-gerelateerde context of op webresultaten.

Bronsymbolen in de huidige chat-UI

De huidige chat-UI gebruikt hiervoor niet zomaar willekeurige pictogrammen. In de code is expliciet vastgelegd dat webbronnen een apart symbool krijgen en dat andere bronnen hun document- of corpussymbool volgen.

Niet-webbron

Volgt het symbool dat bij het document hoort. Als er geen specifiek symbool is ingesteld, valt de UI terug op coco.

Webbron

Wanneer GRITT het internet raadpleegt, krijgt die bron in de huidige UI standaard coco symbol #2.

Carbon-Steel

In het donkere Carbon-Steel-thema gebruikt de UI de donkere varianten van die symbolen.

Voorbeeld van bronkaartjes in de chatinterface. Welke labels en symbolen precies verschijnen hangt af van documenttype, webgebruik en ingestelde weergave. Visuele plaatsing is ook hier indicatief.

Wat de kaarten doen

De bronkaarten zijn bedoeld om zichtbaar te maken waar een antwoord op steunt. Een gewone gebruiker hoeft niet elke kaart technisch te ontleden, maar het is wel belangrijk te begrijpen dat GRITT bronnen van elkaar probeert te onderscheiden. Dat helpt bij controle, nuance en herkomstbewustzijn.

Voor een commerciële of professionele lezer is dit ook relevant: de interface laat niet alleen tekst zien, maar probeert de herkomst van kennis expliciet leesbaar te maken. Dat is belangrijk voor transparantie, kwaliteitscontrole en vertrouwen.

2.5 Internet raadplegen

GRITT kan het internet raadplegen om extra informatie op te zoeken. Dat gebeurt niet willekeurig, maar wanneer een vraag daar aanleiding toe geeft. In de chatinterface is daarvoor een aparte web-status en web-bronlogica aanwezig. Het systeem laat in dat geval webbronnen als afzonderlijke herkomst zien.

Praktisch betekent dit dat GRITT niet alleen put uit reeds aanwezige documentlagen, maar ook actuele online informatie kan opzoeken, mits dat functioneel en passend is voor de vraag.

2.6 TTS, STT, mute, volume en microfoon

TTS staat voor text-to-speech: GRITT kan tekst hardop laten uitspreken. STT staat voor speech-to-text: jouw gesproken audio kan worden omgezet in tekst die als bericht wordt ingestuurd.

3.1 De privédocumentlaag van GRITT

Privédocumenten zijn je eigen documenten binnen GRITT. Ze vormen een aparte laag naast de gewone chat. Ze zijn bedoeld voor materiaal dat jij zelf wilt laten meewegen in gesprekken: notities, artikelen, concepten, pdf’s, losse tekstbestanden, samenvattingen, persoonlijke studiestukken en andere inhoud die niet simpelweg in de publieke chat thuishoort.

3.2 Uploaden en limieten

Voor privédocumenten geldt standaard een uploadlimiet van 20 MB per document. Dat is de veilige standaardlimiet. Onder de motorkap kan die limiet later anders worden ingesteld, maar voor publieke documentatie is 20 MB de juiste en veilige hoofdregel.

De privédocumentpagina ondersteunt documentupload én handmatig geschreven tekstdocumenten. Voor het bredere systeem noem je publiekelijk nu: PDF, Word en TXT. Op de FUGA-pagina zie je op dit moment vooral expliciet een PDF-uploadknop; dat betekent niet dat het hele ecosysteem alleen met PDF werkt.

3.3 Tekstdocumenten schrijven in het tekstkader

Op de documentpagina is er niet alleen een uploadformulier, maar ook een uitklapbaar onderdeel Nieuw tekstdocument. Daar kun je een titel invullen, de optie voor externe verwerking aan- of uitzetten, en direct tekst typen in een groot tekstvak. Dat is nuttig voor snelle notities, ideeën, essayschetsen, dagboekachtige reflecties of materiaal dat je niet eerst als apart bestand wilt opslaan.

3.4 Externe verwerking

Bij zowel geüploade documenten als geschreven tekstdocumenten kun je aangeven of externe verwerking is toegestaan. Dat is niet hetzelfde als openbare publicatie of directe inzage door anderen. Het betekent in de eerste plaats dat het document buiten alleen jouw onmiddellijke chatcontext functioneel gebruikt mág worden, binnen de daarvoor bedoelde architectuur en regels.

Dat toestaan of intrekken kan per document. Je zit dus niet vast aan één globale keuze voor al je documenten.

3.5 Expert-Docs

Binnen de bredere architectuur van GRITT bestaat ook een laag die hier expliciet Expert-Docs heet. Dat zijn geen gewone losse uploads, maar aanvullende of afgeleide documenten die in relatie staan tot bronmateriaal en die bedoeld zijn om extra context, verdieping of begeleidende documentatie mogelijk te maken.

Voor een nieuwe gebruiker is vooral dit van belang: GRITT slaat niet alleen documenten op, maar kan ook met documentafleidingen of begeleidende documentlagen werken. Voor een professionele of commerciële lezer is dit relevant omdat het laat zien dat de documentarchitectuur meerlagig is en niet ophoudt bij één ruwe upload.

4.1 Wat Ghostlink is

Ghostlink is een systeem binnen GRITT waarmee gecontroleerde invloed en verbinding mogelijk wordt zonder directe inzage in andermans documenten. Dat is het kernidee. Het systeem gaat dus niet over simpel “delen van een map”, maar over het leggen van een relatie tussen accounts, waarbij invloed of weging mogelijk is terwijl de onderliggende documenten niet zomaar open op tafel liggen.

4.2 Korte en lange ghostlinks

Op accountniveau kun je Ghostlink activeren of deactiveren. Zodra Ghostlink actief is, heeft je account een lange link en doorgaans ook een korte link. Beide kunnen worden gekopieerd. Het verschil is vooral praktisch: de korte link is handiger om te delen; de lange link is de volledige variant.

4.3 Volgen, spooks en spook-notities

Een gebruiker kan een ghostlink plakken in het veld Ghostlink volgen. Daardoor ontstaat een spookrelatie. In de accountinterface bestaat ook een lijst van de spooks die je volgt. Per relatie kan een notitie worden bijgehouden en een relatie kan ook weer worden verwijderd.

Met andere woorden: Ghostlink is niet alleen een losse URL, maar een klein relationeel systeem met activeren, kopiëren, volgen, tellers, labels, notities en ontkoppelen.

4.4 Geen directe documentinzage

Dit punt verdient extra nadruk. Ghostlink is uitdrukkelijk niet bedoeld als eenvoudige directe documentinzage voor andere gebruikers. Het systeem is ontworpen rond gecontroleerde invloed, verbinding en gewogen gebruik, niet rond het openklappen van andermans documentmap.

5.1 Wat FUGA is

FUGA is een functie binnen GRITT: een AI-studiepartner. Het is dus geen tweede product naast GRITT, maar een specifieke rol en functielaag binnen hetzelfde softwarepakket. Wanneer FUGA actief is, analyseert het geüploade materialen, chatberichten, structuur, chronologie en allerlei signalen van begrip.

Voor een nieuwe gebruiker betekent dit concreet: FUGA helpt je niet alleen met antwoorden, maar ook met structureren, volgen, toetsen, verdiepen en het opbouwen van een studiebeeld over langere tijd. Voor iemand die Mind Your Axis als start-up beoordeelt, laat FUGA zien dat GRITT meer is dan een losse chatbot: het is een poging om documentanalyse, pedagogiek, voortgangsmeting en gesprekservaring in één systeem te verbinden.

5.2 Toon, stijl en tutorrol

FUGA functioneert als AI-tutor, maar niet op een schoolse of belerende manier. De gewenste stijl is eerder die van een goede collega bij het koffiezetapparaat, of een vriend die ergens veel verstand van heeft. Het gesprek moet informatief zijn, maar in de eerste plaats ook prettig en natuurlijk om te voeren.

Onder de motorkap past dit ook bij de tutorpolicy: FUGA is bedoeld als gelijkwaardige gesprekspartner met didactische vaardigheid, niet als neerbuigende docent. Dat heeft gevolgen voor toon, ritme en vraagstelling.

5.3 FUGA-aan en FUGA-uit

Wanneer FUGA aan staat, monitort het systeem studiegerelateerde signalen en vervult GRITT de FUGA-rol van studiepartner. Wanneer FUGA uit staat, is het FUGA-deel inactief en blijft GRITT een general purpose chatbot.

Je kunt dat schakelen via de FUGA-knop in de chatinterface of via de commando’s @fuga-in en @fuga-out. In beide gevallen is het de bedoeling dat die schakel logisch en snel werkt.

Van project tot studiegesprekspartner

6.2.a Praktische uploadnotitie

Voor FUGA-uploads is de technische requestlimiet hoger dan bij privédocumenten. In de praktijk communiceer je publiekelijk het volgende: privédocumenten hebben standaard 20 MB per document; FUGA PDF-uploads hebben een ruimere technische marge. Omdat FUGA-upload via een JSON-request met base64 werkt, is de effectieve ruwe PDF-grootte lager dan de requestgrootte. Dat is een technische nuance, geen aparte knop waar gebruikers iets mee hoeven.

6.4 De organisatie-assistent

De organisatie-assistent is een tekstveld in FUGA waarin je met gewone taal tegen het systeem kunt zeggen wat er in de projectstructuur moet gebeuren. Je kunt daarmee onder meer macrosecties aanmaken, courses aanmaken, units aanmaken, onderdelen hernoemen en onderdelen verplaatsen.

De assistent verwacht in de basis een hiërarchie van project → macrosectie → vak / course → unit. In veel curricula zal een macrosectie overeenkomen met iets als een jaar, semester of grotere fase. Een vak of course is de concrete cursus. Een unit is meestal een week, les, sessie of hoofdstuk. Wanneer een document daar niet netjes op aansluit, kun je de assistent juist gebruiken om die structuur expliciet te maken of te corrigeren.

6.5 Curriculumelementen en evidence-elementen

Curriculumelementen zijn de inhoudelijke bouwstenen die FUGA uit het studiemateriaal extraheert. In de huidige architectuur gaat het onder meer om definities, proposities en logische structuren. Voor logische structuren worden premissen en conclusie expliciet van elkaar onderscheiden.

Evidence-elementen zijn geen losse curriculumstukken, maar sporen van begrip of onbegrip die FUGA koppelt aan curriculumelementen. Een studentbericht, een tekstpassage, een geüpload cliëntbestand of een andere uiting kan dus als evidence dienen dat een bepaald element wordt herkend, letterlijk herhaald, op een hoger niveau begrepen, of juist verkeerd verbonden.

Daarom is begrip in FUGA niet alleen “feit X kennen”, maar ook verbanden leggen, verschillen zien, voorbeelden geven, premissen herkennen, tegenvoorbeelden formuleren en ideeën in nieuwe situaties operationaliseren.

Onder de motorkap sluit dit aan bij een systeem waarin evidence-snippets, elementkoppelingen en mastery-updates worden bijgehouden. Dat technische detail hoeft een gewone gebruiker niet per stap te zien, maar het is wel belangrijk om te begrijpen waarom FUGA meer data over begrip produceert dan een gewone chatbot.

6.6 Clusterkaart, explorer, dossiers en voortgang

De clusterkaart in FUGA laat de structuur van een project zien. De kaart is niet slechts decoratie. Zij probeert verbanden te tonen tussen onderdelen, thema’s en inhoudelijke elementen. Daarnaast zijn er de Curriculum explorer, dossierknoppen per schaalniveau, focusinstellingen en overlays voor activiteit of voortgang.

De kaart leest dus niet simpelweg “hoeveel documenten er zijn”, maar probeert thematische en structurele relaties zichtbaar te maken. Explorer en dossiers vullen dat aan met meer tekstuele en schaalgebonden overzichten, zodat je zowel visueel als analytisch met dezelfde kennislaag kunt werken.

FUGA monitort niet alleen activiteit, maar ook begrip in meerdere dimensies. Voortgang is dus niet simpelweg “meer chatberichten”. Het systeem combineert signalen, vergelijkt de hoeveelheid bewijs van begrip op verschillende momenten en verbindt dat ook met de chronologische cursusstructuur.

7.1 Registratie, verificatie en activatie

De registratieflow is bewust in meerdere stappen opgezet. Op de registratiepagina kies je eerst taal van de interface, kleurprofiel, een professie-/profielveld, en een abonnementsvorm. Daarna vul je e-mailadres en wachtwoord in, bevestig je dat je 18+ bent, accepteer je de voorwaarden, bevestig je de onmiddellijke start van de digitale dienst tijdens de bedenktijd, en rond je de Friendly Captcha-controle af. Pas daarna wordt het account aangemaakt.

Na registratie volgt eerst e-mailverificatie. Dat is geen detail maar een vaste stap in de flow: het systeem toont expliciet dat er een verificatielink is verstuurd, biedt een knop om de verificatiemail opnieuw te sturen, en blokkeert zowel inloggen als de vervolgstap richting betaal-/activatieflow zolang het e-mailadres nog niet is bevestigd. Ook de serverlogica voor de volgende stap in het registratieproces controleert eerst of het e-mailadres geverifieerd is.

7.2 Voorkeuren en profiel

In de accountpagina kun je je basisvoorkeuren instellen. Daarbij horen ten minste taal, thema, een professieveld, model- of LLM-keuze, en later ook verdere accountgerelateerde instellingen. De accountpagina is dus niet alleen administratief, maar ook functioneel: hier bepaal je hoe GRITT zich voor jouw account gedraagt. Ook op de registratiepagina worden taal en thema al direct vastgelegd, zodat nieuwe gebruikers niet eerst door een onpersoonlijke standaardinterface hoeven te gaan.

7.3 Spraakinstellingen

De accountpagina bevat ook afzonderlijke schakelaars voor TTS en STT. Die instellingen zijn belangrijk als je spraak tijdelijk niet wilt gebruiken, of wanneer je deze functies liever uitschakelt zolang die diensten nog niet volledig EU-based zijn. In de chat zelf zie je daarnaast de bedieningslaag met volumeregeling, mute en microfoon. Daardoor bestaat de spraakfunctie uit twee lagen: accountniveau (globaal aan/uit) en chatniveau (direct bedienen tijdens gebruik).

7.4 Ghostlink op accountniveau

Op accountniveau kun je Ghostlink activeren, een eigen label instellen, de korte en lange link kopiëren, een ghostlink van iemand anders volgen en een overzicht van je spookrelaties bekijken. Ghostlink is dus niet een verborgen intern mechanisme, maar een volwaardig accountonderdeel.

7.5 Abonnementen, wallet en limieten

De software kent verschillende abonnementsvormen. In de huidige registratie- en accountbestanden zie je planselectie voor trial, Basic, Flex Top-up en een hoger plan, plus accountknoppen voor starten of beheren via de Stripe-portal. In de publieke documentatie kun je dat lezen als: GRITT ondersteunt meerdere gebruiks- en betaalvormen, maar de beheerhandeling loopt centraal via account en billing portal.

Daarnaast zie je in account ook walletinstellingen, zoals het bedrag per automatische opwaardering en de geldigheid van wallettegoed. Dat maakt vooral duidelijk dat niet elk gebruiksmodel werkt via precies dezelfde abonnementslogica. Sommige vormen zijn abonnementsgedreven, andere werken met wallettegoed of automatische top-up.

Voor Basic en Premium geldt in de publieke uitleg dat er limieten op bestandsupload en gebruik bestaan, al raak je daar niet snel aan. Die limieten horen dus wel genoemd te worden, ook als ze voor veel gebruikers niet meteen in beeld komen.

7.6 Opzeggen, wisselen en accountverwijdering

De voorwaarden zeggen expliciet dat abonnementen maandelijks automatisch verlengen tot opzegging, en dat opzeggen via de Stripe-klantenportal gebeurt met werking per einde van de lopende periode. De accountpagina bevat daar ook daadwerkelijk de knop voor om de portal te openen.

Wisselen tussen abonnementen hoort daarom ook vanuit account en billing te worden begrepen: het is geen verborgen handeling, maar een beheeractie die vanuit de accountlaag plaatsvindt. De documentatie moet dus duidelijk maken dat gebruikers voor starten, wijzigen en opzeggen primair naar Account en de billing portal kijken.

Voor accountverwijdering geldt aanvullend jouw huidige productbeleid: verwijdering vraagt een extra verificatiestap; na verwijdering wordt de data niet meteen hard gewist maar eerst ontoegankelijk gemaakt; en er blijft een herstelperiode van 30 dagen bestaan waarin herstel nog geprobeerd kan worden wanneer iemand per ongeluk zijn account verwijdert. Dit punt is in deze documentatie dus al opgenomen als beleidsuitleg, maar het is nog niet uit de huidige codebestanden zelf af te leiden.

Wachtwoord vergeten

Gebruikers kunnen via de vergeten-wachtwoordflow een resetmail aanvragen. De server geeft om veiligheidsredenen ook bij onbekende e-mailadressen een neutraal succesantwoord terug, zodat niet kan worden afgeleid of een account bestaat. Daarna volgt een resetpagina waar een nieuw wachtwoord tweemaal wordt ingevuld.

8.1 Gewone gebruikers

Voor gewone gebruikers geldt: het toestaan van externe verwerking betekent niet dat anderen jouw bestanden direct kunnen zien. Het betekent ook niet dat jouw documenten automatisch in een algemeen openbaar corpus belanden. De kern is juist dat anderen eventueel van de voordelige invloed ervan kunnen ondervinden, zonder directe bestandsinzage.

8.2 Professionele gebruikers en verificatie

Bij professionele gebruikers ligt dit anders. Wanneer zij publieke documenten willen bijdragen aan een algemener corpus, is er een menselijke of gecontroleerde stap van inventarisatie, screening of verificatie. Dat onderscheid is belangrijk: gewone gebruikers en professionele gebruikers zitten niet in exact hetzelfde publicatietraject.

9.1 Gegevens en beveiliging

Mind Your Axis profileert zich nadrukkelijk als voorvechter van verantwoorde omgang met privacy. Te gevoelige data wordt niet opgeslagen, data is beveiligd, en gebruikersdata wordt niet doorgespeeld aan andere partijen. Daarnaast zijn Terms en Privacy aparte pagina’s, waar de formele juridische formulering staat.

9.2 Geen LLM-training met gebruikersdata

Gebruikersdata wordt nooit gebruikt om LLM’s te trainen. Daar is geen opt-in voor en die mogelijkheid wordt ook niet aangeboden.

9.3 Disclaimers

10.1 Flex, Basic en Premium

Publiekelijk worden nu drie plannen onderscheiden: Flex, Basic en Premium. Functioneel zijn de verschillen beperkt; het verschil zit vooral in prijsstructuur, gebruiksberekening en billinglogica. In sommige delen van de huidige software kunnen oudere overgangslabels nog zichtbaar zijn, maar de documentatie houdt vast aan Flex, Basic en Premium.

10.2 Bestandsupload en gebruikslimieten

Bestandsupload is dus niet onbeperkt. Voor privédocumenten is de veilige publieksregel 20 MB per document. Voor FUGA is de technische marge ruimer, maar ook daar is upload niet grenzeloos. Daarnaast kent het systeem gebruikslimieten in andere vormen, bijvoorbeeld voor web queries, spraak en modelgebruik.

Veelgestelde vragen

Veelvoorkomende problemen en wat je dan doet

Dit onderdeel is bedoeld als praktische handleiding voor nieuwe gebruikers. Het geeft geen uitputtende technische diagnose, maar wel de eerste logische stappen die je kunt nemen voordat je contact opneemt.

12.1 Upload lukt niet

12.2 FUGA reageert niet zoals verwacht

Controleer eerst of FUGA wel aan staat. Dat kan via de FUGA-knop in de chat of via @fuga-in. Als FUGA uit staat, gedraagt GRITT zich weer als bredere general purpose chatbot en zal het minder actief als studiepartner optreden.

Controleer daarna of je projectstructuur klopt. Als curriculum, macrosecties, courses en units verkeerd zijn ingedeeld, heeft dat invloed op hoe FUGA focus, voortgang en inhoud koppelt. Gebruik in dat geval de organisatie-assistent om de structuur in gewone taal te corrigeren.

12.3 Ik hoor geen spraak of de microfoon werkt niet

Kijk eerst in Account of TTS en STT ingeschakeld staan. Kijk daarna in de chat zelf of volume niet op nul staat en of mute niet actief is. Voor de microfoon geldt bovendien dat browserrechten voor audio-invoer toestemming moeten geven.

Als je bewust zo min mogelijk niet-EU-based diensten wilt gebruiken, kun je TTS en STT ook gewoon uit laten staan. Dat is een legitieme voorkeur en door de accountinstellingen juist bewust ondersteund.

12.4 Bronkaartjes of symbolen zijn onduidelijk

Onthoud dan het basisverschil: webbronnen zijn iets anders dan document- of corpusbronnen. Bronkaartjes zijn bedoeld om herkomst zichtbaar te maken, niet om een volledige technische audit van elk antwoord in miniatuur te tonen. Wanneer je preciezer wilt begrijpen waar iets vandaan komt, kijk dan naar de bronlabels en naar de context van het antwoord zelf.

12.5 Account, verificatie of wachtwoord

Voor registratiebevestiging en wachtwoordgerelateerde e-mails wordt gebruikgemaakt van account@mindyouraxis.com. Voor gewone gebruiksvragen gebruik je info@mindyouraxis.com. Voor bugs of foutmeldingen gebruik je bugs@mindyouraxis.com.

Mind Your Axis

Mind Your Axis is het bedrijf achter GRITT. GRITT is een van de softwarepakketten van Mind Your Axis. FUGA is daarbinnen een belangrijke functie. De ambitie is om krachtige AI-functies te combineren met inhoudelijke kwaliteit, privacybewustzijn en een zo EU-based mogelijke koers.