Assistente de Suporte de IA
Este guia explica como usar o assistente de IA integrado para obter respostas instantâneas sobre como o Agon funciona — sem sair da aplicação.
Antes de começar
O assistente está acessível a partir de todos os ecrãs da aplicação. Para obter respostas em linguagem simples, ligue-o a um provedor de IA com a chave do próprio estúdio (uma chave gratuita do Google Gemini demora cerca de 3 minutos a criar) ou a um modelo local — consulte Como configurar o Assistente de IA.
Sem um provedor de IA, o assistente funciona em modo básico: escreve algumas palavras-chave e ele mostra os artigos da documentação que melhor correspondem. Quando não encontra uma boa correspondência para o que escreveu — ou apenas saúda — mostra em vez disso um menu de tópicos para explorar: clique numa categoria, depois numa subcategoria, depois numa página (e, numa página com várias secções, a secção específica) para encontrar o que precisa sem ter de adivinhar as palavras-chave certas. O modo básico funciona inteiramente no seu computador e não consegue responder a perguntas livres nem dar conselhos de negócio.
O que o assistente de IA faz
O assistente de IA responde às suas perguntas sobre o Agon em linguagem natural. Pode perguntar-lhe coisas como:
- "Como cancelo uma aula?"
- "O que acontece aos créditos de um cliente quando cancelo uma reserva?"
- "Como exporto um relatório?"
- "Como configuro uma assinatura recorrente?"
Sabe tudo o que está abrangido por esta documentação: aulas, reservas, assinaturas, check-in, relatórios, pagamentos, configurações e muito mais. Responde no idioma em que você escrever.
O que o assistente de IA NÃO faz
Por predefinição, o assistente limita-se a responder a perguntas — nunca faz alterações aos seus dados.
Especificamente, não irá:
- Criar ou modificar perfis de clientes
- Processar pagamentos ou alterar planos de assinatura
- Aceder às informações pessoais dos seus clientes
- Eliminar quaisquer dados
Se lhe pedir para executar uma destas ações, ele explicará como o fazer você mesmo.
Exceção: os gestores do estúdio podem ativar o Modo de Ações da IA para permitir que o assistente execute um conjunto fixo de ações reais a partir de um pedido em linguagem natural — criar ou cancelar uma aula, reservar ou fazer o check-in de um cliente, criar um cliente, atribuir uma assinatura ou obter um relatório. Isto é opcional e só está disponível para a conta de gestor do estúdio — consulte o guia Modo de Ações da IA para a lista completa e o que não consegue fazer.
Perguntas de consultor de negócio
Os gestores do estúdio também podem fazer ao assistente perguntas de análise de negócio sobre o seu próprio estúdio, não apenas perguntas do tipo "como faço". Por exemplo:
- "Quando é que os meus clientes reservam mais?"
- "A minha assinatura Premium tem o preço certo?"
- "Quem são os meus melhores clientes e o que fazem de diferente?"
- "Quão saudável é a minha receita?"
O assistente responde a estas perguntas recorrendo aos dados agregados reais do seu estúdio — reservas por hora/dia e por tipo de aula, preços e adesão às assinaturas, comportamento da coorte de maiores gastadores, e tendências e concentração da receita — e fundamentando a sua resposta nesses números reais. Nunca inventa um número, uma hora de pico ou uma recomendação de preço.
Isto é apenas aconselhamento. Não há forma de o assistente alterar um preço ou tomar qualquer ação com base nisto — só pode dizer-lhe o que vê e sugerir o que ponderar. Se decidir agir com base no seu aconselhamento, continua a ser você a ir ao ecrã relevante (Assinaturas, Relatórios ou Insights) e a fazer a alteração aí.
As mesmas quatro áreas que o assistente pode discutir — padrões de reserva, preços, maiores gastadores e saúde da receita — estão também sempre visíveis como um painel permanente na página Insights, pelo que não precisa de fazer uma pergunta para as ver.
Como usar
-
Clique no botão redondo de chat (💬) no canto inferior direito do ecrã. [SCREENSHOT: The floating chat button in the bottom-right corner of the Agon desktop app]
-
Um painel de chat intitulado "Suporte IA Agon" abre-se logo acima do botão, no canto inferior direito. [SCREENSHOT: The AI Support chat panel open, showing the welcome message]
-
Escreva a sua pergunta na caixa de texto na parte inferior do painel. Escreva em linguagem natural — não são necessários comandos ou palavras-chave especiais. [SCREENSHOT: The text input box with an example question typed]
-
Prima Enviar ou prima Enter no teclado para submeter a sua pergunta.
-
O assistente responderá dentro de alguns segundos. Se a sua pergunta não for clara, pode fazer uma pergunta de seguimento para o ajudar melhor. [SCREENSHOT: An example question and answer exchange in the chat panel]
-
Para fechar o painel, clique no × no topo do painel, ou clique novamente no botão de chat.
Perguntas frequentes
Que idiomas fala? O assistente responde no mesmo idioma em que você escrever. Se escrever em italiano, responde em italiano. Se escrever em espanhol, responde em espanhol. Suporta todos os principais idiomas.
Tem memória entre sessões? Dentro da mesma conversa, sim: reabra-a a partir da lista de conversas à esquerda e continue — o assistente ainda tem tudo o que foi dito antes nessa conversa. Clicar em Nova Conversa começa do zero, sem memória de qualquer outra conversa. As conversas que mantém ativas continuam disponíveis indefinidamente; só uma conversa que arquivou explicitamente é eliminada, e só depois de 30 dias arquivada.
E se der uma resposta errada? O assistente obtém o seu conhecimento desta documentação. Se der uma resposta que não corresponda ao que vê na aplicação, confie no que vê na aplicação. Também pode fazer a pergunta de outra forma — por vezes reformular ajuda. Se achar que a resposta está sistematicamente errada, escreva para support@agon-studio.dev para que a documentação possa ser atualizada.
Pode ajudar-me com problemas que não estão abrangidos pela documentação? O conhecimento do assistente está limitado à documentação do Agon. Para problemas fora desse âmbito — como problemas de rede ou erros do sistema operativo — escreva para support@agon-studio.dev (consulte Feedback e suporte).
O que fazer se algo correr mal?
O assistente só mostra artigos de ajuda em vez de responder Nenhum provedor de IA está ligado, por isso o assistente está em modo básico. Adicione a chave de provedor do seu estúdio em Configurações → Assistente de IA — consulte Como configurar o Assistente de IA.
O assistente diz que o meu provedor de IA está a limitar os pedidos A sua chave de provedor atingiu o limite. Aguarde um minuto e tente novamente, ou aumente os seus limites junto do provedor — consulte Se prevê uma utilização intensiva.
O assistente não responde depois de eu premir Enviar Verifique a sua ligação à Internet: um provedor de IA na nuvem (Gemini ou Groq) precisa dela. Com um modelo local, verifique se o Ollama está em execução. Se estiver tudo bem, experimente fechar e voltar a abrir o painel de chat.
O painel de chat não abre quando clico no botão Experimente reiniciar a aplicação do Agon. Se o problema persistir, verifique se o serviço de backend do Agon está em execução. No macOS, pode fazê-lo saindo completamente do Agon e reabrindo-o a partir da pasta Aplicações.
O assistente diz que não consegue encontrar informação sobre a minha pergunta O assistente faz corresponder a sua pergunta a esta documentação pelo significado, não apenas por palavras-chave exatas, pelo que a maioria das reformulações não é necessária — mas, se mesmo assim não encontrar nada relevante, experimente perguntar sobre a funcionalidade específica pelo nome (por exemplo, "como crio uma assinatura" em vez de "como configuro um plano"). Experimente também perguntar diretamente sobre o produto Agon — o assistente está limitado a responder a perguntas sobre o Agon e recusará perguntas de cultura geral não relacionadas.