Bases de conocimiento

Una base de conocimiento reúne los documentos que un mismo público necesita: pólizas, manuales, normativas, preguntas frecuentes. Los agentes la consultan para responder con información verificada y citar la fuente.

En lugar de replicar los permisos de cada archivo, Sherlock propone una base por audiencia: «Clientes», «Equipo comercial», «Todos los empleados». Cada agente consulta solo las bases de su público. Así, el asistente para asegurados nunca ve el manual interno de suscripción, aunque los dos vivan en la misma carpeta de SharePoint.

Conocimiento lista las bases del workspace con sus documentos, su estado, sus fuentes («Solo subidos», «1 conectada») y los agentes que la usan. El estado de una base es uno de:

Estado	Qué significa
«Procesando»	Hay documentos leyéndose o indexándose.
«Con errores»	Algún documento no se pudo procesar.
«Pendiente de revisión»	Hay documentos esperando aprobación (ver Revisión humana).
«Sin documentos»	Todavía está vacía.
«Al día»	Todo procesado y disponible.

Dentro de una base hay cuatro pestañas: Documentos, Fuentes, Probar búsqueda y Configuración (esta última solo para Constructor y Administrador). El menú ⋯ tiene «Reindexar todo», «Configuración», «Copiar ID» y «Eliminar base».

Hace falta el rol Constructor o Administrador. En Conocimiento, hacé clic en «Nueva base»:

Campo	Qué poner
Nombre	Por ejemplo «Pólizas de auto y hogar».
Para quién es	El público: «Clientes», «Comercial», «RRHH», «Atención al cliente», «Soporte técnico»…
Descripción	Opcional. Qué contiene y para qué sirve.
Tipo de documentos	Cómo se dividen para buscarlos: General, Manual (póliza o normativa), Preguntas y respuestas o Tabla. Ver Tipos de documento.

Hacé clic en «Crear base». Después la llenás de tres formas: subiendo archivos, escribiendo un texto o conectando una fuente.

En «Opciones avanzadas» del mismo diálogo:

Opción	Predeterminado	Notas
Idioma de los documentos	Español	Mejora la búsqueda por palabras (plurales, acentos, palabras comunes). Opciones: Español, Inglés, Portugués, Multilingüe / otro. No se puede cambiar después.
Modelo de búsqueda	El recomendado para español e inglés	Ver abajo. No se puede cambiar después: para usar otro modelo, creá una base nueva.
Tamaño de cada parte	900 caracteres	Entre 200 y 4000. Más chico es más preciso; más grande da más contexto.
Solapamiento	120 caracteres	Entre 0 y 800, menor que el tamaño. Texto que se repite entre partes seguidas para no cortar ideas.

Sherlock incluye tres modelos de búsqueda locales, sin costo: con ellos, los documentos no salen de la instancia.

Modelo	Cuándo elegirlo
Español e inglés (recomendado)	La mejor opción para la mayoría de las bases.
Multilingüe liviano	Bases grandes o simples, cuando importa más la velocidad de procesamiento.
Multilingüe de alta calidad	Documentos en varios idiomas, cuando importa más la precisión. Es más lento de procesar.

Si un administrador habilitó modelos de búsqueda de un proveedor externo, también aparecen, marcados «Proveedor externo, cobra por uso»: cobran al procesar los documentos y en cada búsqueda.

En el Estudio del agente, pieza Conocimiento:

• Bases de conocimiento: marcá las bases que consulta. Cada una muestra sus documentos, fragmentos y audiencia.
• Modo de búsqueda:
  • Siempre (predeterminado): busca en cada mensaje. Recomendado para agentes de preguntas y respuestas: es más preciso y más rápido.
  • Cuando lo necesite: el modelo decide con una herramienta de búsqueda. Útil cuando el agente también usa otras herramientas. Requiere un modelo que admita herramientas.
  • Desactivado: el agente no consulta las bases asignadas.
• Responder solo con la documentación (activado): evita respuestas inventadas. Si la información no está en las bases, responde con el mensaje de «sin respuesta».
• Citar las fuentes (activado): agrega referencias [1], [2] con el documento y la página.
• Fragmentos por consulta (1 a 15, predeterminado 6): más fragmentos dan más contexto y más costo.
• Similitud mínima (0 a 0,9, predeterminado 0): descarta fragmentos poco relacionados. 0 es sin filtro.
• Mensaje cuando no hay respuesta: ver Instrucciones.

Las preguntas cortas de seguimiento («¿y para hogar?») se buscan teniendo en cuenta el mensaje anterior de la persona, para no perder el tema. Los detalles de la búsqueda están en Búsqueda.

La pestaña Configuración (Constructor y Administrador) tiene:

• General: nombre, público y descripción.
• Tipo de documentos: el tipo y, en «Avanzado», tamaño y solapamiento. Los cambios se aplican a lo que se suba o reprocese después; para aplicarlos a todo, usá «Reindexar» en «Aplicar a toda la base».
• Revisión humana: ver Revisión humana.
• Indexación (solo lectura): modelo de búsqueda, idioma, contenido indexado, fecha de creación e ID. «Para usar otro modelo, creá una base nueva.»
• Búsqueda externa: opcional, delega la búsqueda de esta base en un RAGFlow propio del cliente («Buscar con RAGFlow», con dirección, clave de API y datasets). Las protecciones, las citas y las trazas siguen en Sherlock.
• Eliminar base: borra sus documentos, fragmentos y fuentes. Los agentes que la usan dejan de consultarla.

• Las bases no se versionan con el agente: volver a una versión anterior del agente restaura su comportamiento, no los documentos.
• Los PDF escaneados necesitan OCR antes de subirlos.
• El idioma y el modelo de búsqueda se eligen al crear la base y no se cambian.