Asistente de soporte de IA
Esta guía explica cómo usar el asistente de IA integrado para obtener respuestas instantáneas sobre cómo funciona Agon — sin salir de la aplicación.
Antes de empezar
El asistente es accesible desde todas las pantallas de la aplicación. Para obtener respuestas en lenguaje natural, conéctalo a un proveedor de IA con la clave propia de tu estudio (una clave gratuita de Google Gemini se crea en unos 3 minutos) o a un modelo local — consulta Cómo configurar el asistente de IA.
Sin un proveedor de IA, el asistente funciona en modo básico: escribes unas palabras clave y te muestra los artículos de la documentación que mejor coinciden. Cuando no encuentra una buena coincidencia para lo que escribiste — o simplemente saludas — muestra en su lugar un menú de temas para explorar: haz clic en una categoría, luego una subcategoría, luego una página (y, en una página con varias secciones, la sección concreta) para encontrar lo que necesitas sin tener que adivinar las palabras clave correctas. El modo básico funciona íntegramente en tu ordenador y no puede responder preguntas abiertas ni dar consejos de negocio.
Qué hace el asistente de IA
El asistente de IA responde tus preguntas sobre Agon en lenguaje natural. Puedes preguntarle cosas como:
- "¿Cómo cancelo una clase?"
- "¿Qué pasa con los créditos de un cliente cuando cancelo una reserva?"
- "¿Cómo exporto un informe?"
- "¿Cómo configuro una membresía recurrente?"
Conoce todo lo que cubre esta documentación: clases, reservas, membresías, check-in, informes, pagos, configuración y más. Responde en el idioma en que escribas.
Qué NO hace el asistente de IA
Por defecto, el asistente solo responde preguntas — nunca hace cambios en tus datos.
En concreto, no:
- Crea ni modifica perfiles de clientes
- Procesa pagos ni cambia planes de membresía
- Accede a la información personal de tus clientes
- Elimina ningún dato
Si le pides que realice una de estas acciones, te explicará cómo hacerla tú mismo.
Excepción: los studio managers pueden activar el Modo Acciones de IA para permitir que el asistente realice un conjunto fijo de acciones reales a partir de una petición en lenguaje natural — crear o cancelar una clase, reservar o hacer el check-in de un cliente, crear un cliente, asignar una membresía o sacar un informe. Es opcional y solo está disponible para la cuenta de studio manager — consulta la guía Modo Acciones de IA para ver la lista completa y lo que no puede hacer.
Preguntas de asesoría de negocio
Los studio managers también pueden hacer al asistente preguntas de análisis de negocio sobre su propio estudio, no solo preguntas de tipo "¿cómo hago...?". Por ejemplo:
- "¿Cuándo reservan más mis clientes?"
- "¿Está bien fijado el precio de mi membresía Premium?"
- "¿Quiénes son mis mejores clientes y qué hacen de forma diferente?"
- "¿Cómo de sanos son mis ingresos?"
El asistente responde a estas preguntas extrayendo los datos agregados reales de tu estudio — reservas por hora/día y tipo de clase, precios y adopción de membresías, comportamiento de la cohorte de mayores gastadores, y tendencias y concentración de ingresos — y basando su respuesta en esas cifras reales. Nunca inventa una cifra, una hora punta ni una recomendación de precio.
Esto es solo asesoramiento. No hay forma de que el asistente cambie un precio ni realice ninguna acción a partir de esto — solo puede decirte lo que ve y sugerir qué tener en cuenta. Si decides actuar según su consejo, sigues yendo tú mismo a la pantalla correspondiente (Membresías, Informes o Estadísticas) y haces el cambio ahí.
Las mismas cuatro áreas que el asistente puede tratar — patrones de reserva, precios, mayores gastadores y salud de los ingresos — también están siempre visibles como panel permanente en la página Estadísticas, por lo que no necesitas hacer una pregunta para verlas.
Cómo usarlo
-
Haz clic en el botón redondo de chat (💬) de la esquina inferior derecha de la pantalla. [SCREENSHOT: The floating chat button in the bottom-right corner of the Agon desktop app]
-
Se abre un panel de chat titulado "Soporte IA Agon" justo encima del botón, en la esquina inferior derecha. [SCREENSHOT: The AI Support chat panel open, showing the welcome message]
-
Escribe tu pregunta en el cuadro de texto de la parte inferior del panel. Escribe en lenguaje natural — no hacen falta comandos ni palabras clave especiales. [SCREENSHOT: The text input box with an example question typed]
-
Pulsa Enviar o pulsa Intro en tu teclado para enviar tu pregunta.
-
El asistente responderá en unos segundos. Si tu pregunta no está clara, puede hacer una pregunta de seguimiento para ayudarte mejor. [SCREENSHOT: An example question and answer exchange in the chat panel]
-
Para cerrar el panel, haz clic en la × de la parte superior del panel, o haz clic de nuevo en el botón de chat.
Preguntas frecuentes
¿Qué idiomas habla? El asistente responde en el mismo idioma en que escribes. Si escribes en italiano, responde en italiano. Si escribes en español, responde en español. Admite todos los idiomas principales.
¿Tiene memoria entre sesiones? Dentro de un mismo chat, sí: vuelve a abrirlo desde la lista de chats de la izquierda y continúa — el asistente conserva todo lo dicho antes en ese chat. Al hacer clic en Nuevo chat empieza de cero, sin memoria de ninguna otra conversación. Los chats que mantienes activos siguen disponibles indefinidamente; solo se elimina un chat que has archivado explícitamente, y solo después de 30 días archivado.
¿Y si da una respuesta incorrecta? El asistente extrae su conocimiento de esta documentación. Si da una respuesta que no coincide con lo que ves en la aplicación, confía en lo que ves en la aplicación. También puedes hacer la pregunta de otra forma — a veces reformular ayuda. Si crees que la respuesta es sistemáticamente incorrecta, escribe a support@agon-studio.dev para que se pueda actualizar la documentación.
¿Puede ayudarme con problemas que no están cubiertos en la documentación? El conocimiento del asistente se limita a la documentación de Agon. Para problemas fuera de ese alcance — como problemas de red o errores del sistema operativo — escribe a support@agon-studio.dev (consulta Comentarios y soporte).
¿Qué hacer si algo va mal?
El asistente solo muestra artículos de ayuda en lugar de responder No hay ningún proveedor de IA conectado, así que el asistente está en modo básico. Añade la clave de proveedor propia de tu estudio en Configuración → Asistente IA — consulta Cómo configurar el asistente de IA.
El asistente dice que mi proveedor de IA está limitando las peticiones Tu clave de proveedor ha alcanzado su límite. Espera un minuto e inténtalo de nuevo, o amplía tus límites con el proveedor — consulta Si prevés un uso intensivo.
El asistente no responde después de pulsar Enviar Comprueba tu conexión a internet: un proveedor de IA en la nube (Gemini o Groq) la necesita. Con un modelo local, comprueba que Ollama está en ejecución. Si todo está bien, prueba a cerrar y volver a abrir el panel de chat.
El panel de chat no se abre cuando hago clic en el botón Prueba a reiniciar la aplicación Agon. Si el problema continúa, comprueba que el servicio de backend de Agon está en ejecución. En macOS, puedes hacerlo cerrando Agon por completo y volviéndolo a abrir desde tu carpeta Aplicaciones.
El asistente dice que no encuentra información sobre mi pregunta El asistente hace coincidir tu pregunta con esta documentación por significado, no solo por palabras clave exactas, así que la mayoría de las veces no hace falta reformular — pero si aun así no encuentra nada relevante, prueba a preguntar por la función concreta por su nombre (por ejemplo, "cómo creo una membresía" en lugar de "cómo configuro un plan"). Prueba también a preguntar directamente por el producto Agon — el asistente está acotado a responder preguntas sobre Agon y rechazará preguntas de cultura general no relacionadas.