> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ryvo.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Base de conocimiento

> Sube documentos o páginas web para que el agente responda con la información de tu negocio.

La base de conocimiento son los documentos que el agente consulta para contestar con datos de tu negocio: catálogo, precios, políticas, preguntas frecuentes, horarios. Los subes una vez, Ryvo los parte en fragmentos y el agente busca en ellos durante la conversación.

## Subir un documento

En el Constructor, sección **Agente**, panel **Base de conocimiento**, haz clic en **Añadir documento**. Puedes subir:

<Frame caption="(1) Añadir documento. (2) Cuándo consultar: No consultar, Cuando haga falta o Siempre. Abajo, los documentos del agente y los fragmentos por consulta.">
  <img src="https://mintcdn.com/ryvo-3dab4d1a/9EEXAZ5i3XN2oDZq/images/portal/kb-panel.png?fit=max&auto=format&n=9EEXAZ5i3XN2oDZq&q=85&s=db8ad3ab9d64ca9dbad54fd9e75333bc" alt="Panel Base de conocimiento" width="397" height="620" data-path="images/portal/kb-panel.png" />
</Frame>

| Fuente             | Detalle                                                                                                             |
| ------------------ | ------------------------------------------------------------------------------------------------------------------- |
| **PDF**            | Con texto seleccionable. Un PDF escaneado (sólo imagen) sube vacío y se rechaza.                                    |
| **Word** (`.docx`) |                                                                                                                     |
| **HTML**           | Archivo `.html` o `.htm`.                                                                                           |
| **Texto**          | `.txt` o `.md`.                                                                                                     |
| **Página web**     | Pegas una URL pública; Ryvo la descarga y extrae el texto. Volver a subir la misma URL sin cambios no duplica nada. |

El archivo puede pesar hasta **20 MB**. La ingesta es inmediata: cuando el modal cierra, el documento ya está listo y asignado al agente.

### Cuánto cabe

La cuota se mide sobre el **texto extraído** (no sobre el peso del archivo), sumando todos los documentos de tu cuenta:

| Plan         | Cuota    |
| ------------ | -------- |
| Pago por uso | 5 MB     |
| Starter      | 10 MB    |
| Pro          | 50 MB    |
| Scale        | 200 MB   |
| Enterprise   | Sin tope |

Cinco megabytes de texto son varios miles de páginas; la cuota casi nunca es el problema. Si la excedes, la subida se rechaza con `limit_exceeded`.

## Cuándo consulta el agente

Debajo de la lista de documentos eliges el modo:

| Modo                  | Comportamiento                                                                                                                                         |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **No consultar**      | Los documentos existen, pero el agente no los usa. Responde sólo con su prompt.                                                                        |
| **Cuando haga falta** | El agente recibe la tool `search_kb` y decide cuándo buscar. Es el modo recomendado: no agrega latencia a los turnos que no la necesitan.              |
| **Siempre**           | En cada turno se buscan fragmentos relevantes y se inyectan antes de responder. Más consistente, pero el agente tarda un poco más en empezar a hablar. |

Un agente sin documentos marcados se comporta como «No consultar», aunque el modo diga otra cosa.

### Fragmentos por consulta

En **Ajustes avanzados** eliges cuántos fragmentos recibe el agente en cada búsqueda (1 a 4). Más fragmentos dan más contexto y más latencia. Tu plan acota el máximo (3 en Pago por uso, 5 en Starter, 8 en Pro, 12 en Scale) y el tamaño de cada uno.

## Cómo funciona por dentro

* Cada documento se parte en fragmentos de unos **1 600 caracteres** (alrededor de 430 tokens) con un solape de 200 para no cortar ideas a la mitad. Los cortes caen en frontera de palabra.
* La búsqueda es **híbrida**: por significado (embeddings) y por palabras clave, combinadas. Así encuentra tanto «¿cuánto cuesta la instalación?» como un SKU exacto.
* La búsqueda tiene un tope de 2.5 segundos. Si no responde a tiempo, el agente sigue sin fragmentos en lugar de quedarse callado.
* Los documentos son de tu cuenta: ningún otro cliente puede consultarlos.

## Escribir documentos que funcionan

* Una idea por párrafo, con el dato completo en el mismo párrafo («La instalación cuesta \$1,200 e incluye…»). El fragmento que llega al agente tiene que entenderse solo.
* Encabezados claros. El nombre del documento (`source`) viaja con cada fragmento.
* Evita tablas anchas en PDF: el texto se extrae en un orden impredecible. Conviértelas a listas.
* Si un dato cambia seguido (precios, disponibilidad), mejor una [tool](/guias/agentes/tools) que un documento.

## Lo que todavía no está

* Borrar un documento desde la pantalla. Puedes desmarcarlo del agente; para eliminarlo escríbenos a [soporte@ryvo.so](mailto:soporte@ryvo.so).
* Instrucción de consulta personalizada y umbral de similitud (rotulados **Próximamente**).
