Wat een assistent kan doen

This content is not available in your language yet.

Muntar heeft een eigen MCP-server. MCP is de manier waarop een AI-assistent met een programma praat: de assistent ziet een lijst met tools en roept die aan. Koppel je een assistent aan Muntar, dan kan hij je cijfers opvragen en, met de juiste rechten, boekingen voorbereiden.

Koppelen gaat met een API-key uit het scherm “API-keys & MCP”. De scopes van die key bepalen wat de assistent mag aanroepen. Zie API-keys en MCP voor het aanmaken en koppelen.

Wat hij kan lezen

Met de scope “Lezen” kan een assistent bij:

je entiteiten, met hun soort en het aantal rekeningen en categorieën eronder
je rekeningen, met soort, valuta, alle gekoppelde IBAN’s en of het geld vrij opneembaar is
je categorieën per entiteit, ook de gearchiveerde, met hoeveel geboekte regels, klaargezette importregels en regels erop staan
je netto vermogen op een peildatum, per entiteit en samengeteld, eventueel met een uitsplitsing per rekening
je transacties, gepagineerd en te filteren op entiteit, rekening, categorie, periode en zoekterm
je vrij inzetbaar vermogen, met de buffer, de reserves en een eventueel tekort erbij
je imports, en van een import de regels met de categorieën die erbij passen. Het IBAN van de tegenpartij, het saldo en de brontekst uit het bankbestand komen daarbij niet mee.

Daarnaast liggen er drie naslagstukken klaar die de assistent zelf kan opvragen: een uitleg van het datamodel, een uitleg van de afspraken over bedragen, datums en id’s, en een korte samenvatting per entiteit.

Waar een antwoord een id noemt, staat de naam ernaast. Zo hoeft een assistent nooit te gokken welke rekening bij welk id hoort.

Wat hij kan vastleggen

Een assistent schrijft nooit in één stap in je boeken. Een import loopt in vier stappen:

Voorbeeld. Hij leest het bankbestand en vertelt wat erin zit: welke bron, hoeveel regels, wat de saldocheck zegt en welke regels al eerder geïmporteerd zijn. Er wordt niets opgeslagen.
Klaarzetten. Hij zet de nieuwe regels klaar voor beoordeling. Nog steeds geen boeking.
Beoordelen. Per regel komt vast te staan wat het is: een uitgave met een categorie, een overboeking naar een eigen rekening, of een regel die niet geboekt wordt. Dat doe jij in het reviewscherm, of je assistent, zie hieronder. Nog steeds geen boeking.
Boeken. Pas hier gaat het naar je boeken, en pas na een bevestiging. Alle regels moeten eerst beoordeeld zijn; staat er nog iets open, dan weigert Muntar met een uitleg in plaats van half te boeken.

Losse boekingen kan hij ook vastleggen, via dezelfde zes sjablonen als het scherm: uitgave, inkomen, overboeking, kapitaalstorting, koop van een belegging en waardering. Ook daar komt eerst de bevestiging.

Een geboekte import kan hij in zijn geheel terugdraaien. Dat gebeurt met tegenboekingen: het origineel blijft staan, er komt een spiegelbeeld naast.

Categorieën voorstellen bij een import

Een assistent kan de categorieën van een klaargezette import voor je invullen, ook als je die import zelf in het scherm hebt klaargezet. Hij zoekt de import op, leest de regels die nog een categorie nodig hebben en zet per regel een voorstel met hoe zeker hij is. Daar is geen AI-provider in Muntar voor nodig: de assistent is zelf de AI. Is een regel geld naar of van een eigen rekening, zoals je pensioen of je beleggingsrekening, dan stelt hij een overboeking voor in plaats van een categorie. Een terugbetaling van een winkel kan hij op de oorspronkelijke uitgave zetten, en een voorschot dat later met je inkomen terugkomt op dat inkomen. Zie Terugbetalingen en verrekening.

In het reviewscherm zie je die voorstellen met de bron “Assistent” en een percentage, bijvoorbeeld “Assistent 87%”. Je accepteert ze, past ze aan of negeert de regel, en daarna boek je de import zoals altijd. Een regel die je al beoordeeld hebt, laat de assistent staan.

De regels die de assistent leest, gaan naar de AI achter die assistent. Dat staat los van de keuze “Cloud-provider toestaan” bij de AI-instellingen: die gaat alleen over de provider die Muntar zelf aanroept.

De beoordeling afmaken

Je assistent kan verder gaan dan voorstellen. Hij kan per regel vastleggen wat het is: het soort, de categorie, de eigen rekening aan de andere kant, een aantekening en de status (geaccepteerd, genegeerd of weer open). Tot 1000 regels per keer, dus een afschrift van een heel jaar gaat in een handvol aanroepen.

Een regel die jij al beoordeeld hebt, laat hij niet zomaar staan of vallen: raakt zijn aanroep zo’n regel, dan vraagt de tool eerst om bevestiging en zegt hij om hoeveel regels het gaat. Zolang hij alleen regels raakt die nog open staan, vraagt hij niets, want er valt dan niets van jou te overschrijven.

