Saltar a contenido

Base de conocimiento de Brun-E — Anexo B-12: sus límites y cómo sostenerla Nuevo

Tema: El material que Brun-E consulta durante las conversaciones — qué ya funciona, qué lo limita y cómo mantenerlo No confundir con: el Marco Teórico, que es material de lectura para las personas. Este documento trata lo que consume el asistente, no lo que lee un usuario. DRF base: 12-brun-e-sesiones-voz.md Idioma: ES Estado: Documento de debate — insumo para la conversación con el equipo técnico

Resumen en pocas palabras

El sistema ya tiene una sección donde un administrador carga textos de la metodología y los etiqueta por E-Mode. Brun-E los consulta durante las conversaciones. Lo que hoy no está resuelto es lo que la solicitud plantea: cómo cargar un cuerpo teórico grande y cómo sostenerlo actualizado en el tiempo.

Son dos preguntas distintas y conviene no mezclarlas: cargar —cómo entra el material al sistema la primera vez— y sostener —qué pasa cada vez que la teoría se corrige, se amplía o se reescribe, meses después, probablemente con otra persona a cargo—. La segunda es la difícil y la que suele quedar sin dueño.

Hay además una limitación en cómo Brun-E lee ese material que conviene entender antes de decidir nada, porque cambia por completo la forma correcta de cargarlo. Este documento la explica y propone tres caminos posibles.

Aclaración de alcance — "Marco Teórico" nombra dos cosas distintas

Conviene separarlas antes de seguir, porque se confunden con facilidad:

  1. La base de conocimiento que consulta Brun-E — las fichas etiquetadas por E-Mode que el asistente carga al iniciar cada conversación. Es de lo que trata este documento.
  2. El cuerpo teórico de Existential como contenido de producto — las slides, textos, capturas y gráficos del modelo (las tres dimensiones, los triángulos por E-Mode) que alimentan los reportes y las cápsulas de entrenamiento. Ese material vive en buena parte en la plataforma E-test / E-Talent, que es un sistema externo a e-training.

Ambos beben de la misma producción de contenido de Existential, pero se cargan, se muestran y se mantienen en lugares diferentes. Este anexo cubre el punto 1. El punto 2 se cruza con el rediseño del reporte de onboarding y con las cápsulas de entrenamiento, y requiere relevamiento sobre E-test antes de poder estimarse.

Cómo funciona hoy

Existe una sección de administración —Brun-E → Marco teórico— donde se puede:

  1. Crear una entrada con título, descripción, contenido y una o más etiquetas.
  2. Las etiquetas disponibles son base (aplica a todos) y una por cada E-Mode (emode_1 a emode_9).
  3. Editar, buscar y eliminar entradas.

Cómo lo usa Brun-E. Al inicio de cada sesión hace dos consultas automáticas: una para cargar el contenido con etiqueta base y otra para cargar el contenido de la etiqueta del E-Mode de esa persona. Con eso arranca la conversación. Después puede hacer consultas adicionales si necesita algo puntual. El sistema le devuelve hasta cinco entradas por consulta.

Esto es importante y agrava lo que sigue: el marco teórico no es material de consulta ocasional, es el contexto con el que Brun-E encara toda la sesión.

Cuatro límites que conviene conocer antes de cargar nada

Este es el punto central del documento.

# Qué pasa hoy Por qué importa
L-1 De cada entrada, Brun-E recibe únicamente los primeros 300 caracteres del contenido — unas cuatro o cinco líneas. El resto no lo ve nunca. Si se carga un capítulo entero como una sola entrada, Brun-E lee la introducción y nada más. Peor aún: como la carga inicial son dos consultas de hasta cinco entradas cada una, todo el marco teórico con el que Brun-E arranca una sesión son unos 3.000 caracteres — dos carillas. Es el límite más importante de todos.
L-2 La búsqueda es literal: encuentra la palabra exacta que se escribió. Si el texto dice "angustia" y Brun-E busca "ansiedad", no encuentra nada. El material tiene que estar redactado con las palabras que efectivamente van a aparecer en una conversación real.
L-3 Cuando hay más de cinco entradas para una etiqueta, se devuelven las cinco más antiguas, no las más pertinentes. Lo primero que se cargue va a ganar siempre. Las entradas nuevas quedan tapadas a medida que el corpus crece.
L-4 La carga es copiar y pegar texto a mano. Subir un PDF o un Word no está disponible, aunque el sistema tenga previsto el caso. Cargar un cuerpo teórico extenso hoy es un trabajo manual largo.

