Bronnen · 09

RAG-kwaliteit: evalueer een kennisassistent met bewijsmateriaal

Meet corpus, retrieval, citaties, antwoorden, onthouding en drift afzonderlijk, zodat u weet wat er echt moet worden aangepast.

Bijgewerkt · 9 min

Fictieve lege archiefruimte met zes blanco documentbakken, bordeauxrood dossier en messing lamp Redactionele illustratie gegenereerd met AI

Wat deze handleiding helpt bereiken

  • Bepaal of de fout te wijten is aan het corpus, de retrieval of het model
  • Traceer elke citatie
  • Beloon gepaste onthouding
  • Detecteer afwijkingen na wijziging

Snelle controle

  • Is de referentiebron geautoriseerd en actueel?
  • Staat de juiste passage bovenaan?
  • Wordt elke doorslaggevende bewering onderbouwd?
  • Kan de assistent aangeven dat hij/zij het niet weet?
  • Worden gevoelige gevallen geëscaleerd?

Stapsgewijze methode

  1. 1

    Definieer nuttige taken

    Verzamel echte vragen, hun varianten en het verwachte bedrijfsresultaat. Voeg ambiguïteit, bronconflicten, verlopen documenten en verzoeken buiten de scope toe.

    Resultaat: taxonomie van casussen en risico's.

  2. 2

    Reinig het corpus

    Wijs aan elke bron een eigenaar, rechten, geldigheidsdatum en status toe. Verwijder duplicaten, weesfragmenten en documenten van onbekende autoriteit.

    Resultaat: corpusregister.

  3. 3

    Evalueer de retrieval

    Meet of de benodigde passages zijn gevonden en gerangschikt voordat de definitieve formulering wordt beoordeeld. Inspecteer zoekopdrachten waarvoor geen bewijs bestaat.

    Resultaat: dekkings- en relevantiemetingen.

  4. 4

    Evalueer antwoorden en citaten

    Controleer de trouw aan passages, volledigheid, beperkingen, de relatie tussen citaat en bewering en de mogelijkheid om tegenstrijdigheden te signaleren.

    Resultaat: beoordelingsschema voor trouw en bruikbaarheid.

  5. 5

    Test weigering en aanvallen

    Voeg indirecte injectie, verboden gegevensverzoeken, kwaadwillige bronnen, documenten met valse prioriteit en onomkeerbare acties toe. Definieer menselijke escalatie.

    Resultaat: beveiligingsresultaten en -richtlijnen.

  6. 6

    Monitor wijzigingen

    Versiebeheer van corpus, index, instellingen, model en instructies. Speel de stabiele set opnieuw af bij elke wijziging en analyseer de daadwerkelijke feedback zonder onnodige gegevens te bewaren.

    Resultaat: driftdashboard en beoordelingsprocedure.

Begrijpen, berekenen en beslissen

AI-antwoorden: kwaliteit, dekking en onthouding onderscheiden

Tel geteste vragen, gegeven antwoorden en gevalideerde antwoorden apart. Dit educatieve CIE-model is geen NIST-score en stelt geen universele goedkeuringsgrens vast.

Gebruik hier alleen vragen waarop een antwoord werd verwacht. Leg validatie vooraf vast: juist antwoord, daadwerkelijk ondersteunende passage, toegestane toegang en actuele bron. Beoordeel verwachte onthouding, tegenstrijdigheden en ernstige fouten afzonderlijk.

Kengetallen en bewijs

KengetalBetekenisBenodigd bewijs
Geteste vragen Verzameling met verwacht antwoord Vragen, criteria en vastgelegde versies
Gegeven antwoorden Vragen waarop is geantwoord Bewaarde antwoorden en onthoudingen
Gevalideerde antwoorden Antwoorden die aan het criterium voldoen Oordeel en ondersteunende passage

Fictief uitgewerkt voorbeeld

Fictief voorbeeld: 100 vragen, 80 antwoorden en 72 gevalideerd. Kwaliteit onder antwoorden: 90%; dekking: 80%; succes in de hele verzameling: 72%. Alleen 90% tonen verbergt 20 onbeantwoorde vragen en 8 niet-gevalideerde antwoorden.

