Asistente de consultas
Tipo de página: referencia (descripción del panel, límites y temas que cubre).
Para quién: usuarios con acceso al asistente; quien administra la organización para configurar el acceso y el cupo.
Relacionadas: guía Cómo hacerle una pregunta al asistente · explicación Cómo funciona el asistente y qué datos usa.
Quién puede usarlo
Hacen falta las dos cosas:
| Requisito |
Detalle |
Feature asistente |
Habilitada para la organización en Configuración General > Features. Además necesita una key de Anthropic, que carga el administrador de Hexalba. La tarjeta del asistente en Features te dice si la key está "configurada para esta organización", si "usa la de la instalación" o si está "sin configurar". Sin key el asistente queda apagado aunque la feature esté habilitada. |
Acción usar_asistente |
"Usar el asistente de consultas". Por defecto la tienen los roles ADMINISTRADOR y DUEÑO de una instalación estándar. Se asigna a cualquier rol desde Roles. |
Si falta cualquiera de las dos, el ícono del asistente no aparece en el encabezado.
Dónde se abre
Ícono de destello en el encabezado, con el texto de ayuda Preguntale a Hexalba. El panel se abre sobre la pantalla y se cierra solo al navegar a otra página; si había una consulta en curso, sigue procesándose.
Panel "Preguntale a Hexalba"
| Elemento |
Detalle |
| Volver a tus conversaciones (flecha) |
Vuelve a la lista de conversaciones. |
| Nueva conversación |
Empieza una conversación vacía. |
| Cerrar |
Cierra el panel. |
| Pie del panel |
"Tus conversaciones las ves solo vos y se borran a los 90 días" y la aclaración del cupo diario. |
Lista de conversaciones
| Elemento |
Detalle |
| Lista |
Tus conversaciones, de la de actividad más reciente a la más vieja, con paginación ("Página X de Y"). Tocar una la reabre para seguirla. |
| "Todavía no tenés conversaciones." |
Estado vacío, con el botón Hacer una pregunta. |
| Borrar la conversación |
Ícono de papelera en cada fila. Pide confirmación. |
| Borrar todas mis conversaciones |
Botón al pie. Pide confirmación. |
Al confirmar el borrado: "Se borra definitivamente. No se puede deshacer." Si había una consulta en curso, se cancela y su respuesta no se guarda. Avisos al terminar: "Se borró la conversación." / "Se borraron tus conversaciones."
Conversación
| Elemento |
Detalle |
| Tu pregunta |
Campo de texto "Escribí tu pregunta…". Máximo 2000 caracteres. |
| Estados de la consulta |
"Consultando…", "Escribiendo la respuesta…", "Se cortó la conexión. Recuperando la respuesta…". |
| Reintentar |
Aparece si falló la carga o la consulta. |
| Fuentes |
Debajo de cada respuesta, enlaces a las pantallas de Hexalba de donde sale el dato. |
| Mientras responde |
El campo queda bloqueado con "Esperá a que termine la consulta en curso." |
| Conversación llena |
"Esta conversación llegó al máximo de preguntas. Empezá una nueva para seguir." Por defecto una conversación admite hasta 40 preguntas. |
| Memoria de la conversación |
Para responder, el asistente tiene en cuenta las preguntas y respuestas anteriores de la misma conversación, por defecto hasta las 10 últimas. Si quedaron afuera, lo aclara. |
Límite de consultas por día
| Concepto |
Valor |
| Alcance |
Por usuario, por día argentino. Cambiar de rol durante el día no reinicia el contador. |
| Valor por defecto |
30 consultas para un rol que tiene usar_asistente; 0 para el resto. |
| Se configura |
Por rol, en Configuración General > Roles, campo Consultas de asistente por día, entre 0 y 1000. Vacío usa el valor por defecto; 0 impide usarlo. |
| Qué descuenta |
Cada consulta, aunque termine bloqueada por el filtro de seguridad o falle el servicio. No descuentan las preguntas vacías o demasiado largas. |
Mensajes de error
| Mensaje |
Significado |
| Escribí una pregunta. |
El campo está vacío. |
| La pregunta puede tener hasta 2000 caracteres. |
Pregunta demasiado larga. |
| La pregunta tiene caracteres no permitidos. |
La pregunta trae caracteres invisibles o de control (suele pasar al pegar texto). |
| La pregunta no es válida. Revisala y probá de nuevo. |
El servidor rechazó la pregunta por su formato. |
| Tu sesión venció. Volvé a ingresar. |
Hay que iniciar sesión de nuevo. |
| No tenés acceso al asistente. |
Falta la acción o la feature. |
| No encontramos esta conversación: puede que se haya borrado o vencido. |
La conversación ya no existe (se borra a los 90 días). |
| Ya hay una consulta en curso en esta conversación. Esperá a que termine. |
Una pregunta por vez por conversación. |
| Esta conversación llegó al máximo de preguntas. Empezá una nueva para seguir. |
Tope por conversación. |
| Esta conversación se borró. La respuesta no se guardó. |
Se borró mientras se respondía. |
| Llegaste al límite de consultas de hoy. Vas a poder volver a preguntar mañana. |
Cupo diario agotado. |
| Hexalba está en mantenimiento. Probá de nuevo en unos minutos. |
Tareas de mantenimiento en curso. |
| El asistente no está disponible en este momento. Probá de nuevo más tarde. |
Servicio no disponible. |
| No pudimos conectarnos. Revisá tu conexión y probá de nuevo. |
Sin conexión. |
| Se canceló la consulta. |
La consulta se canceló (por ejemplo, al borrar la conversación). |
| La consulta está tardando más de lo normal. Revisá la conversación en unos minutos. |
Se superó el tiempo de espera de la pantalla. |
| La consulta tardó demasiado y se cortó. Probá con una pregunta más acotada o de nuevo en unos minutos. |
La consulta superó el tiempo máximo del servidor. |
| La consulta necesitó revisar demasiados datos y se cortó antes de terminar. Probá acotarla... |
Acotá a un local, un período más corto o una pregunta por vez. |
| La consulta necesitó demasiados pasos y se cortó antes de terminar. Probá dividirla... |
Dividí en preguntas más simples. |
| La respuesta quedó incompleta. Probá de nuevo o acotá la pregunta. |
Reintentá o acotá. |
| El servicio de inteligencia artificial no respondió. Probá de nuevo en unos minutos. |
Falló el proveedor de IA o el filtro de seguridad no pudo revisar la pregunta. |
| No pudimos completar la consulta. Probá de nuevo. |
Una respuesta guardada que quedó fallida o interrumpida. |
| No puedo ayudarte con esa consulta. Probá con una pregunta sobre los datos de tu negocio. |
La pregunta no es sobre los datos del negocio y el asistente no la responde. |
| Esta respuesta usó información a la que hoy no tenés acceso. |
Al reabrir una conversación vieja: la respuesta usó datos que tu rol ya no puede ver, y se oculta. |
| No respondí esta pregunta porque el filtro de seguridad la marcó como riesgosa... |
El filtro bloqueó la consulta; ver la guía. |
| La respuesta no se pudo guardar en tu historial. |
Se respondió, pero no quedó en el historial. |
Qué temas puede consultar
El asistente consulta datos de solo lectura y respeta lo que tu rol puede ver: para cada tema exige los mismos permisos (y, si corresponde, la misma feature) que la pantalla equivalente. Usa los locales a los que tenés acceso; en una misma consulta suele tomar hasta 10 locales, y en muchos temas hasta 92 días de rango.
| Módulo |
Qué podés preguntar |
Permiso o feature que lo habilita |
| Ventas y dashboard |
Resumen de ventas del local, estado operativo del local (lo mismo que los widgets), ventas por período, ranking de mozos y de productos |
Los del widget correspondiente; ver_ventas_sisnube y feature sisnube para ventas y rankings |
| Análisis de gastos |
Gastos del mes y su % sobre la venta |
ver_adg |
| Facturas y proveedores |
Facturas, proveedores, deuda con proveedores (cuentas corrientes), efectividad de la lectura automática |
Facturas y cuentas corrientes: los de esas pantallas. Proveedores: ver_proveedores o agregar_proveedor. Efectividad: ver_efectividad_ocr con feature ocr-facturas |
| Costos |
Precios y aumentos de insumos, historial de compras de un insumo |
ver_costos y feature costos |
| Caja y tesorería |
Cierres de caja y su detalle, movimientos de caja, saldos de tesorería |
Los de Cierres de Caja y Tesorería; ver_resumen_caja para saldos |
| Asistencia |
Asistencia del día, resumen de asistencia por período, francos de la semana, ausencias justificadas, turnos y horarios, tu propia asistencia |
Día: ver_presentismo, registrar_entrada o editar_presentismo. Período: ver_gestion_presentismo. Francos: ver_francos o editar_francos. Turnos: ver_turnos, editar_turno o iniciar_cierre. Ausencias: los de Ausencias Justificadas. Tu propia asistencia: alcanza con usar_asistente |
| Recursos humanos |
Masa salarial, sanciones, uniformes, solicitudes de uniformes, adelantos (gestión y los tuyos), tu resumen mensual |
Masa salarial: ver_masa_salarial. Sanciones, uniformes y adelantos: los de cada pantalla (de gestión o los propios). Tu resumen mensual: alcanza con usar_asistente |
| Objetivos |
Avance de objetivos de venta y de cocina, tus propios objetivos |
ver_objetivos_venta / editar_objetivos_venta con feature objetivos-venta; ver_objetivos_cocina / editar_objetivos_cocina con feature objetivos-cocina; ver_mis_objetivos_venta / ver_mis_objetivos_cocina para los tuyos |
| Conteos y pedidos |
Calendario de proveedores, conteo de un proveedor, historial de pedidos, recepciones pendientes, indicadores de inventario |
Con feature conteos-pedidos. Calendario: ver_conteos_pedidos o configurar_guia_pedidos. Inventario: ver_conteos_pedidos o registrar_conteo. Recepciones: ver_conteos_pedidos o registrar_recepcion. Conteo e historial: los de Conteos y Pedidos |
| Documentación |
Documentos legales del local por vencer o vencidos |
ver_documentos_local |
Permisos de los temas que siguen a una pantalla. Con una sola de las acciones de cada fila alcanza:
| Tema |
Acciones |
| Facturas |
ver_facturas, agregar_factura_carga, ver_gestion_facturas o aprobar_rechazar |
| Deuda con proveedores (cuentas corrientes) |
ver_cuentas_corrientes, editar_factura_cc o boton_pagar |
| Cierres de caja y su detalle |
iniciar_cierre, ver_auditorias o ver_auditorias_turno. Con una acción de Gestión de Auditorías ves todos los cierres de tus locales. Si no, con ver_cierres_del_turno ves los de tu turno, y sin ella solo los cierres en los que sos responsable. |
| Movimientos de caja |
ver_movimientos o crear_movimiento |
| Ausencias justificadas |
ver_ausencias o registrar_ausencia |
| Sanciones |
ver_gestion_sanciones o gestionar_sanciones para ver todas las de tus locales. Con solo ver_solicitudes_sanciones o crear_sancion ves únicamente las que cargaste vos. |
| Uniformes (prendas asignadas y stock) |
ver_gestion_uniformes o gestionar_uniformes |
| Solicitudes de uniformes |
ver_aprobacion_uniformes o aprobar_uniformes para ver todas. Con solo ver_solicitudes_uniformes o crear_solicitud_uniforme ves únicamente las que cargaste vos. |
| Gestión de adelantos |
ver_gestion_adelantos, procesar_adelantos o ver_parametros. Los parámetros del local solo los ves con ver_parametros. |
| Tus adelantos |
ver_solicitud_adelantos o solicitar_adelanto |
| Conteo de un proveedor |
ver_conteos_pedidos, registrar_conteo o configurar_guia_pedidos, con la feature conteos-pedidos |
| Historial de pedidos |
ver_conteos_pedidos, registrar_conteo o confirmar_pedido, con la feature conteos-pedidos |
El asistente no ejecuta acciones: no carga facturas, no aprueba, no modifica nada. Solo lee.
Historial y retención
| Concepto |
Valor |
| Quién ve tus conversaciones |
Solo vos. |
| Retención |
90 días. Una tarea automática purga las conversaciones y su registro pasado ese plazo. |
| Qué se registra de auditoría |
Que hubo una consulta y su alcance, sin el contenido de la pregunta ni de la respuesta. |