AI-ondersteuningsassistent
Deze handleiding legt uit hoe je de ingebouwde AI-assistent gebruikt om direct antwoorden te krijgen over hoe Agon werkt — zonder de app te verlaten.
Voordat je begint
De assistent is vanaf elk scherm in de applicatie bereikbaar. Om antwoorden in gewone taal te krijgen, koppel je hem aan een AI-provider met de eigen sleutel van je studio (een gratis Google Gemini-sleutel maak je in ongeveer 3 minuten aan) of aan een lokaal model — zie Hoe je de AI-assistent instelt.
Zonder AI-provider werkt de assistent in basismodus: typ een paar trefwoorden en hij toont de documentatieartikelen die het best passen. Vindt hij geen goede match voor wat je typte — of begroet je hem gewoon — dan toont hij in plaats daarvan een doorklikbaar onderwerpenmenu: klik op een categorie, dan een subcategorie, dan een pagina (en, bij een pagina met meerdere secties, de specifieke sectie) om te vinden wat je nodig hebt zonder de juiste trefwoorden te moeten raden. Basismodus werkt volledig op je computer en kan geen vrije vragen beantwoorden of zakelijk advies geven.
Wat de AI-assistent doet
De AI-assistent beantwoordt je vragen over Agon in gewone taal. Je kunt dingen vragen zoals:
- "Hoe annuleer ik een les?"
- "Wat gebeurt er met de credits van een klant wanneer ik een boeking annuleer?"
- "Hoe exporteer ik een rapport?"
- "Hoe stel ik een terugkerend lidmaatschap in?"
Hij weet alles wat in deze documentatie wordt behandeld: lessen, boekingen, lidmaatschappen, inchecken, rapporten, betalingen, instellingen en meer. Hij antwoordt in welke taal je ook schrijft.
Wat de AI-assistent NIET doet
Standaard beantwoordt de assistent alleen vragen — hij brengt nooit wijzigingen aan in je gegevens.
Specifiek zal hij niet:
- Klantprofielen aanmaken of wijzigen
- Betalingen verwerken of lidmaatschapsplannen wijzigen
- Toegang krijgen tot de persoonlijke informatie van je klanten
- Enige gegevens verwijderen
Als je hem vraagt een van deze acties uit te voeren, legt hij in plaats daarvan uit hoe je het zelf doet.
Uitzondering: studiomanagers kunnen de AI-actiemodus aanzetten om de assistent een vaste set echte acties te laten uitvoeren vanuit een verzoek in gewone taal — een les aanmaken of annuleren, een klant boeken of inchecken, een klant aanmaken, een lidmaatschap toewijzen, of een rapport ophalen. Dit is opt-in en alleen beschikbaar voor het studiomanageraccount — zie de handleiding AI-actiemodus voor de volledige lijst en wat het niet kan.
Bedrijfsadviesvragen
Studiomanagers kunnen de assistent ook bedrijfsanalysevragen stellen over hun eigen studio, niet alleen "hoe doe ik"-vragen. Bijvoorbeeld:
- "Wanneer boeken mijn klanten het meest?"
- "Is mijn Premium-lidmaatschap goed geprijsd?"
- "Wie zijn mijn beste klanten en wat doen zij anders?"
- "Hoe gezond is mijn omzet?"
De assistent beantwoordt deze door de echte geaggregeerde gegevens van je studio op te halen — boekingen per uur/dag en lestype, lidmaatschapsprijzen en -adoptie, gedrag van het top-uitgevers-cohort, en omzettrends en -concentratie — en baseert zijn antwoord op die feitelijke cijfers. Hij verzint nooit een getal, een piektijd of een prijsaanbeveling.
Dit is alleen advies. Er is geen manier voor de assistent om een prijs te wijzigen of enige actie hierop te baseren — hij kan je alleen vertellen wat hij ziet en suggereren wat je moet overwegen. Als je besluit naar zijn advies te handelen, ga je nog steeds zelf naar het relevante scherm (Lidmaatschappen, Rapporten of Inzichten) en breng je de wijziging daar aan.
Dezelfde vier gebieden die de assistent kan bespreken — boekingspatronen, prijsstelling, grootste uitgevers en omzetgezondheid — zijn ook altijd zichtbaar als een permanent dashboard op de pagina Inzichten, zodat je geen vraag hoeft te stellen om ze te zien.
Hoe je het gebruikt
-
Klik op de ronde chatknop (💬) in de rechterbenedenhoek van het scherm. [SCREENSHOT: The floating chat button in the bottom-right corner of the Agon desktop app]
-
Vlak boven de knop, in de rechteronderhoek, opent een chatpaneel met de titel "Agon AI-ondersteuning". [SCREENSHOT: The AI Support chat panel open, showing the welcome message]
-
Typ je vraag in het tekstvak onderaan het paneel. Schrijf in gewone taal — er zijn geen speciale commando's of trefwoorden nodig. [SCREENSHOT: The text input box with an example question typed]
-
Druk op Versturen of druk op Enter op je toetsenbord om je vraag in te dienen.
-
De assistent antwoordt binnen een paar seconden. Als je vraag onduidelijk is, stelt hij mogelijk een vervolgvraag om je beter te helpen. [SCREENSHOT: An example question and answer exchange in the chat panel]
-
Om het paneel te sluiten, klik je op de × boven in het paneel, of klik je opnieuw op de chatknop.
Veelgestelde vragen
Welke talen spreekt hij? De assistent antwoordt in dezelfde taal waarin je schrijft. Als je in het Italiaans schrijft, antwoordt hij in het Italiaans. Als je in het Spaans schrijft, antwoordt hij in het Spaans. Hij ondersteunt alle grote talen.
Heeft hij geheugen tussen sessies? Binnen één chat wel: open die opnieuw vanuit de chatlijst links en ga verder — de assistent weet dan nog alles wat eerder in die chat is gezegd. Klik je op Nieuwe chat, dan begint hij opnieuw, zonder geheugen van enig ander gesprek. Chats die je actief houdt, blijven onbeperkt beschikbaar; alleen een chat die je expliciet hebt gearchiveerd, wordt verwijderd, en pas na 30 dagen in het archief.
Wat als hij een verkeerd antwoord geeft? De assistent put zijn kennis uit deze documentatie. Als hij een antwoord geeft dat niet overeenkomt met wat je in de app ziet, vertrouw dan op wat je in de app ziet. Je kunt de vraag ook anders stellen — soms helpt herformuleren. Denk je dat het antwoord steeds fout is, mail dan naar support@agon-studio.dev zodat de documentatie kan worden bijgewerkt.
Kan hij me helpen met problemen die niet in de documentatie worden behandeld? De kennis van de assistent is beperkt tot de Agon-documentatie. Voor problemen daarbuiten — zoals netwerkproblemen of fouten van het besturingssysteem — mail je naar support@agon-studio.dev (zie Feedback en support).
Wat als er iets misgaat?
De assistent toont alleen helpartikelen in plaats van te antwoorden Er is geen AI-provider gekoppeld, dus de assistent staat in basismodus. Voeg de eigen providersleutel van je studio toe in Instellingen → AI-assistent — zie Hoe je de AI-assistent instelt.
De assistent zegt dat mijn AI-provider verzoeken beperkt Je providersleutel heeft zijn limiet bereikt. Wacht een minuut en probeer het opnieuw, of verhoog je limieten bij de provider — zie Als je intensief gebruik verwacht.
De assistent reageert niet nadat ik op Versturen heb gedrukt Controleer je internetverbinding: een AI-provider in de cloud (Gemini of Groq) heeft die nodig. Met een lokaal model controleer je of Ollama draait. Is dat in orde, sluit het chatpaneel dan en open het opnieuw.
Het chatpaneel opent niet wanneer ik op de knop klik Probeer de Agon-applicatie opnieuw te starten. Als het probleem aanhoudt, controleer dan of de Agon-backendservice draait. Op macOS kun je dit doen door Agon volledig af te sluiten en opnieuw te openen vanuit je map Programma's.
De assistent zegt dat hij geen informatie over mijn vraag kan vinden De assistent matcht je vraag op betekenis aan deze documentatie, niet alleen op exacte trefwoorden, dus het meeste herformuleren is niet nodig — maar als hij toch niets relevants kan vinden, probeer dan naar de specifieke functie op naam te vragen (bijvoorbeeld "hoe maak ik een lidmaatschap aan" in plaats van "hoe stel ik een plan in"). Probeer ook rechtstreeks over het Agon-product te vragen — de assistent is beperkt tot het beantwoorden van vragen over Agon en zal ongerelateerde, algemene kennisvragen weigeren.