Papers
Topics
Authors
Recent
Search
2000 character limit reached

RAGEval: RAG Evaluation Framework

Updated 21 April 2026
  • RAGEval is a schema-based framework that extracts key document slots and generates QRA triples to systematically evaluate RAG systems.
  • It employs a hybrid rule-based and LLM-driven approach to synthesize domain-specific documents and configurations for robust benchmarking.
  • The framework introduces precise metrics for completeness, hallucination, and irrelevance, validated through human and automated quality checks.

Retrieval-Augmented Generation (RAG) evaluation frameworks address the critical need for robust, scenario- and domain-specific benchmarking of RAG systems in settings where real-world documents and specialized knowledge bases are involved. RAGEval is a framework designed for systematic, schema-driven evaluation and benchmarking of RAG pipelines, enabling the rigorous assessment of factual completeness, hallucination rates, and irrelevance in model outputs, and providing high-fidelity synthetic data for both retrieval and generation tasks (Zhu et al., 2024).

1. Schema-Based Pipeline Architecture

RAGEval operates through a four-stage schema-based pipeline:

  1. Schema Summarization: Beginning with a pool of seed, domain-specific documents (e.g., financial, medical, or legal records), the framework interacts with an LLM to extract the essential "slots" representing entities, values, and events required for domain coverage. Iterative prompting and human-in-the-loop refinement yield a formalized schema S\mathcal S representing the data structure.
  2. Configuration Generation & Document Synthesis: Schema S\mathcal S is instantiated across diverse configurations {Ci}\{\mathcal C_i\} using a hybrid rule-based (for structured fields) and LLM-based (for narrative fields) approach. Each configuration becomes a synthetic document Di\mathcal D_i generated in target style.
  3. QRA Generation (Question–Reference–Answer Triples): For each synthetic document, the system prompts an LLM to create diverse question–initial answer pairs (qj,aj(0))(q_j, a^{(0)}_j). It then automatically extracts minimal supporting reference spans {rj,k}\{r_{j,k}\} and enforces answer grounding by aligning each fact in aj(0)a^{(0)}_j to evidence in Di\mathcal D_i. Final keypoints KjK_j are distilled from each refined answer aja_j.
  4. Human and Automated Quality Verification: Human annotators validate a random subset of data for factual correctness and document quality. Automated metrics are cross-validated against these human judgments to ensure reliability and stability.

This schema-to-data process enables RAGEval to efficiently build domain-meaningful, large-scale evaluation datasets suitable for real-world RAG settings, as summarized by the following pipeline:

{Ci}\{\mathcal C_i\}5 (Zhu et al., 2024)

2. Formal Definitions of Core Metrics

RAGEval introduces three principal metrics for evaluation at the fine-grained, keypoint level. Given a QA pair S\mathcal S0 and its reference keypoints S\mathcal S1, these are:

  • Completeness:

S\mathcal S2

Fraction of required facts present in the answer.

  • Hallucination:

S\mathcal S3

Fraction of facts in S\mathcal S4 that are contradicted (i.e., clear hallucinations).

  • Irrelevance:

S\mathcal S5

Fraction of required facts not present and not contradicted.

Retrieval metrics include:

  • Recall:

S\mathcal S6

Proportion of instances where all ground-truth references S\mathcal S7 are contained in retrieved passages S\mathcal S8.

S\mathcal S9

Fraction of retrieved tokens that are genuinely informative for the reference. (Zhu et al., 2024)

3. Dataset Construction and Validation

The framework, as instantiated in the DragonBall dataset, covers finance, law, and medical domains across Chinese and English languages. For each domain:

  • Documents per language: 40 finance, 30 legal, 38 medical.
  • Generated QRA triples: 6,711, encompassing factual, multi-hop, summarization, info-integration, numeric comparison, time-series, and unanswerable types.
  • Benchmarks against zero-shot and one-shot document generation approaches (single-prompt or with one example), with RAGEval outperforming both in human ratings for safety, clarity, conformity, and richness.

Comprehensive human annotation was performed on 420 random QRA triples across domains/languages. RAGEval’s automated metric scores for Completeness, Hallucination, and Irrelevance showed absolute deviations of less than 0.015 from human judgment, confirming high consistency. (Zhu et al., 2024)

4. Experimental Results and Retrieval/Generation Benchmarks

Retrieval experiments employed BM25, GTE-Large, BGE-Large, and BGE-M3 (for both Chinese and English), while generation tested MiniCPM-2B-sft, Baichuan-2-7B-chat, Qwen1.5/2, Llama3-8B-instr, GPT-3.5-Turbo, and GPT-4o.

Key quantitative findings include:

  • Generation Results: GPT-4o achieved the best Completeness ({Ci}\{\mathcal C_i\}0 CN, {Ci}\{\mathcal C_i\}1 EN) and lowest Hallucination, but competitive performance was observed in Qwen1.5-14B and Llama3-8B.
  • Retrieval: BGE-M3 excelled in Chinese (Recall {Ci}\{\mathcal C_i\}2, EIR {Ci}\{\mathcal C_i\}3) with the best downstream Completeness and Hallucination. GTE-Large led in English.
  • Hyperparameters: TopK sweeps (2–6) increase recall and completeness, with chunking strategies yielding domain- and language-specific best practices (smaller, more chunks for Chinese; moderate-size, fewer for English). (Zhu et al., 2024)

5. Algorithmic and Implementation Principles

The hybrid schema-to-data paradigm unifies rule-based strictness for structured fields with LLM-driven diversity for narrative fields. Each configuration {Ci}\{\mathcal C_i\}4 is deterministically mapped to a synthetic document and a set of QRA triples (including prominence of answer grounding and minimal hallucination risk).

Released code supports:

  • Data and QRA artifact management (data/dragonball/, configs/)
  • Modular shell scripts for each pipeline stage (extraction, config generation, document synthesis, QRA generation, retrieval/generation evaluation)
  • Implementation of metrics and unit tests (src/metrics.py)
  • Human annotation templates and guidance (human_eval/) (Zhu et al., 2024)

6. Limitations and Prospects for Extension

RAGEval is reliant on the foundational quality of the prompting LLM for both schema extraction and keypoint mining, necessitating manual schema cleaning and answer correction if the base model exhibits high hallucination rates. The dataset construction methodology is currently validated on finance, law, and medical domains; generalization to domains with high narratological or non-tabular complexity may require further adaptation (such as unsupervised schema induction).

The granularity of evaluation (via Comp/Hallu/Irr) depends on accurate keypoint extraction, suggesting that future enhancements using improved semantic overlap measurement may refine these metrics. Further, the semi-automation of schema and answer refinement is labor-intensive, motivating exploration into active learning or more refined LLM-driven filtering.

The general framework and its metrics provide a blueprint for scalable, high-fidelity RAG evaluation in both academic and industrial environments, and open avenues for further benchmarking and pipeline tuning across verticals (Zhu et al., 2024).


References:

  • "RAGEval: Scenario Specific RAG Evaluation Dataset Generation Framework" (Zhu et al., 2024)
Definition Search Book Streamline Icon: https://streamlinehq.com
References (1)

Topic to Video (Beta)

No one has generated a video about this topic yet.

Whiteboard

No one has generated a whiteboard explanation for this topic yet.

Follow Topic

Get notified by email when new papers are published related to RAGEval Framework.