Base de conocimiento y mapa del negocio (ontología) del Cerebro

Abrir en

Ver como Markdown

Abrir en ChatGPT Abrir en Claude

Conversa Labs

Última actualización el 13 de oct de 2026

Visión general

El Cerebro de la Cuenta tiene dos piezas que trabajan juntas:

La base de conocimiento (corpus) son las fuentes que alimentan el Cerebro: documentos que subes, páginas que pegas por URL y el objetivo/meta que escribes sobre tu negocio. Cada fuente se procesa y se divide en fragmentos indexados (los "chunks"), que el Maestro consulta para responder con referencia al origen.
La estructura o mapa del negocio (ontología) es el resultado consultable de eso: un grafo de entidades (bandejas de entrada, equipos, agentes de IA, etiquetas, atributos, macros, canales) y de las relaciones entre ellas, armado a partir del corpus más los datos reales de tu cuenta. Es el "segundo cerebro" — el gemelo digital — que el Maestro usa para entender tu operación.

En resumen: tú alimentas la base de conocimiento y el Cerebro arma el mapa del negocio a partir de ella. Cuanto más rico el corpus, mejores las respuestas, los riesgos y los insights.

Requisitos previos

Cuenta con el Maestro y el Cerebro de la Cuenta habilitados (la función account_brain). Si no encuentras el área, habla con un administrador.
La lectura es para cualquier miembro de la cuenta: ver las fuentes y el mapa del negocio no exige permiso especial.
Agregar o eliminar fuentes es exclusivo de administradores — el servidor revalida el permiso y la interfaz oculta los controles de carga/eliminación para quien no es administrador.

Paso a paso

Alimentar la base de conocimiento

En la pestaña Base de conocimiento (corpus) tienes tres formas de "alimentar el Cerebro":

Subir un documento: arrastra el archivo al área de carga (o haz clic para elegirlo) y confirma. El archivo se guarda como adjunto y el Cerebro lo busca y extrae su contenido, convirtiéndolo en fragmentos indexados.
Pegar una URL: pega la dirección de una página y confirma. El Cerebro busca la página y extrae el contenido, igual que un documento.
Escribir el objetivo/meta de la cuenta: describe, en texto, el objetivo de tu negocio (también hay un botón de dictado por voz para completarlo hablando). El objetivo es una fuente fija: al guardarlo de nuevo, reemplaza el anterior en lugar de duplicar.

Gestionar fuentes

La lista muestra cada fuente con su conteo de fragmentos indexados (chunks), más un resumen arriba con el total de fuentes y fragmentos — la prueba de que el Cerebro fue alimentado.
Para eliminar una fuente, usa el ícono de eliminación (solo administradores) y confirma en el diálogo. Eliminar una fuente borra todos sus fragmentos del índice.

Ver el mapa del negocio (estructura/ontología)

Abre la pestaña de Estructura (ontología) para ver el mapa armado a partir del corpus y de los datos reales de la cuenta. Es un árbol: la cuenta, cuatro dominios (Entrada, Atención, Automatización y Contexto), las familias de cada dominio (bandejas de entrada, canales, bots, equipos, macros, etiquetas, ámbitos y atributos personalizados) y, dentro de ellas, las entidades.
La barra sobre el mapa trae los indicadores de la cuenta (entidades, relaciones, bandejas con bot, sin vínculo), la búsqueda y los controles. Haz clic en un indicador para resaltar en el mapa exactamente las entidades que explican ese número; Quitar resaltado o Esc vuelve a lo normal. La búsqueda lista los resultados por familia y lleva hasta la entidad elegida.
Los chips justo debajo son la leyenda: cada familia y cada tipo de relación. Al hacer clic en un chip se oculta o muestra esa familia o ese tipo; con doble clic en una familia queda solo ella.
Cada dominio muestra la cobertura real (por ejemplo, "13 de 24 bandejas con bot") y cada familia muestra cómo se distribuye (bandejas por canal, atributos por ámbito, cuántas tienen vínculo). Las cuentas con muchas entidades se abren en la visión general; haz clic en una familia para abrirla o usa Expandir todo. Las familias grandes muestran una parte cada vez, con Mostrar las demás.
Las líneas con flecha son las relaciones que el Cerebro mapeó (por ejemplo, "usa bot" o "asigna al equipo"). Entre familias cerradas aparecen agrupadas, con el tipo y la cantidad; al seleccionar una entidad, aparecen una a una. Las líneas finas sin flecha solo muestran a qué pertenece cada parte.
Haz clic en una entidad para abrir el panel de detalle con su camino hasta la cuenta, lo que el Cerebro sabe de ella (canal, proveedor, tipo, clave, ámbito), sus relaciones por tipo y, cuando existan, las fuentes. Abrir en el producto lleva a la pantalla donde se configura. Una entidad sin vínculo mapeado sigue en el mapa y el panel explica el motivo: o ese tipo de vínculo aún no se ha mapeado en esta cuenta (usa Mapear ahora), o ya existe y nada apunta a ella.
En Visualización eliges la disposición (Jerarquía o Neural), la densidad de las tarjetas (compacto, cómodo o detallado), cómo se dibujan las relaciones (haces o hilos, etiquetas, animación, tipos visibles) y si el foco aísla la vecindad de la selección. Las elecciones se guardan en este navegador; Restaurar valores las deshace todas.
La barra, la leyenda, el minimapa y el zoom pueden estar visibles, compactos, minimizados u ocultos. El modo limpio (tecla H) deja solo el mapa, con Mostrar controles siempre a la vista; la pantalla completa usa toda la ventana y Esc vuelve.

