RAG Evaluation
Use when asked to measure a RAG retriever or inspect an evaluation fixture.
- Confirm the dataset is synthetic, public, or authorized; never send private text to a provider.
- Run
python rag-evaluation/scripts/evaluate.py <fixture.json>. - Report hit rate, failed query IDs, fixture size, and the exact command.
- Separate retrieval quality from answer quality. Do not claim semantic correctness from hit rate.
- If an Ollama experiment is requested, use the local endpoint in
.env.exampleand preserve the deterministic baseline. For commercial models, require an explicit adapter and environment-only credential; never place a key in prompts, source files, or output.
Expected fixture keys are documents (id, text) and queries (id, query, expected_id).
The safe script performs lexical ranking only, makes no network calls, and writes no files.