Subir un documento
En el Constructor, sección Agente, panel Base de conocimiento, haz clic en Añadir documento. Puedes subir:
(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.
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:
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:
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 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.
- Instrucción de consulta personalizada y umbral de similitud (rotulados Próximamente).