Skip to main content

AI Support Assistant

This guide explains how to use the built-in AI assistant to get instant answers about how Agon works — without leaving the app.

Before you start​

The assistant is accessible from every screen in the application. To get answers in plain language, connect it to an AI provider with your studio's own key (a free Google Gemini key takes about 3 minutes) or to a local model — see How to set up the AI Assistant.

Without an AI provider, the assistant works in basic mode: type a few keywords and it shows the documentation articles that best match. When it can't find a good match for what you typed — or you just say hello — it shows a browsable topics menu instead: click a category, then a subcategory, then a page (and, on a page with multiple sections, the specific section) to find what you need without having to guess the right keywords. Basic mode runs entirely on your computer and can't answer free-form questions or give business advice.

What the AI assistant does​

The AI assistant answers your questions about Agon in plain language. You can ask it things like:

  • "How do I cancel a class?"
  • "What happens to a client's credits when I cancel a booking?"
  • "How do I export a report?"
  • "How do I set up a recurring membership?"

It knows everything covered in this documentation: classes, bookings, memberships, check-in, reports, payments, settings, and more. It responds in whatever language you write in.

What the AI assistant does NOT do​

By default, the assistant only answers questions — it never makes changes to your data.

Specifically, it will not:

  • Create or modify client profiles
  • Process payments or change membership plans
  • Access your clients' personal information
  • Delete any data

If you ask it to perform one of these actions, it will explain how to do it yourself instead.

Exception: studio managers can turn on AI Action Mode to let the assistant perform a fixed set of real actions from a plain-language request — creating or cancelling a class, booking or checking in a client, creating a client, assigning a membership, or pulling a report. This is opt-in and only available to the studio manager account — see the AI Action Mode guide for the full list and what it can't do.

Business advisor questions​

Studio managers can also ask the assistant business-analysis questions about their own studio, not just "how do I" questions. For example:

  • "When do my clients book most?"
  • "Is my Premium membership priced right?"
  • "Who are my best clients and what do they do differently?"
  • "How healthy is my revenue?"

The assistant answers these by pulling your studio's real aggregate data — bookings by hour/day and class type, membership pricing and adoption, top-spender cohort behavior, and revenue trends and concentration — and grounding its answer in those actual numbers. It never invents a number, a peak time, or a price recommendation.

This is advice only. There is no way for the assistant to change a price or take any action based on this — it can only tell you what it sees and suggest what to consider. If you decide to act on its advice, you still go to the relevant screen yourself (Memberships, Reports, or Insights) and make the change there.

The same four areas the assistant can discuss — booking patterns, pricing, top spenders, and revenue health — are also always visible as a permanent dashboard on the Insights page, so you don't need to ask a question to see them.

How to use it​

  1. Click the round chat button (💬) in the bottom-right corner of the screen. [SCREENSHOT: The floating chat button in the bottom-right corner of the Agon desktop app]

  2. A chat panel titled "Agon AI Support" opens just above the button, in the bottom-right corner. [SCREENSHOT: The AI Support chat panel open, showing the welcome message]

  3. Type your question in the text box at the bottom of the panel. Write in plain language — no special commands or keywords are needed. [SCREENSHOT: The text input box with an example question typed]

  4. Press Send or press Enter on your keyboard to submit your question.

  5. The assistant will reply within a few seconds. If your question is unclear, it may ask a follow-up question to help you better. [SCREENSHOT: An example question and answer exchange in the chat panel]

  6. To close the panel, click the × at the top of the panel, or click the chat button again.

Frequently asked questions​

What languages does it speak? The assistant responds in the same language you write in. If you write in Italian, it answers in Italian. If you write in Spanish, it answers in Spanish. It supports all major languages.

Does it have memory between sessions? Within one chat, yes: reopen it from the chat list on the left and keep going — the assistant still has everything said earlier in that same chat. Click New Chat and it starts fresh, with no memory of any other conversation. Chats you keep active stay available indefinitely; only a chat you've explicitly archived is deleted, and only after 30 days in the archive.

What if it gives a wrong answer? The assistant draws its knowledge from this documentation. If it gives an answer that does not match what you see in the app, trust what you see in the app. You can also ask the question in a different way — sometimes rephrasing helps. If you believe the answer is consistently wrong, email support@agon-studio.dev so the documentation can be updated.

Can it help me with problems that are not covered in the documentation? The assistant's knowledge is limited to the Agon documentation. For issues outside of that scope — such as network problems or operating system errors — email support@agon-studio.dev (see Feedback and support).

What if something goes wrong?​

The assistant only shows help articles instead of answering No AI provider is connected, so the assistant is in basic mode. Add your studio's own provider key in Settings → AI Assistant — see How to set up the AI Assistant.

The assistant says my AI provider is rate-limiting requests Your provider key has reached its limit. Wait a minute and try again, or raise your limits with the provider — see If you expect heavy use.

The assistant does not respond after I press Send Check your internet connection: a cloud AI provider (Gemini or Groq) needs one. With a local model, check that Ollama is running. If that's fine, try closing and reopening the chat panel.

The chat panel does not open when I click the button Try restarting the Agon application. If the problem continues, check that the Agon backend service is running. On macOS, you can do this by quitting Agon completely and reopening it from your Applications folder.

The assistant says it cannot find information on my question The assistant matches your question against this documentation by meaning, not just exact keywords, so most rephrasing isn't necessary — but if it still can't find anything relevant, try asking about the specific feature by name (for example, "how do I create a membership" instead of "how do I set up a plan"). Also try asking directly about the Agon product — the assistant is scoped to answering questions about Agon and will decline unrelated, general-knowledge questions.