Ninguno de los cuatro es un error: son decisiones razonables de una primera versión pensada para pocas entradas cortas. Dejan de serlo en el momento en que se quiere cargar un marco teórico completo.

El punto a debatir

Todo se reduce a una pregunta:

¿En qué unidades se carga la teoría?

Hoy, para que funcione, cada entrada tiene que ser corta y auto-contenida: una idea por entrada, expresada completa en unas pocas líneas, escrita con el vocabulario de una conversación real y no con el de un manual.

Eso no es una limitación técnica a sortear: es, en buena medida, la forma correcta de que un asistente conversacional use material teórico. La pregunta es si el equipo de contenido quiere escribir en ese formato o prefiere entregar el material como lo tiene y que el sistema se encargue de adaptarlo.

De esa respuesta salen los tres caminos.

Camino 1 — El material se escribe ya troceado

El equipo de Existential redacta el marco teórico como fichas breves y auto-contenidas, y las carga por la pantalla que ya existe.

Cómo se vería una ficha:

Título:       El miedo al vacío en el E-Mode 4
Etiquetas:    emode_4
Contenido:    Cuando una persona de E-Mode 4 dice que "no siente nada",
              rara vez está describiendo ausencia. Suele estar nombrando
              una saturación que no encuentra palabras. Conviene no
              apurar la interpretación y preguntar por lo concreto:
              qué pasó hoy, con quién, en qué momento del día.
Ventaja Se puede empezar hoy, sin desarrollo. Es el formato que Brun-E aprovecha mejor.
Desventaja Todo el trabajo recae en el equipo de contenido. Reescribir un marco teórico existente en fichas es una tarea considerable.
Requiere Ampliar el límite de 300 caracteres (L-1) y resolver el orden de resultados (L-3). Ambos son ajustes acotados.

Camino 2 — El material se sube tal cual y el sistema lo trocea

Se habilita la subida de archivos (PDF, Word, texto). El sistema los divide automáticamente en fragmentos, propone un título y unas etiquetas para cada uno, y muestra el resultado para que un administrador lo revise, corrija y confirme antes de publicarlo.
Ventaja El equipo de contenido entrega el material como lo tiene. Cargar un cuerpo teórico grande pasa a ser cuestión de horas.
Desventaja El troceado automático nunca es perfecto: siempre hace falta una revisión humana. Y arrastra los límites L-2 y L-3.
Requiere Desarrollo de la subida, el troceado y la pantalla de revisión.

Camino 3 — Búsqueda por significado

Se cambia la forma en que Brun-E encuentra el material: en lugar de buscar palabras exactas, busca por sentido. Preguntar por "ansiedad" trae lo que se escribió sobre "angustia". Resuelve L-2 y L-3 de raíz.
Ventaja Brun-E encuentra lo pertinente aunque el vocabulario no coincida. Es lo que sostiene un corpus grande sin degradarse.
Desventaja Es el camino más costoso y agrega un costo mensual por procesamiento. No tiene sentido con veinte fichas: se justifica a partir de un corpus considerable.
Requiere Reprocesar el material cada vez que cambia.

Comparación

Camino 1 Camino 2 Camino 3
Trabajo del equipo de contenido Alto Bajo Bajo
Desarrollo necesario Mínimo Medio Alto
Se puede empezar Ya Tras el desarrollo Tras el desarrollo
Aguanta un corpus grande Regular Regular Sí
Costo mensual adicional No No Sí

No son excluyentes ni simultáneos: son etapas. La recomendación del equipo técnico es empezar por el Camino 1 con los dos ajustes que necesita, cargar así las primeras fichas y ver cómo se comporta Brun-E con material real. Recién con esa evidencia se decide si hace falta el 2 o el 3. Construir el 3 antes de saber qué material hay es resolver un problema que todavía no existe.

Sostener la actualización

Esta es la mitad de la solicitud que suele quedar afuera. Cargar el material es un evento; mantenerlo es un proceso. Hoy no hay nada previsto para eso: quien tenga acceso de administrador edita, y el cambio impacta en la próxima conversación, sin registro de qué cambió ni posibilidad de volver atrás.

Cuatro cosas a definir:

Quién es el dueño del contenido. Hoy cualquier administrador de plataforma puede editar el marco teórico. ¿Debería existir un rol específico de editor de metodología, separado de quien administra usuarios y organizaciones?

Qué queda registrado. Hoy solo se guarda la última versión. Si una ficha se edita y Brun-E empieza a responder distinto, no hay forma de saber qué decía antes ni quién la cambió. Un historial de versiones con autor y fecha, y la posibilidad de volver a una versión anterior, es lo que hace reversible un error.