Voor de rest zijn er twee knoppen in toolvorm. Hij kan de openstaande regels in één keer accepteren, waarbij regels die nog een categorie nodig hebben bewust blijven staan, of ze in één keer negeren, zodat de rest van de import wel geboekt kan worden. Allebei raken ze nooit een regel die al beoordeeld is.

Een klaargezette import kan hij ook weggooien, met bevestiging. De regels van die import zijn dan nog niet geboekt, dus je saldi veranderen niet en hetzelfde bestand kun je daarna opnieuw klaarzetten. Heb je het beginsaldo van die import al apart geboekt, dan blijft die ene boeking wel staan; de bevestiging zegt dat erbij.

Een geboekte regel corrigeren

Staat een boeking eenmaal in je boeken, dan wordt hij nooit aangepast en nooit verwijderd. Je assistent kan hem wel corrigeren, op twee manieren, allebei met bevestiging.

Staat een uitgave of inkomst in de verkeerde categorie, dan boekt hij de oude regel tegen en legt hij een nieuwe vast met hetzelfde bedrag, dezelfde datum en de nieuwe categorie. Hetzelfde als de knop “Categorie wijzigen” in het transactieoverzicht. Bij een overboeking, een kapitaalstorting of een koop kan dat niet: die hebben geen categorie om te wijzigen.

Klopt de boeking helemaal niet, dan boekt hij er een tegenboeking bij. Het origineel blijft staan, met het spiegelbeeld ernaast, en samen zijn ze per saldo nul. Hoort de boeking bij een kapitaalstorting tussen twee entiteiten, dan gaat de gespiegelde helft mee tegen. Voor een hele import is er de aparte tool die de batch in zijn geheel terugdraait.

Categorieën beheren

Past een regel in geen bestaande categorie, dan kan de assistent er een categorie bij maken, op het hoogste niveau of onder een bestaande categorie. Hij kan een bestaande categorie ook een andere naam geven, onder een andere groep zetten, laten opgaan in een andere categorie, verwijderen of archiveren, en een gearchiveerde categorie terugzetten. De boekingen en regels op een categorie blijven bij verplaatsen, hernoemen en samenvoegen gewoon staan; bij verwijderen alleen als de categorie leeg is. Een categorie die Muntar zelf gebruikt kan hij hernoemen en verplaatsen, maar niet verwijderen, archiveren of laten opgaan in een andere categorie. Omdat dit alles je categorieboom verandert, vraagt hij er eerst bevestiging voor, met de naam en, waar dat helpt om te zien wat er gebeurt, de aantallen.

Rekeningen en IBAN’s beheren

Een assistent kan ook je rekeningen inrichten: een rekening aanmaken onder een entiteit, hem hernoemen en archiveren. Alle zeven soorten kunnen, dus ook overig bezit: koop je een auto, dan maakt hij daar een bezitsrekening voor, en wordt de bankregel een overboeking naar die rekening in plaats van een uitgave.

Een IBAN kan hij koppelen en weer loskoppelen. Ook een beleggingsrekening mag er een dragen, want een broker betaalt vaak uit vanaf een rekening op jouw naam. Wat hij niet hoort te doen is een gedeelde stortings-IBAN van een pensioenfonds of een broker aan jouw rekening hangen; dat nummer is van die partij. De bevestiging die je te zien krijgt zegt dat er met zoveel woorden bij, en voor zulke betalingen is een regel de juiste weg.

Regels beheren

Regels die een geïmporteerde transactie automatisch indelen kan hij opsommen, aanmaken, wijzigen en verwijderen. Een regel wijst naar een categorie of naar een eigen rekening; dat laatste maakt van de transactie een overboeking. Een net gemaakte regel kan hij meteen loslaten op een import die al klaarstaat; dat verandert alleen de voorstellen bij regels die nog openstaan.

De bevestigingsstap

Eenentwintig tools vragen altijd eerst om een expliciete bevestiging. Vijf raken je boeken: het boeken van een import, het terugdraaien van een import, het vastleggen van een boeking, het wijzigen van de categorie van een geboekte regel en het tegenboeken van een geboekte regel. Zes raken je categorieboom: een categorie aanmaken, hernoemen, verplaatsen, samenvoegen, verwijderen en terugzetten. Drie raken je regels: een regel aanmaken, wijzigen en verwijderen. Vijf raken je rekeningen: een rekening aanmaken, hernoemen en archiveren, en een IBAN koppelen of loskoppelen. Eén gooit een klaargezette import weg, waar nog niets van geboekt is. En één vinkt een regel in de probleemwachtrij af, want dat zegt dat de oorzaak weg is.

Eén tool vraagt het alleen soms: het beoordelen van importregels vraagt pas zodra de aanroep een regel raakt die al beoordeeld was, en zegt er dan bij om hoeveel regels het gaat.

