Jev knowledge base·verified Sep 22, 2026

jev rag groundedness evaluation

Evaluate whether bounded RAG claims are supported by cited passages using Jev while preserving attribution, missing evidence and retrieval errors.

the short answer

Split a generated answer into atomic verifiable claims, pair each claim with its cited passages, and ask Jev a bounded support question such as supported, contradicted, insufficient or not applicable. Preserve citation IDs and full distributions. Evaluate retrieval recall separately because a groundedness judge cannot recover missing evidence, and use humans or an explanatory judge when reviewers need a rationale.

Evaluation unit
One bounded claim plus cited evidence
Recommended outcomes
Supported, contradicted, insufficient, not applicable
Separate metric
Retrieval recall and relevance
Required provenance
Document and passage IDs
Not supplied by Jev
A prose explanation of the verdict

Groundedness Is a Relationship, Not Answer Quality

A response is grounded when its claim is supported by the evidence it cites or was allowed to use. A grounded answer can still be irrelevant, incomplete or based on a poor source. An ungrounded answer may accidentally be true from outside knowledge. Keep factual correctness, citation support, retrieval relevance and task completion as separate measurements.

Ragas similarly distinguishes faithfulness from context precision and other RAG metrics. Its taxonomy is useful independent context, but Jev requires a bounded answer design rather than an open-ended critique. The RAG use-case page maps retrieval and generation stages.

Decompose the Answer Before Judging Support

Jev cannot generate an arbitrary list of claims, so claim extraction is a separate stage. If one sentence contains two propositions, split them when one could be supported and the other unsupported. Preserve offsets into the generated answer so a UI can highlight the affected text.

01Extract claimsParser, human or generative step identifies independently verifiable statements.
02Resolve citationsCode maps each claim to exact permitted passages.
03Judge supportJev evaluates one bounded claim-evidence relationship.
04AggregateCode applies completeness, severity and review rules.
05AuditReviewers see source spans and every component result.
Claim-level evaluation preserves evidence attribution.

Use a Bounded Support Taxonomy

A binary “grounded?” question often forces missing or partial evidence into the same bucket as contradiction. A four-way Choice supports better diagnosis, but it still chooses among supplied options; evaluate an explicit no-fit path if the taxonomy is incomplete. Store probabilities for every relation.

{
  "state": {
    "claim": "The plan includes unlimited API calls.",
    "cited_passages": [
      {"id": "pricing-4", "text": "The plan includes 10,000 API calls per month."}
    ]
  },
  "questions": {
    "support": {
      "type": "choice",
      "instructions": "How does the cited evidence relate to the claim?",
      "criteria": {
        "supported": "The evidence establishes the full claim",
        "contradicted": "The evidence conflicts with the claim",
        "insufficient": "The evidence neither establishes nor conflicts with the full claim",
        "not_applicable": "The text is not a factual claim requiring this evidence"
      }
    }
  }
}

Do Not Leak Retrieval or Answer-Generation Mistakes into the Label

Each stage can fail independently. Feeding all retrieved context rather than the cited evidence can let a judge rescue a bad citation from an uncited passage. Decide whether the metric asks “supported anywhere in context” or “supported by this citation” and encode that difference in state.

FailureMetric owner
Relevant passage was never retrievedRetrieval recall
Retrieved passage is irrelevantContext precision/relevance
Claim lacks or cites wrong passageCitation attribution
Cited passage does not support claimGroundedness
Answer omits requested informationCompleteness/task success

Validate Against Adjudicated Claim-Evidence Pairs

Jev provides no rationale. For high-stakes review, link the verdict directly to the claim and passage and use a human or explanatory model when reasons are required. A rationale must itself be checked against evidence; fluent explanation is not proof.

  • Include explicit support, contradiction, partial support, missing evidence and non-factual language.
  • Label source authority separately from textual entailment.
  • Measure per-class errors, calibration, coverage and aggregation behavior.
  • Slice by claim type, passage length, retrieval rank, language and adversarial text.
  • Compare with a deterministic citation check and an explanatory LLM judge on identical pairs.

Aggregate Without Hiding One Severe Unsupported Claim

A mean groundedness score can let many trivial supported claims cancel one consequential unsupported claim. Preserve claim-level results, weight or veto by impact explicitly, and report both claim coverage and answer-level failure. Missing citations should not be assigned a neutral score.

Use composite scoring only when tradeoffs are deliberate. For production session analysis, attach every result to its trace and citation evidence as described in agent-trajectory evaluation.

FAQ

Can Jev explain why a claim is unsupported?

No. Jev returns a typed decision and probabilities. Preserve the exact claim and passage for human inspection or use a separately evaluated explanatory judge.

Should I give Jev all retrieved documents?

Usually no. Use the evidence relevant to the claim and retain document IDs. Long irrelevant state can reduce Jev 1.13 accuracy.

Is groundedness the same as correctness?

No. Groundedness asks whether supplied evidence supports the claim; source truth and overall answer correctness are separate.

How should I score an answer with several claims?

Keep claim-level results and define explicit answer-level rules. Do not let many trivial claims average away one serious unsupported claim.

Sources

Checked against the sources below on September 22, 2026. Model versions, prices and limits change.

  1. TypeSafe AI docs: Primitives
  2. TypeSafe AI docs: State
  3. TypeSafe AI docs: Jev 1.13 jaggedness
  4. LangChain: Can Jev be a better agent evaluator?
  5. OpenTelemetry: GenAI semantic conventions
  6. Ragas: Context precision and faithfulness metrics