Troubleshooting
Resolve common issues in authentication, model responses, and connector execution.
Use this sequence to diagnose issues quickly and avoid broad retries that add noise.
Triage Flow
- Confirm the failing surface (auth, model output, connector).
- Reproduce once with a minimal query.
- Capture exact error text and relevant timestamp.
- Apply the targeted fix and re-run the same test.
Common Issues
Empty or Weak Response Quality
- Add concrete scope and timeframe.
- Ask for sources explicitly.
- Re-run with detailed mode only after tightening prompt structure.
Connector Failures
- Verify endpoint URL and token validity.
- Check host allowlist and TLS requirements.
- Reduce query breadth and retry with a short time window.
Authentication Errors
- Refresh session.
- Confirm account approval state.
- Retry with a fresh token.
When To Escalate
- Reproducible connector failures persist after credential and host checks.
- Authentication fails for approved users across multiple sessions.
- Model quality regresses for known-good prompts with valid sources.