Saltar a contenido

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.