Probleemoplossing
Een run is mislukt
Hoe je een mislukte run vindt in Geschiedenis, de fout leest en de gebruikelijke oorzaken oplost.
Een run mislukt wanneer een stap niet kan worden afgerond: een tool geeft een fout, een app is niet verbonden, de workspace heeft geen credits of het abonnement staat een stap niet toe. Elke run wordt opgeslagen, dus je kunt achteraf lezen wat er is gebeurd.
Symptomen#
- De agent stopt halverwege of geeft een leeg of algemeen antwoord.
- Een workflow eindigt vroegtijdig, of een batchrij toont Mislukt.
- Een geplande run deed niets.
- Je ziet een foutbanner nadat je op publiceren hebt geklikt, zoals “Validatie mislukt. Los de fouten op die bij de componenten zijn gemarkeerd.”
De run vinden in Geschiedenis#
- Klik op Geschiedenis in de zijbalk.
- Zet het filter Foutmeldingen aan om alleen sessies te tonen die een fout bevatten. Je kunt ook filteren op Agent of workflow en op chatbot.
- Open een sessie. Gebruik Eenvoudig of Uitgebreid om te wijzigen hoeveel detail je ziet.
- Lees de gebeurtenissen van boven naar beneden. Ze zijn gelabeld als Gebruikersbericht, Chatbot-uitvoer, Systeembericht, Chat hook, Tool Call en Agent Query. Kijk bij de Tool Call-gebeurtenissen naar de gebeurtenis die de fout meldt.
Het metriekpaneel boven de tabel (Metrieken tonen) toont Totaal aantal fouten in de tijd. Je abonnement bepaalt hoe ver de geschiedenis teruggaat. Zie abonnementen en limieten. Voor batchruns heeft de tabel de kolommen Status en Fout, en met Mislukte opnieuw uitvoeren of Rij opnieuw proberen voer je de mislukte rijen opnieuw uit.
Veelvoorkomende fouten en oplossingen#
| Wat je ziet | Oorzaak | Oplossing |
|---|---|---|
| “Onvoldoende credits voor deze actie. Vul je credits aan.” | Het saldo is leeg | Geen credits meer |
| “Limiet voor workspace-credits bereikt” | Een bestedingslimiet voor de workspace | Verhoog deze onder Instellingen → Credits |
| “NAME is niet geconfigureerd. Stel eerst de integratie in.” | De stap heeft een app nodig die niet is verbonden | Verbind deze onder Integraties |
| “…is verbonden maar mist de machtigingen die nodig zijn. Verbind de integratie opnieuw en verleen de extra machtigingen.” | De verbinding mist een machtiging | Verbind opnieuw en accepteer elke machtiging |
| “…vereist opnieuw autorisatie. Het refresh token is verlopen of ingetrokken. Verbind de integratie opnieuw.” | De login is verlopen of ingetrokken | Verbind het account opnieuw |
| “Component NAME kan alleen worden gebruikt met een … abonnement” | De stap zit niet in je abonnement | Vervang de stap of upgrade |
| “Toegestane limiet van … bereikt. Upgrade je abonnement.” | Je hebt een abonnementslimiet bereikt tijdens het aanmaken van iets | Verwijder er een of upgrade |
| “Validatie mislukt. Los de fouten op die bij de componenten zijn gemarkeerd.” | Een stap mist vereiste instellingen | Los de gemarkeerde stappen op en publiceer opnieuw |
Geplande runs#
Als de workspace door zijn credits heen is, schakelt het systeem het schema uit in plaats van voor altijd opnieuw te proberen. Open het en schakel het weer in zodra je credits hebt. Zie planningen.
Oplossen#
- Zoek de mislukte sessie en kopieer de exacte fout.
- Zoek deze op in de tabel, pas de oplossing toe en voer dezelfde invoer opnieuw uit.
- Als de fout afkomstig is van een externe service en je kunt niet achterhalen waarom, test de stap dan afzonderlijk vanaf het canvas. Zie testen en uitvoeringslogs.
Bekijk wat een run heeft gekost
Controleer Transacties als je niet zeker weet wat een run heeft verbruikt. Elke kostenpost wordt vermeld met het type en de context. Zie credits.