Recuperação e Ajuste de RAG
Quando um comando ou chat usa um Space, o Rephlo não insere cegamente todos os documentos no prompt. Em vez disso, ele recupera as passagens mais relevantes para sua solicitação e injeta apenas essas — uma técnica chamada Retrieval-Augmented Generation (RAG). As configurações de RAG Retrieval permitem ajustar o quão agressiva ou generosa é essa recuperação.
Você encontrará essa seção perto do final de Settings → General.
Por que ajustar a recuperação?
A recuperação é um equilíbrio delicado:
- Rigor demais, e o Rephlo pode deixar de fora contexto útil, gerando respostas mais rasas.
- Leniência demais, e ele traz texto marginalmente relacionado, desperdiçando tokens e às vezes adicionando ruído.
Os padrões funcionam bem para a maioria das pessoas. O ajuste ajuda quando você tem um Space incomum — muito grande, muito técnico, ou cheio de conteúdo quase duplicado — e quer inclinar o equilíbrio.
Basic vs. Advanced
Existem dois modos. A maioria dos usuários só precisa do Basic.
Modo Basic (padrão)
Escolha um único perfil de rigor e o Rephlo aplica um conjunto sensato de valores para você:
| Perfil | Comportamento |
|---|---|
| Very Lenient | Recupera amplamente — favorece incluir mais contexto. |
| Lenient | Recuperação levemente relaxada. |
| Balanced | O padrão — um bom meio-termo para a maioria dos Spaces. |
| Strict | Mais rigoroso — apenas passagens claramente relevantes. |
| Strictest | Mais seletivo — apenas as correspondências de maior confiança. |
Basta clicar em um perfil; a alteração é salva automaticamente.
Modo Advanced
Ative Advanced para editar diretamente os parâmetros subjacentes. Ao ativar, os campos são pré-preenchidos a partir do seu perfil atual, então você tem um ponto de partida sensato. Controles disponíveis:
- Similarity floor — a pontuação mínima de relevância que uma passagem deve atingir para ser considerada.
- Selected-ratio cutoff — quanto do conjunto de candidatos manter.
- High-confidence threshold — o limiar para tratar uma correspondência como claramente relevante.
- Minimum chunks — um piso que impede a recuperação de retornar pouco demais.
- Minimum Space size (tokens) — o corte abaixo do qual um Space é pequeno o suficiente para ser enviado por completo em vez de recuperado (padrão 4.000). Esta é a linha divisória que o Smart Search usa: nesse valor ou abaixo dele, o Rephlo envia o Space inteiro; acima dele, o Rephlo recupera apenas as partes mais relevantes. Aumente para continuar escaneando tudo em Spaces maiores.
- Command context budget (tokens) — quantos tokens de contexto recuperado um comando pode usar. Padrão 4.000. Aumentado de 2.500 na v1.4.0, então os comandos agora veem mais dos seus documentos por padrão — o mesmo orçamento do chat.
- Chat context budget (tokens) — quantos tokens de contexto recuperado um chat pode usar. Padrão 4.000.
- Large-Space command guard (tokens) — padrão 10.000. Acima desse tamanho, o Rephlo pede que você refine seu comando antes de enviar um Space inteiro.
- Inject-All Ceiling (tokens) — padrão 50.000. Limita quanto um envio de fallback do Space completo pode injetar, independentemente do tamanho real do Space.
Os orçamentos de tokens são automaticamente limitados a valores seguros e ao que seu provedor consegue realmente processar, então você não pode definir um valor que quebraria uma solicitação.
Salvando e redefinindo
- Auto-save — cada alteração que você faz é salva imediatamente, assim como o restante das Settings. Não há um botão Save separado.
- Reset to Defaults — restaura os padrões de fábrica: modo Basic com o perfil Balanced.
Se o ajuste de recuperação alguma vez não estiver disponível na sua máquina, o Rephlo silenciosamente recorre aos seus padrões internos — seus Spaces continuam funcionando.
Como isso se encaixa com os modos de dados
A recuperação RAG se aplica a todo Space, independentemente do seu modo de dados — ela sempre recupera a partir dos chunks brutos do Space. Um Space 🗜️ Compact acima do limiar de Minimum Space size ainda recebe as passagens relevantes recuperadas em uma solicitação normal, não o resumo completo gerado por IA. O modo de dados só muda o que é enviado no fallback — um Space no ou abaixo do Minimum Space size, ou sem uma correspondência confiante: um Space 🔍 Smart Search envia o texto bruto completo de cada arquivo, gratuitamente, enquanto um Space 🗜️ Compact envia o resumo gerado por IA de cada arquivo, o que custa créditos para ser criado. Para o panorama completo, veja Modos de Dados e Compactação.