Problemen

This content is not available in your language yet.

Op “Problemen” staat wat Muntar heeft geweigerd omdat hij de waarde niet kende of niet verwachtte, en wat er onverwacht misging. Dat gebeurt vooral aan de kant van een assistent: die levert waarden aan via een MCP-tool, en een waarde die er net anders uitziet dan afgesproken gaat niet door. Het scherm is er voor de eigenaar van de werkruimte.

Je vindt het onder “Instellingen”, in de rij links, onder “Problemen”.

Wat erin komt

Twee soorten regels:

Soort	Wanneer	Wat er is gebeurd
Invoer geweigerd	Een waarde had een vorm die Muntar niet accepteert, of een soort die niet klopt (een getal waar tekst hoort, een keuze die niet bestaat, een veld dat ontbreekt)	Niets. De aanroep is gestopt voordat er iets werd opgeslagen
Onverwachte fout	Er ging iets stuk dat we niet hadden voorzien	De aanroep is afgebroken; wat er vóór de fout al gelukt was, blijft staan

Gewone vergissingen in een formulier op het scherm staan er niet in. Een verkeerd bedrag dat je zelf intypt en dat rood wordt, is dagelijks gebruik en geen probleem dat iemand moet oplossen.

Wat er per regel staat

Wanneer het gebeurde.
Waar: de naam van de tool, bijvoorbeeld muntar_create_account.
Wat: de melding die de assistent terugkreeg, met de code en het veld eronder.
“Ontvangen”: de waarde zoals die binnenkwam, ingekort.
Door: de naam van de API-key of het lid dat de aanroep deed.
De status: open of afgehandeld.

De code zegt om welk soort waarde het ging: AMOUNT, QUANTITY, RATE, DATE, CURRENCY of ID bij de eigen controle, en SCHEMA als de waarde al op de vorm van de tool zelf strandde (een verkeerd soort waarde, een onbekende keuze of een ontbrekend veld). Bij een onverwachte fout staat er de naam van de fout, of OUTPUT_SCHEMA als het antwoord van de tool zelf niet klopte met wat die tool belooft terug te geven.

Een IBAN staat er gemaskeerd in, bijvoorbeeld NL91****4300. Een e-mailadres en een databaseverbinding worden op dezelfde manier onleesbaar gemaakt. Wachtwoorden, tokens en sleutels komen er nooit in.

De wachtrij loopt niet vol

Er staan hoogstens vijfhonderd open regels per werkruimte. Een assistent die in een lus dezelfde fout blijft maken, kan de wachtrij zo niet laten dichtslibben. Is die grens bereikt, dan komt er één regel bij met de code QUEUE_FULL die dat zegt, en worden nieuwe problemen niet meer vastgelegd. Een assistent die op dat moment tegen een fout aanloopt, krijgt dat ook te horen.

Vink regels af om weer ruimte te maken; afgehandelde regels tellen niet mee. Daarna legt Muntar nieuwe problemen gewoon weer vast.

De regels voor waarden

Alles wat een assistent aanlevert gaat door dezelfde grens:

Soort waarde	Wat mag	Voorbeeld
Bedrag	Punt als decimaalteken, hoogstens vier decimalen, geen duizendtalscheiding, geen komma, geen valutateken	`15000.00`
Aantal	Hetzelfde, hoogstens acht decimalen	`5.25`
Koers	Hetzelfde, hoogstens tien decimalen	`0.0407`
Datum	`JJJJ-MM-DD`, en een datum die echt bestaat	`2026-09-18`
Valuta	Een bekende ISO-code van drie letters	`EUR`
Id	Precies zoals een lees-tool hem teruggeeft

Een punt is dus altijd het decimaalteken. 1.234 is 1,234 en nooit 1234. Drie decimalen blijven drie decimalen: staat er een cijfer te veel voor de kolom, dan weigert Muntar in plaats van af te ronden. De weigering noemt het veld, de waarde die binnenkwam en de vorm die wel mag, zodat een assistent het zelf kan herstellen en het opnieuw kan proberen.

Voor bankbestanden geldt dit niet. Een import leest een bedrag zoals de bank het schrijft, met een komma of met een punt, want daar hoort de schrijfwijze bij het bestand.

Een regel afhandelen

Los eerst de oorzaak op. Ging er een bedrag mis, spreek dan met je assistent af hoe hij bedragen aanlevert; ging er iets stuk, dan hoort dat gerepareerd te worden. Klik daarna op “Afvinken”. Je krijgt eerst de vraag of je het zeker weet.

De regel blijft staan. Met het filter “Afgehandeld” kijk je terug wat er ooit is opgelost, en met “Alles” zie je beide. Afvinken zonder de oorzaak weg te nemen levert alleen een wachtrij op die morgen weer vol staat.

Een assistent kan dit ook zelf: muntar_list_problems leest de wachtrij en muntar_resolve_problem vinkt een regel af, met een korte notitie erbij over wat de oorzaak was. Die tool vraagt eerst om bevestiging. Een API-key op een alleen-lezen lidmaatschap komt er niet in: een regel kan een interne foutmelding dragen, en die is voor wie het oplost.