Skip to content

Source map

Source map 记录可用于 support、qualify、challenge 或 contextualize claims 的材料。

Source ref

Field目的
source_idStable source id。
source_kinddocumentweb_pageknowledge_itemtool_resulthuman_inputartifacttracedatasetpolicypeer_recordexternal_record
uri / refLocation 或 owner-specific reference。
selectorText quote、text position、JSON pointer、line range、fragment、timestamp、bounding box 或 custom selector。
snippet_ref / snippet可选 excerpt 或安全 redacted excerpt。
retrievalQuery、rank、score、index、timestamp、selected/omitted status 与 reranker metadata。
freshnessObserved time、version、stale warning、expiry 或 last checked time。
trustAuthority、reviewer、signature、source tier 或 trust rationale。
privacyClassification、redaction state、access、license 与 retention facts。

Source maps SHOULD 记录 selected sources 和重要 omitted sources。Omissions 解释 source 为什么被 rejected、unavailable、stale、duplicate、unsafe、contradicted 或 out of scope。

Selector guidance

Selectors SHOULD 跨展示格式保持稳定。优先使用 owner ids、version ids、hashes、JSON pointers、line ranges、text positions、timestamps 或 Web Annotation-style selectors,少依赖脆弱的 rendered coordinates。

Omission record

Omission SHOULD 包含 source_idreasonobserved_at 与可选 decision_ref。常见 reasons 包括 duplicatelow_relevancestaleunsafeprivatelicense_restrictedcontradictedunavailableout_of_scope

Draft standard for portable agent evidence, provenance, review, and replay.