Preparar el Ask
Contexto de la empresa, contexto por aplicación, consultas validadas, evaluación de preparación, privacidad y publicación.
El Ask no adivina el negocio. Responde a partir de lo que el equipo de datos escribió sobre cada aplicación, y esa preparación es lo que separa una respuesta confiable de una respuesta segura y equivocada. Todo vive en Admin, en la pantalla de recursos del Ask.
Solo las aplicaciones de espacios gestionados de Qlik aparecen para la preparación. El contenido en espacios personales o compartidos queda fuera, porque el portal trabaja únicamente con lo publicado y gobernado.
Contexto de la empresa
Un texto único, en Markdown, válido para todas las aplicaciones habilitadas. Es el lugar de la descripción de la empresa, del vocabulario general del negocio y de las directrices que valen en cualquier respuesta, como la moneda y el idioma.
Es también lo que sostiene las preguntas hechas sin elegir una aplicación. En ese modo el agente conoce el contexto de la empresa y la lista de aplicaciones preparadas, y decide cuál responde.
El contexto de la aplicación
Cada aplicación tiene su propio documento de contexto, dividido en secciones. La división no es organizativa: cada sección llega al agente con un peso distinto.
| Sección | Qué entra | Cómo la trata el agente |
|---|---|---|
| Contexto | Qué es la aplicación y para qué sirve | Enmarca la respuesta |
| Reglas de negocio | Medidas canónicas, cuidados, exclusiones | Fuente de la verdad; el agente no redescubre lo que está aquí |
| Premisas | Año fiscal, moneda, qué cuenta como activo, exclusiones por defecto | Aplicadas por defecto y registradas en "Cómo se calculó" |
| Restricciones y negativos | Qué rechazar, qué preguntar en lugar de adivinar | Inviolables: prevalecen sobre el pedido del usuario |
| Vocabulario y sinónimos | Término del usuario hacia la medida o campo canónico | Resuelve el término antes de explorar el modelo de datos |
| Ejemplos | Preguntas típicas, casos especiales | Referencia de estilo |
Reglas de negocio es la única sección obligatoria: sin ella la aplicación no puede habilitarse. Las otras cinco son lo que separa "responde" de "responde bien".
El vocabulario es la palanca más directa. La pregunta llega con la palabra del usuario, "facturación", "equipo", "cartera", no con el nombre de la medida. Sin ese mapa el agente resuelve por el nombre más parecido, y en una aplicación con Ingresos, Ingresos Netos e Ingresos Brutos la elección correcta no es evidente. Unas líneas de vocabulario resuelven más errores que páginas de descripción.
El borrador generado con IA
Un botón redacta una propuesta de reglas a partir del nombre de la aplicación, sus campos, sus medidas y el contexto de la empresa. Es un punto de partida para quien no sabe cómo empezar.
Mientras el texto no recibe edición humana, la aplicación queda marcada como no revisada, y los usuarios ven, en el chat de ese panel, el aviso de que las respuestas pueden traer valores incorrectos. El aviso desaparece cuando el texto se revisa.
Evaluación de preparación
La evaluación lee la aplicación en Qlik, es decir medidas maestras, dimensiones maestras, campos y objetos de las hojas, junto con el contexto escrito, y devuelve una lista de puntos de atención clasificados por severidad, además de una nota.
Lo que suele señalar:
- reglas de negocio ausentes, o demasiado cortas para orientar;
- premisas y límites sin documentar, que es justamente lo que el agente equivoca en silencio;
- vocabulario sin documentar;
- medidas maestras sin descripción, o con nombres parecidos y sin regla escrita de cuál usar en cada pregunta;
- campos con nombres difíciles de interpretar;
- ausencia de consultas validadas, o consultas que dejan sin cubrir alguna de las tres formas de pregunta más comunes: número único, evolución en el tiempo y desglose por categoría.
La evaluación no bloquea. Una aplicación con puntos críticos puede salir al aire, con el aviso de que las respuestas tienden a ser peores hasta resolverlos.
Consultas validadas
Una consulta validada es un recorte listo de la aplicación: dimensiones, medidas, filtros y número máximo de filas, con nombre y descripción. El agente prefiere usarlas cuando la pregunta coincide con la descripción porque devuelven siempre el misma fórmula y aparecen por su nombre en el panel "Cómo se calculó", en lugar de una expresión creada al momento.
La consulta se arma a partir de los ítems maestros de la aplicación o de expresiones en sintaxis Qlik, y se valida contra la aplicación antes de guardarse: el portal la ejecuta y muestra las filas devueltas.
Dos decisiones merecen atención.
Ítem maestro o fórmula. Referenciar el ítem maestro hace que la consulta acompañe los cambios de fórmula en Qlik. Copiar la fórmula congela el cálculo, y el cambio hecho en Qlik no llega hasta aquí.
Pregunta lista. La consulta puede llevar una pregunta de ejemplo, que se vuelve sugerencia clicable en la entrada del chat de esa aplicación. Es la forma más barata de enseñar a preguntar.
Probar antes de publicar
La aplicación habilitada y aún no publicada es visible para administradores y para los usuarios marcados como probadores. Publicar la libera para todos, y despublicar devuelve al estado anterior sin borrar nada.
La pantalla de preparación tiene un chat de prueba. Responde con el contexto guardado, no con lo que está en pantalla, así que conviene guardar antes de volver a probar.
Modo de Privacidad
El modo de privacidade al utilizar el Ask tiene un valor por defecto del workspace y un ajuste por aplicación.
Con ella activa, ninguna fila de datos pasa por el modelo: la consulta se ejecuta en el servidor y el servidor arma el gráfico. El modelo recibe la estructura del resultado, no los valores. El usuario sigue pidiendo el formato que quiera, y el texto de la respuesta queda más corto, porque el modelo no comenta números que no vio.
La aplicación con privacidad propia solo se consulta cuando está en foco. Queda fuera de las preguntas generales, hechas sin elegir aplicación, porque allí la garantía vale por conversación y no por aplicación.
Visualización
Cuatro opciones controlan lo que aparece en cada respuesta, para todo el workspace: el icono de "Cómo se calculó", el tiempo de respuesta, el total de tokens y el indicador de contexto cargado. El valor por defecto muestra los dos primeros.
Apagar el icono de "Cómo se calculó" le quita al usuario la auditoría del número, y solo tiene sentido cuando esa auditoría ocurre por otro camino.
Uso y cuota
La pestaña de uso muestra conversaciones por día, tokens, usuarios, llamadas de consulta y errores, con desglose por aplicación y por usuario. Responde dos preguntas: qué paneles generan preguntas y quién está usando.
La cuota de preguntas es del workspace, no de la persona. El portal avisa cuando el período se acerca al final y bloquea al agotarse, con el pedido de aumento disponible desde el propio aviso.
Buenas prácticas
- Escriba primero el vocabulario. Unas pocas líneas mapeando los términos que la gente usa resuelven más errores que páginas de descripción.
- Desambigüe las medidas parecidas. Escriba qué medida responde a qué tipo de pregunta. Cuando dos se parecen, el agente elige una con convicción, y puede ser la equivocada.
- Documente las premisas. Ejemplo: año fiscal, moneda, qué cuenta como activo, exclusiones por defecto. El agente aplica esas premisas y las registra en "Cómo se calculó".
- Diga qué no cubren los datos. Períodos, unidades, granularidad. El agente deja de responder más allá de lo que sabe.
- Cubra las tres formas de pregunta con consultas validadas. Número único, evolución en el tiempo y desglose por categoría.
- Revise el borrador generado por la IA antes de publicar. Acierta la estructura, pero puede equivocarse en el contenido. Se recomienda encarecidamente la revisión humana.
- Pruebe con las preguntas que la gente realmente hace, no con las que la aplicación responde bien.
Los límites de la preparación
El contexto orienta al agente, no arregla el modelo de datos. Una medida equivocada en la aplicación sigue equivocada en la respuesta, y la corrección ocurre en Qlik.
La preparación tampoco amplía el acceso. Cada consulta se ejecuta con el permiso de quien preguntó, y una aplicación publicada para el Ask sigue respondiendo solo lo que esa persona vería abriendo la aplicación.