AI Status
The portal runs a quiet heartbeat against your configured AI provider via the local agent so you find out about a broken connection before you need it. The state shows in the AI badge in the top bar.
The four states
| Badge | Meaning |
|---|---|
| AI ready | Provider responded. Brain, Swarm enrichment and Auto-Fix are available. |
| Local | A local provider (Ollama, LM Studio, AI Proxy). No cloud check runs. |
| Check AI | The provider failed. Hover the badge to see the error message. |
| Connect AI | No credentials are saved. Open Settings → AI Providers to add a key. |
When the heartbeat runs
- 5 minutes after the agent connects, then every 5 minutes
- Skipped while the portal tab is hidden
- Throttled if a manual check ran in the last 60 seconds
- Never blocks the UI; failures only update the badge
Manual check
Click the badge → Test now to force a heartbeat. The portal sends the request through the agent so the test path matches real production calls (proxy, CA, region).
What's tested
- Reachability (TCP / TLS handshake)
- Authentication (the configured key against a low-cost endpoint)
- Default model availability