Verdeling van het fictieve voorbeeld
  • 72 / 100 · Gevalideerd
  • 8 / 100 · Niet gevalideerd
  • 20 / 100 · Onbeantwoord

100 = 72 + 8 + 20. Onbeantwoorde vragen blijven zichtbaar; dit zijn geen metingen van deze site.

Rekenregel

Kwaliteit = gevalideerd / gegeven. Dekking = gegeven / getest. Succes = gevalideerd / getest. Bij een noemer van nul is de verhouding niet berekenbaar.

Fictief uitgewerkt voorbeeld

Illustratieve situatie

Een interne assistent beantwoordt vragen op basis van procedures, waarvan sommige verlopen zijn. De testset bevat routinematige, ambigue en onbeantwoordbare vragen; elke verwijzing wordt gecontroleerd aan de hand van de documentversie.

Beslissing en verwachte bewijs

Vrijgave wacht totdat verlopen bronnen zijn uitgesloten, niet-onderbouwde antwoorden zijn geweigerd en de eigenaar van het corpus is geïdentificeerd.

Managementindicatoren

IndicatorWat het meetEerste actie
Dekking van de zoekopdrachtVragen waarvoor de benodigde passages zijn gevondenCorpus, chunking of zoekopdracht corrigeren vóór het model
BetrouwbaarheidBeweringen die daadwerkelijk worden ondersteund door geciteerde bronnenOnondersteunde antwoorden blokkeren of herschrijven
Nuttige onthoudingGevallen zonder bewijs correct afgewezen of geëscaleerdBetrouwbaarheidsdrempels afstemmen
RegressieKwaliteitsverschil tussen versies op dezelfde datasetDe verantwoordelijke wijziging identificeren

Veelvoorkomende fouten

  • Alleen schrijfvaardigheid meten
  • Ophaalfouten en hallucinaties combineren
  • Een te gemakkelijke evaluatieset gebruiken
  • Verschillende componenten wijzigen zonder vergelijking

Veelgestelde vragen

Hoeveel vragen zijn er nodig?

Begin met een representatieve, versiebeheerde dataset die belangrijke risico's dekt. ​​Diversiteit en kwaliteit zijn belangrijker dan een kunstmatig volume.

Is één geautomatiseerde meetmethode voldoende?

Nee. Het versnelt de triage, maar gevoelige, ambigue en domeinspecifieke gevallen vereisen expliciete criteria en menselijke beoordeling.

Moet elk gesprek bewaard worden?

Nee. Bewaar alleen de noodzakelijke gegevens met een duidelijk omschreven doel, toegang en duur. Geef de voorkeur aan geanonimiseerde gevallen voor verbetering.

RAG: toegangsrechten, citaten en caches

De uitgebreide toelichtingen zijn in deze editie beschikbaar in het Engels.

Evaluate an answer alongside its document rights

A relevant citation can support an accurate answer while revealing a forbidden document. RAG evaluation should separate faithfulness, freshness and authorisation of passages actually supplied to the model.

  • Annotate permitted documents for each test identity.
  • Remove a group and replay an existing conversation and citation.
  • Track incorrect answers, missing evidence and out-of-scope exposure separately.

Explore the RAG access matrix and replay cases →

References consulted on · OWASP · LLM08:2025 Vector and Embedding Weaknesses OWASP · API1:2023 Broken Object Level Authorization

AI: een JSON-resultaat controleren

De uitgebreide toelichtingen zijn in deze editie beschikbaar in het Engels.

A retrieved reference does not prove the extracted value

A RAG system can find the right document and return schema-valid JSON that misstates a field. Separate retrieval, the output contract and passage reconciliation to locate what needs correction.

  • Keep an independent reference for decisive fields.
  • Test missing values, contradictions and unavailable documents.
  • Retain unexecuted checks as such instead of counting them as passes.

Compare the 14 outputs and their reasons →

Sources reviewed on · IETF · RFC 8259 · JSON Schema · Object reference · JSON Schema · Draft 2020-12 validation · Python 3.12 · json decoder · python-jsonschema · Schema validation · OWASP · LLM05:2025 Improper Output Handling

RAG: relevantie en rangschikking

De uitgebreide toelichtingen zijn in deze editie beschikbaar in het Engels.

