40 lines
1.7 KiB
Markdown
40 lines
1.7 KiB
Markdown
# 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.
|