Guías
Base de conocimiento
Sube documentos desde el panel de control y deja que la recuperación ocurra en el momento de la solicitud, en las claves que elijas.
Un stack puede responder desde tus propios documentos sin que tengas que construir un flujo de recuperación tú mismo. Sube archivos desde el panel de control; la recuperación ocurre en el momento de la solicitud de chat, sin parámetros adicionales por tu parte. Qué claves consultan la base es una opción de cada clave, elegida al crearla y modificable después.
La subida es una acción del panel de control, no una llamada API: no existe ningún endpoint público para añadir o eliminar documentos de la base de conocimiento. La recuperación, una vez que los documentos están indexados, funciona a través de los endpoints normales de chat.
Subida de archivos
Abrir la página de Conocimiento del stack
Desde el panel de control, abre tu stack y ve a su sección de base de conocimiento.
Sube tus archivos
.txt,.mdo.pdf(los PDFs deben tener texto incrustado: los PDFs escaneados o solo imágenes aún no son compatibles). El indexado se ejecuta en segundo plano después de la subida. Los archivos están limitados a 10MB cada uno, y la cantidad de archivos depende de tu plan. Consulta Precios.Prueba con una pregunta real
Haz una pregunta que solo el documento responda, a través de chat completions sin ningún mensaje
system: un mensajesystemque envíes omite tanto el prompt configurado como la base de conocimiento para esa solicitud.
Cómo funciona la recuperación
En el momento de la solicitud, Stac genera un embedding del último mensaje del usuario y busca en los documentos indexados del stack los fragmentos más cercanos, luego los inyecta en el prompt, antes de la conversación.
Quién decide si esto ocurre es la clave de API usada en la solicitud, en Claves de API → Configuración:
| Configuración | Cuándo se consulta la base |
|---|---|
| Activada | En cada pregunta, incluso si envías tu propio mensaje system |
| Desactivada | Nunca |
| Automático | Solo cuando la solicitud no trae mensaje system — es el estado de las claves creadas antes de que existiera esta opción |
Con la base activada y un mensaje system propio en la solicitud, ambos
conviven: tu instrucción sigue valiendo, y el fragmento recuperado se añade
después de ella. La base responde al sobre qué, no al cómo responder.
Actívala en automatizaciones y atención al cliente — n8n, por ejemplo, siempre
envía su propio mensaje system, así que una clave en "automático" nunca
consultaría la base. En herramientas de código (Claude Code, Cursor), es
preferible desactivarla: el fragmento recuperado cambia en cada pregunta y
anula la caché de contexto de la sesión.
Un saludo aislado y suelto no dispara la búsqueda, ni siquiera con la base
activada. El filtro reconoce hoy saludos en portugués y en inglés ("oi", "hi",
"hello"); cualquier otra cosa se trata como una pregunta real y sí consulta la
base. Consulta Conceptos básicos y
Chat completions para la
regla del system.
La recuperación es de esfuerzo máximo: si la búsqueda por similitud falla por cualquier razón, la solicitud de chat aún se procesa normalmente, solo que sin el contexto adicional. Una caída de la base de conocimiento nunca se convierte en una solicitud de chat fallida.
Para qué sirve
La base de conocimiento está pensada para fundamentar las respuestas del chat en tu propio material de referencia: políticas, documentación de producto, preguntas frecuentes. No es usada por los endpoints de extracción estructurada: esos trabajan desde el único archivo que envías en esa solicitud, a propósito, para que un campo nunca se llene desde un documento no relacionado.
Próximos pasos
- Conceptos básicos — cómo el prompt del sistema y la base de conocimiento se limitan a un stack.
- Chat completions — la regla del
mensaje
systemque rige cuándo se ejecuta la recuperación.