Troubleshooting

If something isn't working the way you expect, it's most likely one of these.

The widget doesn't show on the site

• Is the data-tenant-id in the embed code exactly the value from panel → Widget → Setup?
• Is the script before </body> and the URL https://semagent.ai/static/widget.js?
• Is the widget active in the panel? (403 = assistant inactive.)

The widget says "I don't know" but the answer is on the site

• Is that page actually indexed? Search the crawl log; if skipped, the reason is written down (filter, robots, empty content).
• If the page was added recently it may be awaiting a re-crawl — index it manually.
• If it finds the answer when the question is worded differently, add a curated Q&A for that topic in the auto-FAQ.

The crawl fetched fewer pages than expected

• It may have hit the source page-limit; raise the limit.
• The URL filter may be too narrow; check the pattern.
• If there's bot protection, stealth kicked in, but some pages can still be blocked — visible in the log.

The agent task stalled / a tool errored

• The agent doesn't invent a reason: read the diagnostic note in the error (provider limit, empty result, permission).
• Multi-step tasks can resume from where they stopped; the same action never runs twice (idempotency).
• If an approval card is pending, the task isn't "stuck" — answer the card.

Limit reached

Limits are a hard ceiling: when reached, new requests stop and no extra charge occurs. Check the status under panel → Usage; it resumes the moment you upgrade. The widget shows your customer a graceful redirect, not an error.