feat: add rag post-reindex acceptance

2026-07-05 12:29:24 +08:00
parent c7e2fc2ee2
commit 674dd27a48
8 changed files with 528 additions and 0 deletions
@@ -0,0 +1,26 @@
+## Why
+
+`title` and `breadcrumb` now participate in embedding text, but that improvement only affects newly indexed vectors. We need a repeatable acceptance path that tells us how to reindex the knowledge base and verify live retrieval after the embedding input changes.
+
+## What Changes
+
+- Add a live RAG retrieval acceptance flow for breadcrumb-aware embedding changes.
+- Document the reindex prerequisite so reviewers understand old vectors do not change automatically.
+- Provide a small repeatable script for calling live retrieval cases and writing JSON/Markdown reports.
+- Add interview-facing acceptance notes that explain what was verified and what remains manual or environment-dependent.
+
+## Capabilities
+
+### New Capabilities
+
+None.
+
+### Modified Capabilities
+
+- `rag-retrieval-evaluation`: Extend retrieval evaluation with an opt-in live acceptance flow for post-reindex verification.
+
+## Impact
+
+- Adds scripts and documentation under the retrieval evaluation/interview areas.
+- Does not change the Agent runtime path, `lookup_knowledge`, VectorStore search logic, or Milvus schema.
+- Live verification depends on a running Spring Boot service and a reindexed Milvus/Zilliz collection.