Knowledge base
Cómo darle al bot tu catálogo, FAQ y políticas.
Sin knowledge base el bot solo conoce lo que está en sus instrucciones. La knowledge base es donde guardas tu catálogo, FAQ, políticas — y el bot solo cita de ahí. No inventa precios, horarios, ni reglas.
Fuentes
Cada fuente tiene un kind:
| Kind | Cómo se crea | Re-fetch |
|---|---|---|
TEXT | Pegas el contenido en el dashboard. | Manual. |
URL | Pegas una URL — extraemos texto del HTML. | Botón "Re-indexar" o automático cada 7 días. |
FILE | Subes PDF / DOCX / Markdown. | Manual. |
Cómo funciona el retrieval
- Al guardar la fuente, Replai chunkea el contenido en pedazos de ~2.000 caracteres con overlap.
- Cada chunk se embebe con
text-embedding-3-smallde OpenAI (1.536 dims, multilingüe). - Los vectores se guardan en pgvector dentro de Postgres.
- Cuando llega un mensaje del cliente, embebemos la pregunta y buscamos los 4 chunks más cercanos por distancia coseno (
<=>). - Inyectamos los chunks como contexto en el system prompt antes de llamar al LLM.
BYOK aplica también acá: embeddings se hacen con tu propia clave de OpenAI. Si la sesión usa un proveedor distinto (Anthropic, DeepSeek, Gemini) para el bot, igual necesitas una clave OpenAI mínima para embeddings.
Buenas prácticas
- Estructura tu catálogo en bloques. Cada producto en su propio párrafo con SKU, descripción, precio. El chunker respeta saltos de párrafo.
- Pega FAQ en formato Q/A.
P: ¿Hacen delivery? R: Sí a Caracas y Miranda, $5. - Mantén las políticas separadas. Una fuente para devoluciones, otra para envíos, otra para horarios.
- Actualiza precios re-indexando la fuente. No edites in-place — el index queda stale.
Límite por plan
| Plan | Fuentes | Búsqueda |
|---|---|---|
| Starter | 10 | Embeddings |
| Growth | 25 | Embeddings + RAG full |
| Scale | 100 | Embeddings + RAG full |
| Enterprise | ilimitado | Embeddings + RAG full + custom retrieval |
Vía API
// Crear una fuente TEXT await replai.knowledge.createText( sessionId, 'Política de delivery', 'Hacemos delivery a Caracas y Miranda. Costo $5...', ); // Conectar una URL await replai.knowledge.createUrl( sessionId, 'Catálogo web', 'https://don-pepe.com/productos', ); // Re-indexar await replai.knowledge.refresh(sourceId);