1.7 KiB
Citations
Eigenschappen
Een citation is immutable en verwijst naar:
- workspace/space;
- document en documentversion;
- chunk en parentchunk;
- pagina, sectie of regelbereik;
- excerpt en excerptchecksum;
- source URI en acquisition timestamp;
- retrieval run en gebruikte index/profileversie.
ID
Deterministische UUIDv5 of stabiele opaque ID op immutable citationinputs. Een latere documentversion verandert een bestaande citation niet.
Presentatie (1.2.0)
Naast de machine-velden levert iedere citation in /v1/search, /v1/context en
/v1/answers leesbare provenance, opgelost uit het Source Registry:
source_id, source_name, source_kind, locator (item binnen de bron),
revision (bijv. Git-commit van de geciteerde versie) en display, bijvoorbeeld
Network Design.pdf · p. 18 · Firewall Segmentation of
infrastructure/runbooks/backup.md · commit 3fc821a · lines 118-143.
source_uri (ragcore://source/<source_id>) blijft de stabiele interne locator.
Een citation is herleidbaar tot bron → item (locator) → versie
(document_version_id + revision) → chunk (id, excerpt_sha256) → locatie
(sectie/pagina/regels). Autorisatie verandert hierdoor niet: de presentatie
resolvet alleen documenten die de caller al geautoriseerd terugkreeg.
API
Antwoorden refereren citation IDs in tekst/structured claims. GET /v1/citations/{id} autoriseert opnieuw en levert alleen content die de caller nu mag lezen. Audit kan historische metadata bewaren terwijl gevoelige excerptretentie policy volgt.
Claimondersteuning
Generatie-output moet claims aan citations koppelen. Niet-ondersteunde feitelijke claims worden verwijderd, opnieuw gegenereerd of leiden tot een expliciete failure afhankelijk van profiel.