AI and Agent Troubleshooting

Use this Learnitive checklist when AI Assistant, AI Agent, AI Web App Builder, BYOK or local-model workflows are unavailable or return an error.

Identify the provider path

Open AI Settings and confirm whether the workflow is using browser Local AI, Ollama or a BYOK cloud provider. The troubleshooting steps differ: a local model may need downloaded assets, Ollama needs its localhost service, and BYOK needs a valid provider credential/network path.

Check privacy mode

Privacy Mode can intentionally block cloud-backed context. If a workflow requires cloud context and Privacy Mode is enabled, switch to an allowed local path or explicitly change the privacy/provider configuration rather than treating the block as a model failure.

Agent readiness

AI Web App Builder and project Agent workflows require an Agent-capable setup. If Build with AI opens settings or says setup is incomplete, finish the supported provider/model configuration first.

Use project evidence

For coding failures, give the AI the relevant file/error rather than repeatedly asking the same generic question. Agent works best with a bounded objective and a verification command.

Protect secrets

Never solve an authentication error by committing an API key into project source. Keep BYOK credentials in the AI settings path and repository credentials in the Git workflow.

Ollama-specific issues

For local Ollama detection, continue with Ollama Troubleshooting. For provider concepts, see AI in Learnitive and BYOK AI Providers.