Je krijgt dan van je assistent een samenvatting te zien van wat er gaat gebeuren. Bij een losse boeking staan daar het bedrag met zijn munt, de rekening, de categorie en de datum in; bij een import de naam van het bestand, de rekening, de entiteit en het aantal regels; bij een categorie de naam en, waar dat helpt, de plek in de boom of de aantallen die de wijziging raakt, zoals bij samenvoegen: “Boodschappen (211 geboekte regels, 3 regels) samenvoegen in Eten › Supermarkt?”; bij een rekening de naam, het soort, de entiteit en wat er met de IBAN gebeurt; bij een correctie van een geboekte regel de omschrijving, de datum, het bedrag met zijn munt en, bij een categoriewijziging, de oude en de nieuwe categorie. Pas als je ja zegt, wordt er geschreven.

Gaat het om een boeking op een rekening in een andere munt dan je basisvaluta, dan staat het omgerekende bedrag er ook bij, met de koers die ervoor gebruikt wordt, de dag waarvan die koers is en waar hij vandaan komt. Bij een koop van een belegging hangt dat aan het totaalbedrag dat van je cashrekening af gaat. Alleen bij een waardering blijft het weg, omdat die pas bij het tonen wordt omgerekend: je ziet daar het bedrag in de munt van de rekening zelf.

Zeg je nee, of annuleer je, dan gebeurt er niets. Ondersteunt je client zo’n bevestigingsvraag helemaal niet, dan gebeurt er ook niets: de tool weigert met de melding dat er geen bevestigingskanaal is, en zet het voorstel in de tekst zodat je het zelf kunt uitvoeren.

Zeven schrijvende tools vragen niets, omdat geen van zevenen een boeking maakt. Drie daarvan zetten alleen een voorstel bij de regels van een import: de tool die de AI-provider van Muntar om categorievoorstellen vraagt, en de twee waarmee de assistent zelf een categorie of een overboeking voorstelt. Een voorstel wordt pas echt als je de regel accepteert en de import daarna boekt. De vierde rekent de voorstellen van een klaargezette import opnieuw uit met je regels, en raakt daarbij alleen regels die nog openstaan. De vijfde en de zesde accepteren of negeren de openstaande regels van een import in één keer; ook die laten een regel die al beoordeeld is met rust, dus er valt geen keuze van jou te overschrijven.

De zevende legt een wisselkoers vast voor één munt en één dag. Dat is geen boeking, maar wel de koers waarmee een latere boeking rekent; die boeking vraagt zelf om bevestiging en laat je dan zien wat de koers van het bedrag maakt. Heeft een boeking de koers eenmaal gebruikt, dan ligt hij vast en kan ook je assistent hem niet meer wijzigen.

Waarom je niet dubbel boekt

Elke aanroep die je boeken raakt draagt een sleutel die de handeling identificeert. Valt de verbinding weg en probeert je assistent het opnieuw, dan herkent Muntar dezelfde handeling. Bij het boeken van een import en bij een losse boeking krijgt hij het antwoord van de eerste poging terug, zonder tweede boeking. Bij het terugdraaien van een import krijgt hij de melding dat die batch niet meer op geboekt staat, en bij het corrigeren van één geboekte regel de melding dat die regel al is tegengeboekt. In geen van beide gevallen komt er een tweede tegenboeking bij.

De tools die geen boeking maken hebben zo’n sleutel niet nodig: een voorstel, een beoordeling of een koers nog een keer wegschrijven vervangt wat er stond, het komt er niet een tweede keer bij.

Wat je achteraf kunt terugzien

Elke schrijvende aanroep laat een spoor achter in het logboek, met de naam van de gebruikte tool en de aantekening dat een AI-agent het deed. Zo is achteraf te zien welke boeking uit een gesprek kwam en welke je zelf in het scherm maakte.

Wat er gebeurt als een waarde niet klopt

Een assistent levert bedragen, datums en codes als tekst aan, en Muntar is streng in die vorm. Een punt is altijd het decimaalteken, een komma en een duizendtalscheiding bestaan niet, en meer decimalen dan de kolom draagt is een weigering en geen afronding. Gaat er iets mis, dan stopt de aanroep voordat er iets is opgeslagen en krijgt de assistent een zin te zien die het veld, de ontvangen waarde en de toegestane vorm noemt, zodat hij het zelf kan herstellen.

Elke weigering, en elke onverwachte fout, komt in de probleemwachtrij te staan. Daar kijk je terug wat er misging, en een assistent kan die wachtrij zelf lezen en een regel afvinken zodra de oorzaak weg is.

Wat een assistent niet kan

Meer dan zijn scopes toestaan. Een key zonder “Schrijven” kan geen boeking vastleggen.
Meer dan zijn rol toestaat. API-keys aanmaken, de AI-provider omzetten of entiteiten aanmaken blijft voorbehouden aan de eigenaar. Zie Rollen.
Bestanden van de server lezen. Een import komt binnen als geplakte tekst, tot 5 MB per keer; grotere exports splits je op. Een pad naar een bestand op de server is geen geldige bron; die weg staat uit.
Onbeperkt aanroepen doen. Er geldt een grens van 120 verzoeken per minuut per agent, plus een ruimere grens per IP-adres.
Iets van een andere werkruimte zien. De key bepaalt de werkruimte, en elke vraag blijft daarbinnen.