​
Reproduce locally

  1. Reproduce using the same environment and endpoints as the report (see your private runbook for uvicorn or Compose usage).
  2. Note x-correlation-id from API responses and search logs for that value.
  3. Trace from the router into services and repositories rather than guessing at the database first.

​
Frequent causes

SymptomWhat to verify
Cross-origin (browser) errorsServer allowlist matches the exact frontend origin your deployment uses (scheme, host, and port).
401 / 403Session or token validity, expiry, and organization authorization for the route.
Agent slowness or errorsProvider status, rate limits, and simulation settings that increase load.
Poor or empty retrievalQdrant health, collection presence, embedding pipeline.

​
Database access

Prefer staging for exploratory queries. In production, use read-only credentials and your organization’s data-handling policy.