Conceito central: Spaces
Knowledge Spaces (ou apenas Spaces) são os repositórios de contexto baseados em documentos do Rephlo. Eles permitem que você "ensine" a IA sobre seus projetos, documentos ou guias de estilo específicos. Quando um Space está ativo, o Rephlo faz buscas nele para gerar respostas fundamentadas nos seus arquivos.
O que é um Space?
Pense em um Space como uma pasta de materiais de referência com um orçamento de tokens.
- Sem um Space: a IA depende apenas do seu treinamento geral (por exemplo, "Escreva um contrato").
- Com um Space: a IA usa seus arquivos (por exemplo, "Escreva um contrato usando os termos do meu PDF enviado").
Cada Space pode ter um pequeno toque de identidade visual:
- Ícone de emoji — um único emoji para reconhecimento rápido na interface.
- Cor (hex
#RRGGBB, por exemplo#3B82F6) — usada para personalizar o tema do cartão e das etiquetas do Space.
Tipos de dados suportados
Você adiciona arquivos a um Space; o Rephlo extrai e armazena o texto deles. Confira os tipos de arquivo suportados e seus limites de tamanho por arquivo:
| Tipo | Extensão | Tamanho máximo |
|---|---|---|
.pdf | 50 MB | |
| Word | .docx | 50 MB |
| Texto simples | .txt | 10 MB |
| Markdown | .md | 10 MB |
| CSV | .csv | 20 MB |
O texto extraído de cada arquivo ingerido é armazenado junto com sua contagem de tokens raw e (quando compactado) uma contagem de tokens Compact.
Como funciona
- Ingestão (Ingestion) — Você adiciona arquivos. O Rephlo extrai e armazena o conteúdo de texto deles.
- Injeção (Injection) — Quando você executa um Command com o Space anexado, o Rephlo compõe o conteúdo do Space no prompt enviado à IA.
- Geração (Generation) — A IA lê esse contexto e responde com base nos seus documentos.
Recuperação local (RAG): o Rephlo pode criar um índice local do conteúdo raw do seu Space para recuperar as seções mais relevantes em vez de enviar tudo. O índice local funciona apenas com texto raw — por isso o Smart Search (conteúdo raw) é o modo de dados padrão para novos Spaces (veja abaixo).
Orçamento de tokens
LLMs têm um limite de quanto texto conseguem ler de uma vez (a janela de contexto — context window). Cada Space acompanha seu tamanho em relação a um orçamento de tokens:
- Orçamento de tokens (Token budget) — padrão de 100.000 tokens; mínimo de 1.000, máximo de 1.000.000.
- Contagem de tokens raw (Raw token count) — total de tokens em todos os itens que usam conteúdo raw.
- Contagem de tokens Compact (Compact token count) — total de tokens em todos os itens que usam conteúdo Compact (resumido).
Essas duas contagens são acompanhadas de forma independente, para que você veja quanto um Space custa em cada modo. Cada arquivo tem suas próprias contagens de tokens raw e Compact (resumida), e o Space as soma.
Modos de dados, recuperação por IA (RAG) e custo em tokens
Um Space pode fornecer seu conteúdo à IA de algumas formas diferentes. Qual delas você usa importa mais para o custo em tokens do que o tamanho raw do Space.
Modos de dados
Cada Space tem um modo de dados padrão (Commands podem substituí-lo a cada execução):
- 🔍 Smart Search (padrão) — envia seu conteúdo raw e é gratuito. Para um Space pequeno, envia o texto completo; conforme o Space cresce, passa a recuperar apenas as partes mais relevantes.
- 🗜️ Compact — envia um resumo de cada arquivo gerado por IA em vez do texto completo — o texto raw original continua guardado — usando muito menos tokens ao custo de algum detalhe. Gerar esses resumos consome credits (depois eles são reutilizados).
O Rephlo consegue recuperar os trechos mais relevantes de qualquer Space — tanto em Smart Search quanto em Compact. O modo de dados só decide o que é enviado quando a recuperação não se aplica (veja abaixo).
Recuperação por IA (RAG)
Quando você executa um Command ou conversa com um Space, o Rephlo usa RAG (retrieval-augmented generation — geração aumentada por recuperação). Em vez de enviar o Space inteiro, ele faz uma busca semântica nos seus documentos e envia apenas os trechos que correspondem à sua solicitação. Isso acontece para qualquer Space, independentemente do modo de dados — a recuperação roda no seu dispositivo, então seus documentos nunca saem da sua máquina.
Você ajusta o quão rígida é a recuperação com um RAG profile em RAG Retrieval settings:
- O profile define um match threshold (limiar de correspondência) — o quão semelhante um trecho precisa ser da sua solicitação para ser incluído — de Very Lenient (aceita correspondências mais fracas) até Strictest (apenas correspondências de alta confiança), com Balanced como padrão.
- Se pouco conteúdo for relevante ou você fizer uma pergunta sobre o Space inteiro, o Rephlo recorre a enviar o Space inteiro para que você nunca perca o contexto. Esse fallback é o único ponto em que o modo de dados importa: um Space em Smart Search envia o texto raw completo de cada arquivo, enquanto um Space em Compact envia o resumo mais curto de cada arquivo.
Então, qual modo custa menos tokens?
Isso depende principalmente de a recuperação se aplicar ou não:
| O que é enviado à IA | Quando | Custo relativo em tokens |
|---|---|---|
| Somente os trechos que correspondem à sua solicitação (RAG) | A recuperação se aplica — o caso mais comum | Mais baixo |
| A versão Compact (resumida) de cada arquivo no Space | Fallback, Space em modo Compact | Médio |
| Todo o texto raw de cada arquivo | Fallback, Space em modo Smart Search | Mais alto |
Portanto, Smart Search não é automaticamente "mais caro." Quando a recuperação se aplica, qualquer Space — Smart Search ou Compact — envia apenas os trechos correspondentes, geralmente com menos tokens do que enviar cada arquivo — e o Smart Search não custa credits. O modo de dados só muda o custo quando o Rephlo recorre a enviar o Space inteiro: nesse caso, o Compact (cada arquivo resumido) é mais leve que o Smart Search (o texto raw completo de cada arquivo), mas gerar esses resumos consome credits. A contagem exata de tokens ainda depende da sua consulta, dos trechos que correspondem e do tamanho do Space.
Quando trocar de modo — e as proteções de credits em torno do Compact — são abordadas em Data Modes & Compaction.
Spaces e Commands (muitos-para-muitos)
Um Space se relaciona com Commands por meio de uma relação muitos-para-muitos (many-to-many):
- Um único Space pode ser vinculado a muitos Commands.
- Um único Command pode usar vários Spaces, e pode definir um deles como seu Default Space para execução rápida.
Gerenciando Spaces
- Active Space — apenas um Space fica "Active" por interação. Você pode trocar o Space ativo instantaneamente pelo Dashboard ou pelo Command Runner (por exemplo, do contexto "Project A" para "Personal Finance").
- Archive (soft delete) — os Spaces são arquivados em vez de excluídos diretamente. Spaces arquivados são excluídos das visualizações ativas e das associações de Commands, e precisam ser arquivados antes da exclusão permanente.
Para o ciclo de vida completo (envio, indexação, edição, arquivamento), veja Managing Spaces.
Próximo conceito: Saiba mais sobre Providers — os motores que alimentam a IA.