Competências do agente IA

O que o seu assistente de IA ligado sabe sobre o seu ginásio e o que pode pedir-lhe.

Quando liga Claude, Cursor, ChatGPT ou outra ferramenta de IA ao Sessy, o servidor partilha automaticamente guias integrados que ensinam o assistente como o seu ginásio funciona — tipos de sessão, localizações, regras de marcação e mais. Não precisa de colar instruções longas nem explicar o Sessy do zero.

Ainda não ligou? Comece em Ligar agente IA.

O que pode pedir

Fale em linguagem natural. São exemplos — a sua formulação pode ser diferente.

Planear e gerir aulas

• «Verifica o horário da próxima semana e adiciona as aulas em falta.»
• «Muda a aula de amanhã das 18:00 para as 19:00.»
• «Cancela a sessão de sexta-feira ao meio-dia.»
• «Atribui [treinador] ao WOD de segunda-feira.»
• «Configura uma aula recorrente terça/quinta às 18:00.»
• «Agenda as sessões recorrentes para [localização] na próxima semana.»
• «Preenche o horário da próxima semana no Lumina Spa a partir do horário recorrente.»

Horário semanal recorrente

A Sessy separa duas coisas (ver Horário semanal):

• Horário recorrente — o seu padrão semanal habitual (ex.: todas as segundas às 6:00 WOD)
• Calendário de sessões — as aulas reais em que os membros podem marcar

Quando pede para agendar sessões recorrentes para uma semana, o assistente deve usar o seu horário recorrente — o mesmo que Calendário → Ações em lote → Agendar na app — e não copiar uma semana antiga aula a aula. Isso evita erros e os limites de escrita MCP (30 mutações por minuto).

Para remover uma aula do horário recorrente, peça para eliminar esse modelo recorrente. Isso não remove sessões já no calendário — cancele-as separadamente se necessário.

Para aulas pontuais que não estão no modelo, ainda pode pedir para adicionar ou alterar uma única sessão.

Inscrever membros

• «Inscreve [membro] na aula de amanhã às 7:00.»
• «Anula a inscrição de [membro] na sessão de hoje à noite.»

O assistente segue as mesmas regras de subscrição e capacidade que quando marca manualmente na app.

Programming

• «Define o programming de amanhã — strength A, metcon B.»
• «Copia o WOD de terça-feira passada para esta terça-feira.»
• «Programa Fran na aula de amanhã às 18:00 para os membros poderem registar resultados.»

Para registo de resultados, o assistente deve ligar um workoutId real da biblioteca de workouts (benchmarks globais como Fran/Murph, ou um workout próprio do ginásio) — só texto não chega.

Enviar mensagens

• «Envia um push a todos os que treinaram hoje.»
• «Informa todos os membros sobre o horário de férias.»
• «Publica um banner geral sobre o open gym de sábado.»
• «Redige um rascunho de newsletter sobre o nosso desafio de verão.»

Os rascunhos de newsletter devem usar HTML no campo content (títulos, parágrafos, listas) — texto simples aparece como um bloco sem formatação no editor. O assistente deve formatar já na primeira versão.

Mensagens em massa a todos os membros ou publicar uma newsletter são sensíveis — use apenas ferramentas de IA de confiança.

Notas e tags

• «Adiciona uma nota em [membro]: precisa de scaling nos agachamentos.»
• «Etiqueta [membro] como competition team.»

Consultar informação

• «Quem treinou junto com mais frequência este mês?»
• «Mostra a assiduidade de [membro] nos últimos 30 dias.»
• «Qual foi a receita do mês passado?»
• «O que há agora na loja?»

Configuração do ginásio (apenas Admins)

Com um token Admin também pode pedir alterações de configuração:

• «Adiciona um novo tipo de sessão chamado Hyrox.»
• «Cria uma subscrição de 10 visitas.»
• «Adiciona uma barra de proteína à loja.»
• «Define uma etiqueta de membro para foundations course.»

Tokens de funcionário não podem alterar definições globais do ginásio (localizações, tipos de sessão, subscrições, estrutura da loja). O seu Admin cria o token e escolhe o nível de acesso.

Como sabe o que fazer?

O Sessy inclui guias para tarefas comuns — planeamento, marcações, mensagens, programming, relatórios e (para Admins) configuração. Um cliente de IA capaz carrega-as ao ligar, para o assistente já conhecer as regras do Sessy antes da sua primeira pergunta.

Não precisa de memorizar nomes técnicos. Descreva simplesmente o resultado que quer.

Dicas

• Seja específico quando ajuda — datas, nomes e horários reduzem idas e vindas.
• Mesmas regras que a app — tipos de sessão desconhecidos, aulas cheias e problemas de subscrição são tratados como no Sessy.
• Proteja o token — quem o tiver pode agir como você no ginásio. Revogue-o em Configuração → Tokens do agente IA se se perder.