Files
zhuyongxin ac1f831903 feat(rag): chunk evidence identity, dedup, and search port
Preserve same-document multi-chunk evidence with evidenceKey identity,
per-document caps, retrieve-k/return-n split, and a dense KnowledgeSearchPort.
Archives Delivery 1 OpenSpec change as the foundation for hybrid retrieval.
2026-07-27 18:26:15 +08:00

1.2 KiB

rag-log-projections Delta (RAG portion)

MODIFIED Requirements

Requirement: RAG projection SHALL expose bounded document evidence only

The RAG adapter SHALL accept the logical query request, execute the existing knowledge tool through ToolBoundary, and project only RagToolResult fields. Context packs, retrieval traces, rerank traces, scores, hit reasons, domains, messages and full document bodies SHALL NOT appear in the Agent result. Projected evidence identity SHALL be chunk-scoped when chunk identity is available, allowing multiple excerpts from one logical source document.

Scenario: Project only bounded RAG evidence

  • WHEN the adapter receives a logical query and the knowledge backend returns a result
  • THEN it invokes through ToolBoundary and exposes only the bounded RagToolResult evidence fields, excluding retrieval internals and full document bodies

Scenario: Multiple chunks from one source may project

  • WHEN the backend returns multiple evidence blocks with the same source and different chunk-scoped identities
  • AND projection budgets allow them
  • THEN the projected evidence list SHALL include more than one item for that source
  • AND each item SHALL have a distinct document_id