zhuyongxin
ac1f831903
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.
20 lines
1.2 KiB
Markdown
20 lines
1.2 KiB
Markdown
# 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`
|