Si hay revisión antes de publicar. ¿Un cambio entra en vigencia apenas se guarda, o pasa por un estado de borrador que otra persona aprueba? Lo primero es ágil y riesgoso; lo segundo es lento y seguro. Depende de cuántas personas vayan a tocar el material.

Cómo se verifica que un cambio no empeora las conversaciones. Es el punto más incómodo y el que nadie suele resolver: hoy la única forma de saber si una ficha nueva mejora o arruina a Brun-E es conversar con él y notarlo. Vale al menos acordar una práctica —por ejemplo, que quien edita pruebe una sesión antes de dar por buena la modificación.

Preguntas para la conversación

# Pregunta
B-12.1 ⚠️ Parcialmente respondido en la reunión del 2026-07-30: hay mucho material en forma de slides, textos y capturas. Falta saber cuánto de eso corresponde a la base de conocimiento de Brun-E y cuánto es contenido de producto para reportes y cápsulas (ver aclaración de alcance arriba).
B-12.2 ⚠️ Orientado en la reunión del 2026-07-30: Existential quiere poder editar el contenido desde la plataforma, no que quede estático. Eso empuja hacia el Camino 2 y hace relevante el apartado de sostenimiento. Falta confirmar si están dispuestos a redactar en formato de fichas breves.
B-12.3 ¿Con qué frecuencia se espera que el marco teórico cambie? ¿Una vez al año o todos los meses? De esto depende cuánto invertir en versionado y revisión.
B-12.4 ¿Quién es el dueño del contenido? ¿Hace falta un rol específico, separado del administrador general? Puede esperar si por ahora edita una sola persona.
B-12.5 ¿Se necesita historial de versiones y poder volver atrás? Conservar el historial sin poder restaurar es bastante más simple y ya evita perder contenido.
B-12.6 ¿Un cambio se publica al instante o pasa por aprobación de otra persona? Un circuito con estados agrega trabajo al circuito de edición.
B-12.7 ¿El marco teórico es solo en español, o también en inglés y portugués? Brun-E conversa en los tres idiomas. Multiplica el trabajo de contenido, no el de desarrollo.
B-12.8 ¿Las nueve etiquetas por E-Mode más base alcanzan, o hace falta clasificar también por tema (vínculos, trabajo, propósito)?

Lo que ya existe hoy

Componente Estado
Sección de administración del marco teórico (crear, editar, buscar, eliminar) Existe
Etiquetado por E-Mode y etiqueta base Existe
Carga automática del marco teórico al inicio de cada sesión (base + E-Mode de la persona) Existe
Consultas adicionales durante la conversación Existe
Brun-E accede al contenido completo de una ficha Nuevo — Solo los primeros 300 caracteres (L-1)
Búsqueda por significado Nuevo — Solo coincidencia literal (L-2)
Priorización por pertinencia Nuevo — Devuelve las más antiguas (L-3)
Subida de archivos (PDF, Word) Nuevo — Previsto en el diseño, no construido (L-4)
Historial de versiones y vuelta atrás Nuevo
Rol específico de editor de metodología Nuevo
Aprobación antes de publicar Nuevo
Marco teórico en más de un idioma Nuevo — No contemplado

Composición del trabajo

Los tres caminos son etapas, no alternativas a elegir de una vez. Se separan para poder decidir hasta dónde llegar.

Etapa Qué incluye Tamaño relativo
Ajustes mínimos (recomendado, cualquiera sea el camino) Que Brun-E acceda al contenido completo de la ficha y no a un recorte, y que los resultados se prioricen por pertinencia y no por antigüedad (L-1 y L-3). El más chico de todo el pedido.
Camino 2 — subida de archivos Subida de PDF/Word/texto, troceado automático del material, propuesta de título y etiquetas para cada fragmento, y pantalla de revisión donde un administrador corrige y confirma antes de publicar. Medio.
Camino 3 — búsqueda por significado Cambio del mecanismo de búsqueda y reprocesamiento del material cada vez que se edita. Agrega un costo mensual menor. El más grande.
Sostener la actualización Historial de versiones con autor y fecha, posibilidad de volver atrás, y rol específico de editor de metodología. Medio.

El Camino 1 no requiere desarrollo más allá de los ajustes mínimos: todo el trabajo es de contenido, y lo hace Existential.

La que conviene hacer sí o sí: los ajustes mínimos, y pronto. No son una mejora: corrigen que hoy todo lo que se cargue le llegue a Brun-E recortado a cuatro líneas. Además, la documentación funcional de Brun-E describe que la respuesta debería incluir el contenido de la ficha — el recorte parece un atajo de implementación, no una decisión.

