This repository was archived by the owner on Jul 10, 2026. It is now read-only.
Sprint 2: reranking cross-encoder no RAG (TKT-020-A) + verificação do não-bug TKT-020-B - #110
Merged
Merged
Conversation
Adiciona o 2o estagio de qualidade ao RAG: apos a busca vetorial, o rag.rs chama o servico `reranker` (:8003, ja no compose) para reordenar os candidatos por relevancia do cross-encoder e devolve os melhores top_k. - over-fetch: busca top_k*4 (cap 50) candidatos no Qdrant quando RERANKER_URL esta setado, deixando o cross-encoder escolher os melhores - degradacao graciosa: sem RERANKER_URL, token ausente, erro HTTP ou nº de scores != chunks -> mantem a ordem vetorial (no-op seguro) - reorder_by_scores extraido como funcao pura + testado (2 testes) TKT-020-B (duplo-prefixo de embedding): VERIFICADO que NAO era bug — o servico de embedding embeda os texts as-is; a query usa "search_query:" (rag.rs) e o documento "search_document:" (document-processor), que e a convencao correta do nomic-embed-v2. O apontamento da auditoria estava desatualizado; rag.rs:21 fica como esta. Verificacao local: cargo build OK; clippy -D warnings (incl tests) limpo; cargo test reorder_by_scores 2/2. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AcsaeS7c9zJ4vkNtxqBcnc
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Sprint 2 — Qualidade do RAG (parte 1)
TKT-020-A — Reranking (cross-encoder)
2º estágio de qualidade: depois da busca vetorial,
rag.rschama o serviçoreranker(:8003, já no compose desde o Sprint 1) para reordenar os candidatos por relevância e devolver os melhorestop_k.top_k*4(cap 50) candidatos no Qdrant quandoRERANKER_URLestá setado, deixando o cross-encoder escolherRERANKER_URL, token ausente, erro HTTP ou nº de scores ≠ chunks → mantém a ordem vetorial (no-op seguro) — comportamento e testes existentes inalteradosreorder_by_scoresextraído como função pura + testadoTKT-020-B — "duplo-prefixo de embedding": não era bug ✅
Verificado contra o código real: o serviço de embedding embeda os
textsas-is (sem adicionar prefixo). A query usasearch_query:(rag.rs) e o documentosearch_document:(document-processor) — exatamente a convenção donomic-embed-v2. O apontamento da auditoria estava desatualizado;rag.rs:21permanece como está (mudá-lo quebraria a recuperação).Verificação local
cargo build -p api✓cargo clippy -p api --tests -- -D warnings✓cargo test reorder_by_scores✓ 2/2🤖 Generated with Claude Code
Generated by Claude Code