Base de conocimiento
La base de conocimiento reúne lo que tus agentes deben saber: procedimientos, FAQ, condiciones, fichas de producto, documentos de referencia. Pertenece a tu organización; un agente la consulta en el momento en que la necesita, mediante una herramienta, en lugar de llevarlo todo en su misión.
Lo que contiene
Tres tipos de entradas:
| Tipo | Contenido |
|---|---|
| Ficha | Un texto Markdown, escrito directamente en el panel de administración |
| Documento | Un archivo subido, cuyo texto se extrae automáticamente para los agentes |
| Carpeta | Un clasificador para organizar fichas y documentos |
Formatos de documento aceptados: PDF, Word (.doc, .docx), Excel (.xls, .xlsx), PowerPoint (.ppt, .pptx), texto, Markdown, HTML, CSV e imágenes — hasta 50 MB por archivo.
La extracción lee el texto de los formatos ofimáticos y de los PDF. Para una imagen o un PDF escaneado (casi sin texto), pasa por el modelo multimodal (visión) de tu organización. Una extracción fallida puede relanzarse desde el panel de administración.
Toda escritura en la base queda registrada. Modificarla requiere acceso a la sección Conocimiento e indexación; la lectura está abierta a los miembros de la organización.
Lo que hacen con ella tus agentes
Dos herramientas, que se adjuntan a un agente:
knowledge.search— búsqueda por palabras clave, ponderada (etiquetas, luego nombre, descripción, contenido). Devuelve la entrada más pertinente.knowledge.semantic_search— búsqueda semántica (por el sentido, no por las palabras exactas). Devuelve extractos con su fuente y su puntuación.
Los resultados se presentan al agente como material de origen: responde en el idioma del usuario y no debe afirmar más allá de lo que dice la fuente.
Búsqueda semántica
Para la búsqueda semántica, las fichas y el texto extraído de los documentos se dividen e indexan en una base vectorial (Qdrant). Los embeddings los calcula el modelo bge-m3, servido por Ollama dentro de nuestra infraestructura: el texto de tu base no se envía a un proveedor de embeddings externo.
La sincronización es automática: una ficha creada o modificada se reindexa, una entrada eliminada se retira del índice y una indexación fallida se reintenta. La búsqueda semántica depende de su activación en la instancia; en su defecto, la herramienta orienta al agente hacia knowledge.search.
Alcance por modelo
Por defecto, un modelo busca en toda la base de su organización. Puedes restringir lo que ve, desde la pestaña Base de conocimiento del modelo:
- marcar una carpeta da acceso a todo su contenido, incluido lo que se añada más adelante;
- marcar una ficha o un documento solo da acceso a ese elemento.
El mismo alcance se aplica a las dos herramientas de búsqueda. Es una herramienta de pertinencia (un asistente de RR. HH. no tiene por qué leer la FAQ comercial); el aislamiento de seguridad, por su parte, es el de la organización: la base de una organización nunca es legible por otra.
Compartir un documento mediante enlace
Una ficha o un documento puede publicarse mediante un enlace (/shared/…), para un socio o un cliente que no tiene cuenta en betool. Las carpetas no se comparten.
- Contraseña opcional — se pide también para descargar el archivo.
- Caducidad opcional, de 1 día a 5 años; sin caducidad, el enlace vive hasta su revocación.
- Revocación en cualquier momento; volver a publicar crea un nuevo enlace y revoca el anterior; eliminar la entrada revoca su enlace. Un enlace revocado, caducado o desconocido devuelve la misma página de «no encontrado».
- Visualización: un PDF o una imagen se muestra en la página; un documento Markdown se muestra con formato; una página HTML se muestra en un marco aislado (sin scripts ni recursos remotos). Los demás formatos se descargan, mostrando el texto extraído cuando existe.
- Las páginas compartidas no son indexables por los motores de búsqueda, y se lleva la cuenta del número de consultas.
Actualizar sin cambiar el enlace
Sustituir el archivo de un documento conserva su identificador y, por tanto, el enlace ya distribuido: sirve de inmediato la nueva versión. El texto que leen los agentes se vuelve a extraer del nuevo archivo, de modo que lo que leen tus agentes y lo que ve tu socio no pueden divergir.
Actualizar mediante propuesta
Un agente (o una aplicación conectada por MCP) puede proponer hacer evolucionar la base, con validación humana:
knowledge_update— crear o actualizar una ficha de texto (sustitución completa, de una sección o añadido al final).knowledge_document_replace— sustituir el archivo de un documento, en su lugar, conservando el enlace público.
Nada se aplica sin un Aceptar explícito.