Inversión

Sin cotizar — fuera del presupuesto vigente.

Este documento no corresponde a la solicitud del cliente. El pedido —migrar hacia la plataforma la información sobre eModes y el material complementario que hoy vive afuera— es material que lee una persona, y está tratado en 22-marco-teorico.md. Este anexo trata otra cosa: el material que consulta Brun-E durante las conversaciones.

Y ese mecanismo ya está construido. Administración de fichas, etiquetado por E-Mode, carga automática al inicio de cada sesión y consultas durante la conversación: todo eso funciona hoy. Ver Lo que ya existe hoy.

Lo que este documento aporta es un diagnóstico: cuatro límites de esa implementación que conviene conocer, y las opciones para resolverlos si alguna vez se decide invertir en ella. Se cotiza cuando Existential lo pida.

⚠️ Verificar antes de invertir un peso acá. El relevamiento del 2026-08-03 detectó que la base de conocimiento puede no estar usándose hoy en las conversaciones. La herramienta existe y está habilitada, y la administración está construida, pero que el asistente efectivamente la consulte depende de la configuración del prompt, que vive fuera del sistema. Si no la está consultando, mejorar sus límites no cambia nada de lo que la gente percibe. Comprobarlo cuesta minutos.

Si se cotizara, cubriría el Camino 2 más el sostenimiento de la actualización, tomados como una sola pieza: separarlos deja el material cargado sin forma de mantenerlo.

Incluiría

  • Subida de PDF, Word o texto plano, con troceado automático del material en fichas.
  • Propuesta automática de título y etiquetas para cada fragmento.
  • Pantalla de revisión donde un administrador corrige y confirma antes de publicar.
  • Historial de versiones con autor y fecha, y posibilidad de volver atrás.
  • Rol específico de editor de metodología.
  • Los ajustes que el Camino 2 requiere para funcionar: que Brun-E acceda al contenido completo de la ficha y que los resultados se prioricen por pertinencia (L-1 y L-3).
  • Pruebas automatizadas, revisión y puesta en producción, reuniones de definición y seguimiento, y dos rondas de ajuste sobre lo entregado.

No incluiría

  • La búsqueda por significado (Camino 3). Es lo que permitiría que preguntar por "ansiedad" traiga lo escrito sobre "angustia", y resuelve L-2 y L-3 de raíz — pero cambia el mecanismo de búsqueda, obliga a reprocesar el material en cada edición y suma un costo mensual. Se cotiza aparte.
  • Redactar, reescribir o traducir el cuerpo teórico. Es trabajo de contenido de Existential (B-12.1, B-12.7).
  • Un circuito de aprobación con estados antes de publicar (B-12.6).

Supuesto. El material se sube tal como existe hoy —documentos— y no reescrito previamente en fichas breves. Es lo que justifica este camino.

Forma de pago: 50% al inicio, 50% contra entrega.

Relación con otros documentos

Correcciones / historial de validación

Fecha Versión Cambio
2026-08-02 v1.0 Documento inicial. Relevamiento del estado actual del marco teórico sobre el código, identificación de los cuatro límites de la implementación vigente, tres caminos posibles de carga, apartado de sostenimiento y preguntas para la conversación con el cliente.
2026-08-02 v1.1 Corrección tras contrastar con el DRF 12. Precisado que el marco teórico se carga automáticamente al inicio de cada sesión (dos consultas: base + E-Mode de la persona), no sólo por consulta ocasional. Esto agrava L-1: el contexto teórico inicial completo son unos 3.000 caracteres. Detectada además una discrepancia entre el DRF 12 —que describe la respuesta como "título, resumen y contenido relevante"— y el código, que devuelve un recorte de 300 caracteres: el límite parece un atajo de implementación, no una decisión de diseño.
2026-08-05 v2.0 Cambio de identidad y de alcance. El documento pasa a llamarse "Base de conocimiento de Brun-E" y deja de usar el nombre "Marco Teórico", que corresponde al 22. Al precisar la solicitud del cliente se confirmó que el pedido es material de lectura para personas, no fichas para el asistente. En consecuencia este anexo sale de la lista de solicitudes y queda sin cotizar: el mecanismo que describe ya está construido, y lo que aporta es el diagnóstico de sus cuatro límites más la advertencia de verificar si Brun-E está consultando la base antes de invertir en ella.
2026-08-10 v2.1 Recorte de lectura: la advertencia de verificar el uso real de la base deja de estar duplicada en Inversión, se fusiona el resumen con el planteo y Qué agranda / qué se puede recortar se absorben en la tabla B-12.x. Sin cambios de alcance.