Concepto clave: Spaces
Knowledge Spaces (o simplemente Spaces) son los almacenes de contexto basados en documentos de Rephlo. Te permiten "enseñarle" a la IA sobre tus proyectos, documentos o guías de estilo específicos. Cuando un Space está activo, Rephlo recupera información de él para generar respuestas basadas en tus archivos.
¿Qué es un Space?
Piensa en un Space como una carpeta de materiales de referencia con un presupuesto de tokens.
- Sin un Space: la IA depende solo de su entrenamiento general (por ejemplo, "Redacta un contrato").
- Con un Space: la IA usa tus archivos (por ejemplo, "Redacta un contrato usando los términos de mi PDF subido").
Cada Space puede llevar un pequeño toque de identidad visual:
- Icono emoji — un único emoji para reconocerlo rápidamente en la interfaz.
- Color (hex
#RRGGBB, por ejemplo#3B82F6) — se usa para personalizar el color de la tarjeta y las etiquetas del Space.
Tipos de datos admitidos
Añades archivos a un Space; Rephlo extrae y almacena su texto. Tipos de archivo admitidos y sus límites de tamaño por archivo:
| Tipo | Extensión | Tamaño máximo |
|---|---|---|
.pdf | 50 MB | |
| Word | .docx | 50 MB |
| Texto plano | .txt | 10 MB |
| Markdown | .md | 10 MB |
| CSV | .csv | 20 MB |
El texto extraído de cada archivo ingerido se almacena junto con su recuento de tokens en bruto (raw) y, cuando se compacta, un recuento de tokens compact.
Cómo funciona
- Ingesta (Ingestion) — Añades archivos. Rephlo extrae y almacena su contenido de texto.
- Inyección (Injection) — Cuando ejecutas un Command con el Space adjunto, Rephlo incorpora el contenido del Space al prompt enviado a la IA.
- Generación (Generation) — La IA lee ese contexto y responde basándose en tus documentos.
Recuperación local (RAG): Rephlo puede construir un índice local (local index) del contenido en bruto de tu Space para recuperar las secciones más relevantes en lugar de enviarlo todo. El índice local solo funciona con texto en bruto (raw) — por eso Smart Search (contenido en bruto) es el modo de datos predeterminado para los Spaces nuevos (ver más abajo).
Presupuesto de tokens
Los LLM tienen un límite de cuánto texto pueden leer a la vez (la ventana de contexto o context window). Cada Space controla su tamaño frente a un presupuesto de tokens:
- Presupuesto de tokens (Token budget) — por defecto 100.000 tokens; mínimo 1.000, máximo 1.000.000.
- Recuento de tokens en bruto (Raw token count) — total de tokens de todos los elementos que usan contenido en bruto (raw).
- Recuento de tokens compact (Compact token count) — total de tokens de todos los elementos que usan contenido compact (resumido).
Estos dos recuentos se controlan de forma independiente para que puedas ver cuánto cuesta un Space en cada modo. Cada archivo tiene sus propios recuentos de tokens raw y compact (resumido), y el Space los suma.
Modos de datos, recuperación por IA (RAG) y coste en tokens
Un Space puede entregar su contenido a la IA de varias formas. El modo que uses influye más en el coste en tokens que el tamaño en bruto del Space.
Modos de datos
Cada Space tiene un modo de datos predeterminado (los Commands pueden anularlo en cada ejecución):
- 🔍 Smart Search (predeterminado) — envía tu contenido en bruto y es gratis. Para un Space pequeño envía el texto completo; a medida que el Space crece, solo recupera las partes más relevantes.
- 🗜️ Compact — envía un resumen de cada archivo generado por IA en lugar de su texto completo — el texto en bruto original se conserva — usando muchos menos tokens a costa de algo de detalle. Generar esos resúmenes consume credit (después se reutilizan).
Rephlo puede recuperar los pasajes más relevantes de cualquier Space, ya sea Smart Search o Compact. El modo de datos solo decide qué se envía cuando la recuperación no aplica (ver más abajo).
Recuperación por IA (RAG)
Cuando ejecutas un comando o chateas con un Space, Rephlo usa RAG (retrieval-augmented generation, generación aumentada por recuperación). En lugar de enviar todo el Space, busca semánticamente en tus documentos y envía solo los pasajes que coinciden con tu solicitud. Esto ocurre en cualquier Space, sea cual sea su modo de datos — la recuperación se ejecuta en tu dispositivo, así que tus documentos nunca salen de tu equipo.
Ajustas el nivel de exigencia de la recuperación con un RAG profile en RAG Retrieval settings:
- El perfil define un umbral de coincidencia (match threshold) — la similitud que debe tener un pasaje con tu solicitud para incluirse — desde Very Lenient (acepta coincidencias más débiles) hasta Strictest (solo coincidencias de alta confianza), con Balanced como valor predeterminado.
- Si hay muy poco contenido relevante o haces una pregunta sobre todo el Space, Rephlo recurre a enviar el Space completo para que nunca pierdas contexto. Este es el único caso en el que el modo de datos importa: un Space en Smart Search envía el texto en bruto completo de cada archivo, mientras que un Space en Compact envía el resumen más corto de cada archivo.
Entonces, ¿cuál consume menos tokens?
Depende sobre todo de si la recuperación se aplica o no:
| Qué se envía a la IA | Cuándo | Coste relativo en tokens |
|---|---|---|
| Solo los pasajes que coinciden con tu solicitud (RAG) | La recuperación se aplica — el caso habitual | El más bajo |
| La versión Compact (resumida) de cada archivo del Space | Fallback, Space en modo Compact | Medio |
| El texto en bruto completo de cada archivo | Fallback, Space en modo Smart Search | El más alto |
Así que Smart Search no es automáticamente "más caro." Cuando la recuperación se aplica, cualquier Space — Smart Search o Compact — envía solo los pasajes que coinciden, normalmente menos tokens que enviar todos los archivos — y Smart Search no cuesta ningún credit. El modo de datos solo cambia el coste cuando Rephlo recurre a enviar el Space completo: en ese caso, Compact (cada archivo resumido) es más ligero que Smart Search (el texto en bruto completo de cada archivo), pero generar esos resúmenes gasta credit. El recuento exacto de tokens sigue dependiendo de tu consulta, los pasajes que coinciden y el tamaño del Space.
Cuándo cambiar de modo — y las protecciones de credit en torno a Compact — se explican en Data Modes & Compaction.
Spaces y Commands (muchos a muchos)
Un Space se relaciona con los Commands mediante una relación muchos a muchos (many-to-many):
- Un mismo Space puede vincularse a muchos Commands.
- Un mismo Command puede usar varios Spaces, y puede definir uno como su Default Space para una ejecución rápida.
Gestionar Spaces
- Active Space — solo un Space puede estar "Active" (activo) por interacción. Puedes cambiar el Space activo al instante desde el Dashboard o el Command Runner (por ejemplo, del contexto "Project A" a "Personal Finance").
- Archive (soft delete) — los Spaces se archivan en lugar de eliminarse directamente. Los Spaces archivados quedan excluidos de las vistas activas y de las asociaciones con comandos, y deben archivarse antes de poder eliminarse de forma permanente.
Para conocer el ciclo de vida completo (subida, indexación, edición, archivado), consulta Managing Spaces.
Siguiente concepto: Aprende sobre los Providers — los motores que impulsan la IA.