# Troubleshooting

## Search returns server error

- Confirm required Parquet files exist in `sample_databases`.
- Check deployment logs for missing-file paths.
- Restart app workers after data refresh.

## Analyze does not run

- Verify query is not empty.
- Retry with a known query (`CD63`, `SNCA`, `hsa-miR-7-5p`).
- Hard refresh to clear stale JS bundles.

## Pathway or Disease appears empty

- Wait for Summary to finish loading first.
- Re-open the tab after a short delay.
- Confirm the correct node or collection is active.

## EV-TRACK fields appear sparse

- Some source rows do not include EV-TRACK metadata.
- Export full EV evidence rows to inspect provenance fields.

## Assistant response is off-context

- Use context-specific prompts (`explain this summary`, `open pathway tab`).
- Avoid multi-intent prompts in one message.
- Start a fresh query when biological scope changes.

## UI shows old assets

- Hard refresh browser cache.
- Confirm latest asset version is loaded.
- Clear service worker/site cache if needed.

## Runtime health checks

- Check `/api/platform_stats` for service-level status.
- Check `/api/agent/runtime_status` for assistant runtime availability.