🛠 Troubleshooting & Known Issues

This page documents common issues, misbehaviors, and how to fix them.

❌ AI Hallucinates Totals or Data

Problem

You asked for a summary, and it made up data instead of using the sheet.

Fix

Check that:

• The system prompt explicitly disables hallucinations
• Tool response is used directly in final reply
• Retrieval tools are connected to AI agent properly

❌ Categories Not Recognized

Problem

You said "snacks" or "internet" — but it didn’t understand.

Fix

Only these categories are allowed: Transportation, Breakfast, Lunch, Dinner, Smoke, Donation, Mobile Recharge, Others If unsure, the AI will ask you before tagging it as "Others".

❌ Mistral API Not Working

Problem

Workflow throws a 401 or hangs on response.

Fix

• Check your Mistral API Key
• Make sure you're using the correct model ID: open-mistral-nemo
• Try hitting their endpoint from Postman to verify

❌ Google Sheets Write Fails

Problem

The entry doesn’t appear in your sheet.

Fix

• Make sure your OAuth2 credential has edit access
• Double-check the Sheet ID and gid=0 is correct
• Try writing manually via the Add Expense node

❌ Calculator Doesn’t Trigger

Problem

You asked for a total but nothing was calculated.

Fix

• Ensure Calculator is wired to AI Agent as a tool
• Make sure your system prompt says:

  "Use the calculator tool when totals/averages are requested"

📬 Need Help?

Open an issue in your homelab log or reach out me via Linkedin or Gitlab.