Configuración y opciones

Proveedor de embeddings (administradores): en la parte superior de la base de conocimiento eliges qué proveedor indexa y busca el conocimiento de la cuenta (predeterminado de la instalación, OpenAI o Cohere). Al cambiarlo, la plataforma re-indexa todas las fuentes automáticamente — espera a que termine el procesamiento antes de evaluar la calidad.
Tres modos de entrada: documento, URL u objetivo en texto — elige el que tenga sentido para cada contenido.
Objetivo como fuente fija: volver a guardar el objetivo reindexa (reemplaza); nunca acumula duplicados.
Conteo de fragmentos por fuente: indica cuánto contenido se extrajo e indexó de verdad.
Comportamiento a prueba de fallos (cache-first): el mapa del negocio se guarda en caché, así que la pantalla se renderiza aunque el motor esté momentáneamente fuera de servicio — en vez de mostrar un error.
Estado vacío que enseña: cuando todavía no hay conocimiento, la pantalla invita a alimentar la base en lugar de mostrar una pantalla muerta.

Casos de uso

Centralizar manuales, políticas, catálogos y FAQs para que el Maestro responda de forma consistente.
Registrar el objetivo del negocio para orientar las propuestas y acciones del copiloto.
Visualizar cómo se conectan bandejas de entrada, equipos, agentes y atributos — útil para revisar la organización de la cuenta.
Construir una base sólida que mejora el análisis de riesgo y los insights generados por departamento.

Consejos, límites y buenas prácticas

Cuanto más rico y limpio el corpus, mejor: documentos actualizados y bien escritos generan riesgos, insights y análisis más precisos.
Un objetivo claro mejora las propuestas del copiloto y de los departamentos.
Evita subir contenido desactualizado — la información vieja genera sugerencias viejas.
El mapa del negocio se puebla con el tiempo: alimenta fuentes y espera el procesamiento.
La indexación usa embeddings con conmutación automática de proveedor (p. ej. OpenAI → Cohere). Conecta una clave de Cohere en Integraciones para que la base siga indexando aunque el proveedor primario se quede sin créditos.

Solución de problemas

Fuente con 0 fragmentos: la extracción no encontró contenido — el formato puede no estar soportado, el archivo puede estar vacío/protegido o la URL puede estar inaccesible. Prueba otro formato o vuelve a subir.
Mapa del negocio (ontología) vacío: el mapa NO proviene de las fuentes que subes — se construye a partir de la estructura real de tu cuenta (bandejas, equipos, bots, etiquetas, atributos, macros). Se genera cuando se crea la cuenta y se actualiza una vez al día. En una cuenta creada justo después de la actualización diaria, el mapa queda vacío hasta la siguiente. Usa Mapear ahora, en la propia pantalla vacía, para construirlo al instante — tarda unos segundos.
"No se pudo mapear esta cuenta": Maestro no pudo leer la estructura de tu cuenta. Casi siempre es el token de acceso de la cuenta que usa Maestro; pide a un administrador de la instalación que lo revise e inténtalo de nuevo.
Acción bloqueada: subir o eliminar fuentes es solo para administradores. Si los controles no aparecen (o la acción es rechazada), confirma tu perfil con un administrador.
"Error al indexar" / embeddings no disponibles: ningún proveedor de embeddings tiene una clave válida con créditos. Verifica los créditos del proveedor primario (p. ej. OpenAI) o conecta una clave de Cohere en Integraciones y vuelve a intentarlo.
Modelo de embedding incompatible al guardar un Robot: cada instalación almacena vectores con un ancho fijo. Elige un modelo con la misma dimensión que muestra la pantalla — en una instalación de 1536, usa text-embedding-3-small en vez de text-embedding-3-large (3072). Después de cambiar un modelo ya usado, vuelve a indexar la base para no mezclar vectores antiguos y nuevos.