Lo que un asistente de ayuda debería y no debería saber de tu negocio
Sage responde preguntas de cómo-hacer desde nuestro corpus de ayuda y declina preguntas sobre tus registros, tus números o lo que deberías hacer después. Aquí está por qué.
El asistente de ayuda dentro de PartnerView se llama Sage. Contesta una pregunta recuperando extractos de nuestros artículos de ayuda, el Manual de Usuario y el Catálogo de Funciones, y luego sintetiza una respuesta que cita la fuente.
No lee tus datos de negocio en vivo. No predice resultados de negocio. Declina con elegancia preguntas sobre registros específicos, números específicos o lo que deberías hacer después.
Ese último conjunto de rechazos es deliberado. La línea entre “cómo modelo esto” y “qué debería hacer” es la línea entre una pregunta de documentación y una decisión de juicio. La primera es algo que un asistente de ayuda debería contestar. La segunda es algo que la firma debería contestar, con el contexto de la firma, por una persona que rinde cuentas del resultado.
En qué está fundamentado Sage
El conocimiento de Sage son tres corpus más una capa de dominio derivada del código.
El primer corpus son nuestros artículos de ayuda, escritos como documentación. El segundo es el Manual de Usuario, la prosa de forma larga que explica cómo funciona el producto. El tercero es el Catálogo de Funciones, el inventario estructurado de cada capacidad entregada. Una capa de dominio derivada del código agrega el esquema del producto, así que Sage entiende qué es un trato, qué es un cronograma de comisión, qué es un asiento de reconocimiento de ingresos, en abstracto.
El recupero es FTS5 sobre contenido troceado. Sin base de datos vectorial. Recupero por palabra clave contra trozos indexados de los corpus de arriba. Cuando un usuario hace una pregunta, el recupero rankea los extractos más relevantes. Claude sintetiza una respuesta usando solo esos extractos como entrada.
Cuando el recupero es débil, cuando ningún extracto puntúa lo suficientemente alto para ser útil, Sage devuelve “no cubierto” y no llama al modelo en absoluto. Sage no alucina una respuesta desde los datos de entrenamiento cuando el corpus de ayuda no contiene una. Los casos no cubiertos caen en un dashboard de admin para que podamos escribir el artículo faltante.
El corpus se reindexa en cada deploy, después de las migraciones. El contenido de ayuda que Sage conoce es igual al contenido de ayuda que el producto acaba de entregar. No hay una “base de conocimiento de IA” aparte mantenida por un equipo aparte que se separa del producto. El producto es la fuente.
Lo que Sage deliberadamente no verá
Cero datos de negocio. Nada.
El prompt del sistema y el código que llama al modelo pasan solo tres cosas. La pregunta actual del usuario. Los turnos recientes de la conversación. Los extractos de ayuda recuperados. Esa es la ventana de contexto entera.
Sage nunca ve un registro de trato. Nunca una comisión. Nunca un número de margen. Nunca un asiento contable. Nunca el nombre de un cliente de tu CRM. Nunca un registro de tiempo. Nunca un rol de permisos. Nunca un reporte de antigüedad.
Si un usuario pregunta “¿cómo va mi trato con Acme Corp?”, Sage no busca el trato. Sage explica que contesta preguntas de cómo-hacer sobre el producto, y que el usuario debería abrir el registro del trato. Si un usuario pregunta “¿qué debería cotizar para una implementación de 12 semanas?”, Sage explica que las decisiones de precio no están en el alcance del asistente de ayuda.
Esto no es una barandilla atornillada después del hecho. Es una decisión de diseño sobre qué forma de pregunta es el asistente. No queremos a un modelo tomando decisiones de juicio de negocio sobre el dinero de una firma, y la forma más limpia de asegurarnos de que eso no pasa es nunca poner los datos de la firma frente al modelo en primer lugar.
La postura se prueba contra fugas de forma independiente. La suite de pruebas incluye sondas adversariales que intentan hacer que Sage saque a la superficie datos de negocio, infiera números desde la estructura de la pregunta o tome una posición en una decisión de juicio. Las sondas son parte del conjunto de pruebas permanente. Una sonda fallida bloquea el build.
Lo que controla un admin
La superficie de admin en /admin/helpbot es la prueba de que la postura es operable, no solo declarada.
Un kill switch a nivel organización apaga Sage para todo el tenant. Si la firma decide que no quiere ningún LLM en el loop, el switch se voltea y Sage deja de responder. El cajón de Ayuda regresa a búsqueda por palabra clave contra el corpus de ayuda.
Un selector de modelo deja que el admin elija Sonnet (el predeterminado) o Haiku (más barato, más rápido, ligeramente menos capaz). La elección es por tenant. El admin sensible al costo elige Haiku. El admin que quiere la mejor síntesis elige Sonnet.
Un tope de presupuesto mensual con auto-pausa. Si Sage gasta más que el tope en un mes calendario, se pausa por el resto del mes. El admin ve la pausa en el dashboard. El tope lo pone el admin, no nosotros.
Un rate limit por usuario por hora, 30 preguntas por hora por usuario de forma predeterminada. Detiene un script desbocado. Detiene a un usuario frustrado que hace la misma pregunta 200 veces.
El dashboard muestra el split de pulgares (útil contra no útil, por sesión) y la lista de huecos (preguntas que Sage marcó como “no cubiertas”). La lista de huecos es la entrada de la firma a nuestro backlog de escritura de ayuda. Si tus usuarios siguen preguntando algo que no hemos documentado, deberíamos saberlo.
Lo que PartnerView entrega
Sage es el asistente de ayuda dentro del cajón de Ayuda. Tres corpus más una capa de dominio derivada del código, recupero FTS5, síntesis de Claude solo desde extractos recuperados, cero datos de negocio en el prompt del sistema, “no cubierto” en recupero débil, kill switch a nivel organización, selector de modelo, tope de presupuesto mensual, rate limit por usuario, dashboard de admin con split de pulgares y una lista de huecos.
La postura de privacidad es la misma forma que el resto del producto. La matemática del dinero es determinista y se queda fuera de cualquier modelo. El asistente de ayuda está fundamentado en documentación y se queda fuera del juicio de negocio. La línea entre para qué sirve un modelo y para qué sirve una persona pasa por el producto a propósito, y Sage es la parte visible de dónde la dibujamos.
Un modelo que contesta “¿cómo configuro un cronograma de comisión?” es una pregunta de documentación. Un modelo que contesta “¿debería tomar este trato?” es una pregunta que la firma debería contestar. Elegimos dónde va la línea, y probamos que la línea aguanta.