A RAG system can retrieve useful documents and still produce an incorrect answer. Retrieval evaluation therefore needs its own questions, relevance judgments and defined reading depth. This dossier explains four ranking measures without confusing them with answer faithfulness, access permissions or guaranteed business outcomes.

Documentary references: Stanford CS276’s evaluation material from the 2019 archive and NIST TREC’s reciprocal-rank definition. The CIE workshop uses binary judgments and one query at a time. RR@k here is truncated at k; MRR is a mean RR across multiple queries and is not computed by this workshop.

Stanford CS276 · Retrieval evaluation · 2019 course archive · PDF pp. 3, 5–6 · consulted 2026-10-23

Four measures, four different questions

Four measures, four different questions
MeasureWorkshop calculationUseful readingCondition or limitation
Precision@kRelevant results in the first k / kMeasures the useful proportion in the inspected window.Unavailable if any judgment is missing in the first k.
Recall@kRelevant results in the first k / RR is the number of relevant records in the entire small judged corpus.If R is unknown, publish a value only when it is defined and identical in every possible case.
RR@k1 / rank of the first relevant result within kEquals 0 when no relevant record appears in that fully judged window.An unjudged record before the first relevant result makes that rank uncertain.
nDCG@kDCG@k / IDCG@kCompares ranking gain with the ideal order at the same k.Unavailable if the value changes across possible cases or any case has a zero ideal.

Explicit convention: judgment rᵢ is 0 or 1; DCG@k = Σᵢ₌₁ᵏ rᵢ / log₂(i + 1). With binary relevance, gain 2ʳⁱ − 1 also equals rᵢ. IDCG@k puts min(R, k) relevant records first using the same discount. nDCG@k = DCG@k / IDCG@k when that ideal is defined and nonzero. Keep gain, discount, depth and conventions with any published score.

NIST TREC · Reciprocal rank definition · Repository snapshot 35cf096ba6d5ae08ca4803c056b31ed61a56a6d4 · consulted 2026-10-23

A fictional six-record corpus with declared judgments

Titles and judgments below are created for this exercise. They are neither real search results nor automatic title-based judgments. 1 means relevant, 0 nonrelevant and ? unjudged. Columns Q1–Q5 correspond to the needs displayed in the workshop.

  • Q1 · Prepare a restoration test
  • Q2 · Authorise a document read
  • Q3 · Check a quantum sensor
  • Q4 · Restoration test: C judgment missing
  • Q5 · Restoration: B unjudged, other records off-topic
A fictional six-record corpus with declared judgments
Fictional recordQ1Q2Q3Q4Q5
A · Restoration procedure10011
B · Recovery budget1001?
C · Restoration test log100?0
D · Account and permission guide01000
E · Archiving policy00000
F · Publication schedule00000

Documentrangschikking oefenen

Choose a need and enter an ordered list of A–F identifiers separated by commas. Change k to inspect only the first k results. The list may omit documents, but each identifier must be unique and k cannot exceed its length. Calculation stays local without collection, import, transmission, storage or export.

This reader queries no search engine, private corpus or AI model. It measures neither answer truth, correct citation nor permission security. Scores concern declared judgments in this small fictional universe. Do not present an exercise value as a benchmark of your system or a universal deployment threshold.

Unjudged and nonrelevant are different states

Unjudged and nonrelevant are different states
SituationCIE educational convention
Missing judgment within kPrecision may vary. Reciprocal rank remains known if the first relevant record is identified before any unjudged record.
Missing judgment elsewhereR becomes a range of possibilities. Do not assume recall and nDCG are always unknown: a value may remain constant, for example when the order is ideal in every case.
No relevant record in a fully judged corpusPrecision@k and RR@k are 0. The reader shows Recall@k and nDCG@k as unavailable for this zero-denominator case.
CIE publication ruleExplore every binary assignment of missing judgments, at most 64 for six records. Publish a measure only if it is defined and identical in every assignment. These are possibilities, with no probabilities assigned and no actual imputation.

Ten explained scenarios, available without JavaScript

