Sessy AI — utilização, créditos e BYOK
Configure o Sessy AI na app: consultas de plataforma, packs de créditos, chave Opper própria (BYOK), escolha de modelo, privacidade e conformidade.
Abra Configuração → Sessy AI na app de administração. Esta secção cobre como o seu ginásio usa IA no Sessy: utilização mensal, packs de créditos opcionais, a sua conta Opper (BYOK) e acesso MCP externo.
Como toda a funcionalidade Sessy, o Sessy AI está incluído na licença — o uso básico não tem custo extra. Como o uso intensivo de IA pode ser caro e queremos manter os preços o mais baixos possível, existe um limite mensal nas consultas in-app incluídas. Se precisar de mais, pode comprar packs de créditos através do Sessy. Também pode trazer a sua própria IA (BYOK) e usá-la no Sessy, com controlo total sobre custos, onde os dados são processados e que modelos utiliza.
O assistente in-app (chat na app Sessy) é separado dos agentes de IA externos ligados via tokens MCP.
Nesta página
- Como funciona a faturação do Sessy AI
- Comprar créditos de consultas
- Usar a sua própria chave Opper (BYOK)
- Escolher um modelo — privacidade e conformidade
- Nível de raciocínio e tokens de saída máx.
- Acesso externo (MCP)
- Consultas incluídas e créditos comprados
1. Como funciona a faturação do Sessy AI
Modo plataforma (predefinido)
O Sessy aloja a IA para o seu ginásio. Cada mês recebe uma quota incluída de consultas do assistente in-app. Quando se esgota, o assistente pode continuar se tiver comprado packs de créditos (ver abaixo).
A utilização aparece no topo em Configuração → Sessy AI → Utilização.
Modo BYOK
Com Usar a sua própria chave Opper ativado, as consultas passam pela sua conta Opper e faturação. As consultas incluídas da plataforma e os packs de créditos deixam de se aplicar à IA in-app — paga diretamente à Opper.
Pode voltar ao modo plataforma a qualquer momento desativando o BYOK na mesma secção.
2. Comprar créditos de consultas
Os packs de créditos são compras únicas que adicionam consultas extra à quota mensal incluída. Só estão disponíveis se:
- a licença do ginásio estiver ativa, e
- estiver em modo plataforma (BYOK desativado)
Para comprar:
- Abra Configuração → Sessy AI → Comprar créditos de consultas
- Escolha um pack (+100, +500 ou +2000 consultas)
- Conclua o pagamento no Stripe Checkout (mesmo cliente da licença)
Os créditos são adicionados automaticamente após o pagamento. Não expiram enquanto a licença permanecer ativa.
3. Usar a sua própria chave Opper (BYOK)
Use quando quiser controlo total sobre modelos, regiões e faturação Opper.
Passos de configuração
- Crie uma conta e chave API em platform.opper.ai
- Na Opper, anote o slug do modelo que pretende (por exemplo
azure/…para modelos alojados na UE) - No Sessy: Configuração → Sessy AI → Usar a sua própria chave Opper
- Cole a sua chave API Opper, introduza o slug do modelo, ajuste opcionalmente o nível de raciocínio e tokens de saída máx.
- Toque Testar ligação, depois Guardar e ativar BYOK
A sua chave API é encriptada no armazenamento Sessy. Os pedidos de inferência vão para a Opper com a sua chave — não com a chave de plataforma do Sessy.
Pesquisa de modelos
Quando o Sessy pode carregar modelos Opper para a sua chave, o campo modelo oferece sugestões de pesquisa enquanto escreve. Pode sempre introduzir qualquer slug manualmente.
Teste a ligação após alterar o modelo ou o nível de raciocínio.
Documentação oficial Opper
4. Escolher um modelo — privacidade e conformidade
É responsável por escolher modelos e fornecedores que cumpram as políticas do ginásio e as obrigações legais (incluindo o RGPD e outras regras locais de privacidade e segurança).
Perguntas antes de ativar BYOK ou uso intensivo de IA
| Tópico | O que verificar |
|---|---|
| Tool calling | O Sessy AI in-app usa ferramentas (reservas, horário, sócios, etc.). Escolha um modelo que suporte tool calling de forma fiável com o Sessy — teste com Testar ligação antes de ativar BYOK em produção. |
| Treino | Alguns fornecedores podem usar prompts ou respostas para treinar modelos futuros salvo opt-out ou plano enterprise / sem treino. Consulte os termos da Opper e do fornecedor do modelo. |
| Retenção e logs | Os fornecedores podem conservar pedidos, respostas ou logs para monitorização de abuso, faturação ou suporte. Compreenda os prazos de retenção e se pode limitar ou desativar logging. |
| Localização de dados | Onde processa o fornecedor os dados? Prefira UE ou outras regiões alinhadas com os sócios e o DPA. |
| Subprocessadores | A Opper encaminha para Azure, OpenAI ou outros backends para o slug escolhido? Leia os termos da Opper e do fornecedor subjacente. |
| Dados de sócios | O Sessy AI in-app pode acessar dados do ginásio via ferramentas (horário, sócios, etc.). Ative BYOK só se o modelo e a região são aceitáveis para esses dados. |
| Contratos | Precisa de um DPA com a Opper ou o fornecedor cloud? Pode ser necessária conta business. |
| Política interna | Algumas organizações excluem certos fornecedores ou exigem aprovação para «raciocínio extendido» ou saídas com muitos tokens. |
Orientação prática
- Prefira slugs orientados à UE (por exemplo
azure/…) para sócios na UE. - Use o modo plataforma se quiser uma stack gerida pelo Sessy sem gerir a Opper.
- Use tokens MCP limitados (não BYOK) quando ferramentas externas não devem receber dados de sócios — ver Ligar agente IA.
- Em caso de dúvida, consulte o seu assessor jurídico ou de privacidade antes de ligar dados de sócios em produção.
O Sessy não certifica modelos de terceiros para a sua jurisdição. Disponibilidade e encaminhamento podem mudar na Opper sem aviso.
5. Nível de raciocínio e tokens de saída máx.
Estas definições aplicam-se apenas ao BYOK na app Sessy.
Nível de raciocínio (opcional)
Predefinido: Desativado. Deixe o raciocínio desativado salvo motivo específico.
| Nível | Quando usar |
|---|---|
| Desativado (predefinido) | Recomendado para uso in-app normal. Funciona melhor com o assistente de ferramentas do Sessy (reservas, horário, sócios). |
| Baixo / Médio / Alto | Pode melhorar o raciocínio em alguns modelos. Nem todos os modelos suportam raciocínio com ferramentas — pode ver erros do fornecedor. Volte a Desativado e teste de novo. |
Tokens de saída máx.
Controla o comprimento máximo de uma resposta do modelo. O valor predefinido (4096) é adequado para a maioria das tarefas de administração. Valores muito altos podem aumentar custo e latência na sua conta Opper.
6. Acesso externo (MCP)
O cartão Acesso externo (MCP) na mesma secção Sessy AI é onde cria tokens de agente para Claude, Cursor, ChatGPT e outras ferramentas compatíveis com MCP.
É separado dos limites de consultas in-app:
- Créditos de plataforma e BYOK aplicam-se apenas ao assistente in-app.
- Tokens MCP servem para ligar assistentes e ferramentas de IA externos.
Para configuração e instruções de acesso externo: Ligar agente IA e Competências do agente IA.
7. Consultas incluídas e créditos comprados
Em modo plataforma, o ginásio tem duas reservas separadas para consultas do assistente in-app:
| Reserva | O que é | Reinicia? |
|---|---|---|
| Consultas mensais incluídas | 50 consultas por mês civil (incluídas na licença) | Sim — no dia 1 de cada mês |
| Créditos comprados | Consultas extra dos packs (+100, +500 ou +2000) | Não — mantêm-se até serem usados |
O cartão Utilização mostra ambos: consultas incluídas usadas este mês, consultas incluídas restantes, saldo de créditos comprados e total de consultas disponíveis (incluídas restantes + créditos comprados).
Qual reserva é usada primeiro?
As consultas incluídas são sempre usadas primeiro. Os créditos comprados só são deduzidos depois de usar todas as consultas incluídas do mês atual.
Exemplo: se usou 12 de 50 consultas incluídas este mês e tem 800 créditos comprados, cada nova consulta continua a contar para as suas 38 consultas incluídas restantes. Os créditos comprados ficam guardados até ultrapassar 50 consultas nesse mês.
O que conta como uma consulta?
Uma resposta bem-sucedida do assistente na app conta como uma consulta. Tentativas falhadas (por exemplo erros de rede ou bloqueios antes de uma resposta) não consumem consultas.
Quando o mês muda
Num novo mês civil, a quota incluída reinicia para 50 (ou o valor configurado no plano). Os créditos comprados não reiniciam — qualquer saldo restante passa para o mês seguinte.
Quando ambos estão vazios
Se usou todas as consultas incluídas e não tem créditos comprados, o assistente in-app fica bloqueado até ao mês seguinte ou até comprar mais créditos. Também pode mudar para BYOK ou usar acesso MCP externo.
8. Limites de velocidade e escrita (in-app)
O assistente in-app usa os mesmos limites de segurança dos tokens MCP, mas por ginásio (não por utilizador):
| Limite | Valor |
|---|---|
| Pedidos de chat | 60 por minuto por ginásio |
| Alterações confirmadas (mutações) | 30 por minuto e 500 por dia (UTC) por ginásio |
| Alterações confirmadas por mês | 200 por mês civil por ginásio |
Uma ação em lote (por exemplo planear uma semana recorrente completa ou uma atualização em massa) conta como uma escrita.
Se atingir um limite, aguarde um minuto ou tente mais tarde. Para automação intensiva, use acesso MCP externo com um token de agente dedicado.