Modo de Ações da IA
Este guia explica como usar o Modo de Ações para executar ações reais no Agon — criar ou cancelar uma aula, reservar ou fazer o check-in de um cliente, atribuir uma assinatura, obter um relatório e muito mais — escrevendo um pedido em linguagem natural ao assistente de IA, em vez de usar os ecrãs habituais.
Antes de começar
O Modo de Ações só está disponível para a conta de gestor do estúdio — os instrutores não o veem. Precisa de um provedor de IA ligado ao Assistente de IA (a chave do próprio estúdio ou um modelo local): em modo básico, as ações não estão disponíveis. Consoante a ação que pedir, também precisa de ter os dados relevantes já configurados (por exemplo, um tipo de aula e um local ativos antes de pedir para criar uma aula), uma vez que o assistente precisa de algo com que fazer corresponder o seu pedido.
O que o Modo de Ações faz
Com o Modo de Ações desativado, o assistente de IA limita-se a responder a perguntas — consulte Assistente de Suporte de IA. Com o Modo de Ações ativado, também pode executar uma de vinte e uma ações por si quando a descreve em linguagem natural:
| Ação | Exemplo de pedido |
|---|---|
| Criar uma aula | "Cria uma aula de Yoga Flow na próxima quarta-feira às 18:00 em Lisboa com a Elena, uma hora" / "Agenda uma aula de Pilates na próxima sexta-feira às 9:00 no local Baixa, 45 minutos" |
| Cancelar uma aula | "Cancela a aula de pilates de sexta-feira" |
| Reservar um cliente numa aula | "Reserva a Maria Rossi na aula de Yoga Flow de amanhã às 18:00" |
| Cancelar a reserva de um cliente | "Cancela a reserva da Maria para a aula de spin de sexta-feira" |
| Ver a lista de participantes de uma aula | "Quem está inscrito na aula de Yoga Flow de amanhã às 18:00?" |
| Fazer o check-in de um cliente | "Faz o check-in da Maria Rossi para a aula das 18:00 de Yoga Flow" |
| Criar um novo cliente | "Cria um novo cliente chamado Mário Rossi, mario@example.com" |
| Atribuir uma assinatura a um cliente | "Atribui a assinatura Pack à Elena a partir de hoje" |
| Obter um relatório | "Qual foi a nossa receita no mês passado?" (frequência, receita, assinaturas ou retenção) |
| Criar uma tag | "Cria uma tag chamada VIP" |
| Atribuir uma tag a um cliente | "Atribui a tag VIP ao Marco Verdi" |
| Emitir um cartão presente | "Emite um cartão presente de 50 € para a Sara Conti" |
| Criar um código promocional | "Cria um código promocional VERAO20, 20% de desconto, válido até 2026-09-30" |
| Criar um produto | "Adiciona um novo produto: Tapete de Yoga, preço 25 €" |
| Criar um local | "Cria um novo local chamado Baixa" |
| Criar um tipo de aula | "Cria um novo tipo de aula chamado Spin Avançado, 45 minutos, capacidade 12" |
| Criar um termo de responsabilidade | Cole o título exato e o texto legal completo que quer que os clientes assinem e peça ao assistente para o criar como termo de responsabilidade |
| Criar uma conta de instrutor | "Cria um instrutor: e-mail elena@example.com, palavra-passe [à sua escolha], nome completo Elena Bianchi" |
| Criar uma conta de pessoal | "Cria um membro do pessoal: nome completo Giulia Rossi, e-mail giulia@example.com, palavra-passe [à sua escolha], função Receção" |
| Gerar uma fatura | "Gera uma fatura para o pagamento que o Marco fez ontem, taxa de imposto 22%" |
| Criar uma automação de marketing | "Cria uma automação de marketing chamada Série de Boas-vindas, acionada quando um cliente é criado, com um passo de e-mail que usa o modelo E-mail de Boas-vindas" |
O assistente lê o seu pedido, faz corresponder o tipo de aula, o local, o instrutor, o cliente, a tag, a função, o pagamento/venda ou o modelo que indicou com o que já está configurado no seu estúdio, e executa a ação imediatamente assim que todos os detalhes obrigatórios estiverem claros.
O que o Modo de Ações NÃO faz
- Nunca adivinha um local, instrutor, tipo de aula, cliente, tag, função, pagamento/venda ou modelo em relação ao qual não tenha certeza. Se o seu pedido for ambíguo (por exemplo, dois instrutores com nomes semelhantes) ou faltar um detalhe, faz uma pergunta de seguimento em vez de agir sobre o que quer que seja.
- Só executa as vinte e uma ações listadas acima. Tudo o resto — criar uma nova função, desativar ou remover um membro do pessoal, editar a remuneração do pessoal, configurar definições do estúdio, editar um tipo de aula existente, e assim por diante — tem ainda de ser feito a partir dos ecrãs habituais; o assistente explicará que não o consegue fazer através do chat.
- Nunca inventa uma data, hora, nome de tag, código promocional ou qualquer outro valor. Se não conseguir perceber o que quer dizer, pede-lhe que esclareça em vez de preencher com um valor típico ou aleatório. Atribuir uma tag a um cliente exige que a tag já exista — se indicar uma tag que ainda não existe, o assistente informa-o e pergunta se a quer criar primeiro, em vez de a criar automaticamente.
- Nunca escreve por si nenhuma parte de um termo de responsabilidade. Um termo de responsabilidade é um documento real que os seus clientes assinam, pelo que o assistente só cria um quando você próprio cola o título exato e o texto completo no chat — nunca redigirá, encurtará, traduzirá nem "limpará" a redação por conta própria. Se lhe pedir para criar um termo de responsabilidade sem fornecer o texto completo, ele pede-lhe que o cole em vez de adivinhar.
- Criar uma conta de instrutor ou de pessoal usa a palavra-passe que escreve no chat, exatamente como escrita. O assistente não a gera por si. Como essa mensagem passa pelo assistente de IA como qualquer outro pedido, o texto da palavra-passe é incluído na conversa enviada ao fornecedor de IA e é mantido no seu histórico de chat local durante o período de retenção habitual (até 30 dias) — o mesmo que qualquer outra coisa que escreva no Modo de Ações. Se preferir não ter uma palavra-passe a passar pelo chat, defina ou altere a palavra-passe da conta posteriormente a partir do ecrã habitual de Instrutores ou de Pessoal.
- Criar uma conta de pessoal exige que indique uma função existente. O assistente nunca inventará uma nova função, e nunca adivinhará entre duas funções com nomes semelhantes (por exemplo, "Receção" vs. "Responsável de Receção") — se a função que indicou não existir ou corresponder a mais do que uma, ele pede-lhe que verifique o nome ou crie primeiro a função nas Configurações, em vez de escolher uma por si. Também nunca assume uma função predefinida (como Gestor) se não indicar nenhuma.
- Gerar uma fatura aponta sempre para um pagamento ou venda de produto existente — nunca para um valor introduzido manualmente. Diga ao assistente que cliente e, se necessário, que data, para que ele possa encontrar o registo exato; nunca inventa nem adivinha a que pagamento/venda se refere. Se não indicar uma taxa de imposto, usa automaticamente a taxa de IVA predefinida do seu estúdio.
- Uma automação de marketing criada através do assistente é sempre guardada em pausa. Mesmo que peça para ficar ativa de imediato, é criada num estado de pausa e não faz nada até a ativar manualmente a partir do ecrã Automações de Marketing — esta é uma medida de segurança deliberada para que o assistente nunca possa começar a enviar mensagens a clientes reais por conta própria. O modelo de mensagem de cada passo também tem de já existir; o assistente nunca inventa um novo modelo por si.
- Antes de cancelar uma reserva, emitir um cartão presente, criar uma conta de pessoal ou gerar uma fatura, descreve sempre o que está prestes a fazer e pede-lhe que confirme ("Devo prosseguir?") — nunca executa nenhuma destas quatro ações sem essa confirmação explícita, uma vez que envolvem valor monetário real, um início de sessão real ou um documento fiscal real. Todas as outras ações (criar/cancelar uma aula, reservar, fazer check-in, criar um cliente, atribuir uma assinatura, criar uma tag, atribuir uma tag, criar um código promocional, criar um produto, criar um local, criar um tipo de aula, criar um termo de responsabilidade, criar um instrutor, criar uma automação de marketing) não pedem confirmação — agem imediatamente assim que todos os detalhes obrigatórios forem inequívocos.
- Só discute o próprio Agon e os dados do seu estúdio. Recusa perguntas de cultura geral não relacionadas com o produto, mesmo que tecnicamente as pudesse responder.
Como usar
-
Abra o assistente de IA clicando no botão redondo de chat (💬) no canto inferior direito. [SCREENSHOT: The floating chat button in the bottom-right corner of the Agon desktop app]
-
No cabeçalho do painel de chat, ative o interruptor Modo de ações. [SCREENSHOT: The Action mode toggle in the chat panel header]
-
Escreva o seu pedido em linguagem natural, incluindo os detalhes aplicáveis à ação — para uma aula, são o tipo de aula, o local, o instrutor, o dia, a hora e a duração; para uma ação sobre um cliente, o nome ou e-mail do cliente; e assim por diante. Quanto mais detalhe fornecer, menos perguntas de seguimento receberá. [SCREENSHOT: An example Action Mode request typed into the chat input]
-
Prima Enviar ou Enter.
-
Se faltar algo ou algo for ambíguo, o assistente faz uma pergunta de seguimento. Responda-lhe no mesmo chat e prima Enviar novamente.
-
Depois de a ação ser executada, o assistente confirma-a com uma mensagem verde "Ação concluída" que resume o que foi feito. As exceções são cancelar uma reserva, emitir um cartão presente, criar uma conta de pessoal e gerar uma fatura: para estas quatro, o assistente pede-lhe primeiro que confirme em texto simples antes de agir. [SCREENSHOT: The green confirmation banner after an action is successfully performed]
-
O resultado aparece imediatamente no ecrã relevante — uma nova aula no Calendário, uma nova reserva ou check-in na lista de participantes da aula, um novo cliente em Clientes, uma assinatura atualizada, e assim por diante — exatamente como se a tivesse feito através do formulário habitual.
Perguntas frequentes
Pede-me para confirmar antes de agir? Apenas para cancelar uma reserva, emitir um cartão presente, criar uma conta de pessoal ou gerar uma fatura — descreve sempre o que está prestes a fazer (para uma conta de pessoal, incluindo a função exata que está prestes a conceder; para uma fatura, o pagamento/venda e a taxa de imposto) e espera que diga "sim" (ou "sì", "oui", etc.) primeiro. Todas as outras ações (criar/cancelar uma aula, reservar um cliente, fazer o check-in de alguém, criar um cliente, atribuir uma assinatura, obter um relatório, criar uma tag, atribuir uma tag, criar um código promocional, criar um produto, criar um local, criar um tipo de aula, criar um termo de responsabilidade, criar um instrutor, criar uma automação de marketing) acontecem imediatamente assim que todos os detalhes obrigatórios forem inequívocos, sem um passo de confirmação separado.
E se cometi um erro no que escrevi? O resultado é criado tal como qualquer outra coisa que faria através dos ecrãs habituais — abra a página relevante (Calendário, Clientes, Assinaturas, etc.), encontre-o e edite-o ou cancele-o da forma habitual.
Consegue criar aulas recorrentes? Ainda não — o Modo de Ações cria uma única aula agendada por pedido. Use o formulário habitual de aula recorrente no ecrã Calendário para horários repetidos.
Pode pedir algo que não esteja na lista de vinte e uma ações? Não — se pedir algo fora de criar/cancelar uma aula, reservar/cancelar uma reserva, ver uma lista de participantes, fazer o check-in de um cliente, criar um cliente, atribuir uma assinatura, obter um relatório, criar uma tag, atribuir uma tag, emitir um cartão presente, criar um código promocional, criar um produto, criar um local, criar um tipo de aula, criar um termo de responsabilidade, criar uma conta de instrutor, criar uma conta de pessoal, gerar uma fatura ou criar uma automação de marketing, o assistente explica em texto simples que não consegue fazer isso através do chat, em vez de tentar forçá-lo numa das ações existentes.
O que fazer se algo correr mal?
O interruptor do Modo de ações não aparece O Modo de Ações só está visível quando tem sessão iniciada como gestor do estúdio. Se tiver sessão iniciada como instrutor, não será apresentado.
O assistente continua a perguntar que tipo de aula / local / instrutor / cliente quero dizer Normalmente, isto significa que o nome que escreveu corresponde a mais do que um item, ou a nenhum. Verifique a ortografia exata face ao que está configurado em Tipos de Aula ou Clientes e tente novamente.
Recebo "Esta ação precisa do Agon AI, que está desativado" Nenhum provedor de IA está ligado, por isso o assistente está em modo básico e não consegue concluir a ação. Adicione a chave do seu estúdio em Configurações → Assistente de IA (consulte Como configurar o Assistente de IA) e volte a pedir.
O assistente diz que executou a ação, mas não vejo o resultado Atualize o ecrã relevante. Para uma ação sobre uma aula, verifique também se está a visualizar o local e a semana corretos no Calendário.