K01 · Relevant records first
Relevant records first
NeedSupplied orderkExpected reading
Q1A,B,C,D,E,F3Precision@3 = 1, Recall@3 = 1, RR@3 = 1 and nDCG@3 = 1 in this fully judged corpus.
K02 · Relevant records after cutoff
Relevant records after cutoff
NeedSupplied orderkExpected reading
Q1D,E,F,A,B,C3All four measures are 0 at k = 3. Relevant records exist but are placed after the inspected window.
K03 · First relevant record at rank two
First relevant record at rank two
NeedSupplied orderkExpected reading
Q1D,A,E,B,F,C3Precision@3 and Recall@3 are 1/3; RR@3 is 1/2. nDCG considers position and the ideal order.
K04 · Relevant records omitted
Relevant records omitted
NeedSupplied orderkExpected reading
Q1A,D,E,F3R remains 3 in the corpus even though B and C are absent from the list. Recall must not use only returned results as its denominator.
K05 · Duplicate identifier
Duplicate identifier
NeedSupplied orderkExpected reading
Q1A,A,B3Input rejected: A must not be counted twice. Correct the ranking rather than inflating the relevant count.
K06 · Unjudged before the first relevant record
Unjudged before the first relevant record
NeedSupplied orderkExpected reading
Q4C,A,D,E,B,F3C is unjudged. Precision@3, Recall@3, RR@3 and nDCG@3 are unavailable under the declared conventions.
K07 · Unjudged after the window
Unjudged after the window
NeedSupplied orderkExpected reading
Q4A,B,D,E,F,C3Precision@3 is 2/3 and RR@3 is 1. Recall@3 and nDCG@3 remain unavailable because C’s corpus judgment is missing.
K08 · Need with no relevant record
Need with no relevant record
NeedSupplied orderkExpected reading
Q3A,B,C,D,E,F3Precision@3 and RR@3 are 0. Recall and nDCG remain unavailable; this is an explicit convention rather than division by zero.
K09 · Change reading depth
Change reading depth
NeedSupplied orderkExpected reading
Q2A,D,B,C,E,F1At k = 1 no relevant record is visible. At k = 2, D appears: precision 1/2, recall 1 and RR@2 = 1/2.
K10 · Unknown relevance, always ideal ordering
Unknown relevance, always ideal ordering
NeedSupplied orderkExpected reading
Q5A,B,C,D,E,F2B may be relevant or not. Either way, all relevant records are within the first two ranks and the order stays ideal: recall, RR and nDCG are 1. Precision remains unknown.

Prepare a reproducible evaluation

Prepare a reproducible evaluation
Suggested checkRecord to retain
NeedsRepresentative and unanswerable questions; specify the documentary need behind each wording.
CorpusDocument and index versions, accessible scope and deletion or revocation rules.
JudgmentsRelevance rule, assessors, disagreements and unjudged state; do not equate clicks with documentary truth.
ProtocolSame k, filters, data and conventions before and after a retrieval change.
RegressionPer-query and per-need-family results, gaining and losing cases, hypothesis and checks on new documents.
Final answerEvaluate faithfulness, citations, useful refusals and permissions separately; better retrieval scores do not validate this stage.

For a reviewable decision, keep the question, ranking, judgments, k and corpus limitations with the score. One average can conceal a regression on a critical need. Error tracking and answer review remain necessary even when the first records are relevant.

Sources, editions and credits

Original CIE explanations, six documents, five needs, judgments and scenarios. Conceptual references: Stanford CS276 and NIST TREC’s reciprocal-rank definition. No source chart, ranking example or code is reproduced. The CIE program and its unavailable-value conventions are not a complete trec_eval implementation.

Stanford CS276 · Retrieval evaluation · 2019 course archive · PDF pp. 3, 5–6 · consulted 2026-10-23

SHA-256 : be38261a8cdbc95551a502504d0a1c146ea453ffd9712243ea067ac8538c1826

NIST TREC · Reciprocal rank definition · Repository snapshot 35cf096ba6d5ae08ca4803c056b31ed61a56a6d4 · consulted 2026-10-23

SHA-256 : 64159909e6e1e4e9e4dd3c569b119fdc90696d0b03cd902e6a9358dcd6e84677

Officiële referenties

Referenties ondersteunen de methode. Pas controles aan uw context aan; ze zijn geen certificering. Originele referentietitels en brondocumenten kunnen in een andere taal zijn.

Bronnen geraadpleegd op .