Sessy AI — utilizzo, crediti e BYOK
Configura Sessy AI nell'app: query piattaforma, pacchetti crediti, chiave Opper personale (BYOK), scelta del modello, privacy e conformità.
Apri Configurazione → Sessy AI nell’app admin. Questa sezione copre come la tua palestra usa l’IA in Sessy: utilizzo mensile, pacchetti crediti opzionali, il tuo account Opper (BYOK) e accesso MCP esterno.
Come tutte le funzionalità Sessy, Sessy AI è incluso nella licenza — l’uso di base non ha costi extra. Poiché un uso intensivo dell’IA può essere costoso e vogliamo mantenere i prezzi il più bassi possibile, c’è un limite mensile sulle query in-app incluse. Se ne servono di più, puoi acquistare pacchetti crediti tramite Sessy. Puoi anche portare la tua IA (BYOK) e usarla in Sessy, con pieno controllo su costi, dove vengono elaborati i dati e quali modelli usi.
L’assistente in-app (chat nell’app Sessy) è separato dagli agenti IA esterni collegati tramite token MCP.
In questa pagina
- Come funziona la fatturazione di Sessy AI
- Acquistare crediti query
- Usa la tua chiave Opper (BYOK)
- Scegliere un modello — privacy e conformità
- Livello di ragionamento e token di output max
- Accesso esterno (MCP)
- Query incluse e crediti acquistati
1. Come funziona la fatturazione di Sessy AI
Modalità piattaforma (predefinita)
Sessy ospita l’IA per la tua palestra. Ogni mese ricevi una quota inclusa di query per l’assistente in-app. Quando è esaurita, l’assistente può ancora funzionare se hai acquistato pacchetti crediti (vedi sotto).
L’utilizzo è mostrato in alto in Configurazione → Sessy AI → Utilizzo.
Modalità BYOK
Con Usa la tua chiave Opper attivato, le query passano tramite il tuo account Opper e la sua fatturazione. Le query piattaforma incluse e i pacchetti crediti non si applicano più all’IA in-app — paghi Opper direttamente.
Puoi tornare alla modalità piattaforma in qualsiasi momento disattivando BYOK nella stessa sezione.
2. Acquistare crediti query
I pacchetti crediti sono acquisti una tantum che aggiungono query bonus oltre la quota mensile inclusa. Disponibili solo se:
- la licenza della palestra è attiva, e
- sei in modalità piattaforma (BYOK disattivato)
Per acquistare:
- Apri Configurazione → Sessy AI → Acquista crediti query
- Scegli un pacchetto (+100, +500 o +2000 query)
- Completa il pagamento in Stripe Checkout (stesso cliente della licenza)
I crediti vengono aggiunti automaticamente dopo il pagamento. Non scadono finché la licenza resta attiva.
3. Usa la tua chiave Opper (BYOK)
Usalo quando vuoi pieno controllo su modelli, regioni e fatturazione Opper.
Passaggi di configurazione
- Crea un account e una chiave API su platform.opper.ai
- In Opper, annota lo slug del modello che vuoi (ad es.
azure/…per modelli ospitati in UE) - In Sessy: Configurazione → Sessy AI → Usa la tua chiave Opper
- Incolla la tua chiave API Opper, inserisci lo slug del modello, regola opzionalmente livello di ragionamento e token di output max
- Tocca Test connessione, poi Salva e attiva BYOK
La tua chiave API è crittografata nello storage Sessy. Le richieste di inferenza vanno a Opper con la tua chiave — non con la chiave piattaforma di Sessy.
Ricerca modelli
Quando Sessy può caricare i modelli Opper per la tua chiave, il campo modello offre suggerimenti di ricerca mentre digiti. Puoi sempre inserire manualmente qualsiasi slug.
Testa la connessione dopo ogni modifica di modello o livello di ragionamento.
Documentazione ufficiale Opper
4. Scegliere un modello — privacy e conformità
Sei responsabile della scelta di modelli e provider conformi alle policy della palestra e agli obblighi legali (incluso il GDPR e altre norme locali su privacy e sicurezza).
Domande prima di attivare BYOK o un uso intensivo dell’IA
| Argomento | Cosa verificare |
|---|---|
| Tool calling | Sessy AI in-app usa strumenti (prenotazioni, calendario, iscritti, ecc.). Scegli un modello che supporti il tool calling in modo affidabile con Sessy — testa con Test connessione prima di attivare BYOK in produzione. |
| Training | Alcuni provider possono usare prompt o output per addestrare modelli futuri salvo opt-out o piano enterprise / no-training. Controlla i termini di Opper e del provider del modello. |
| Retention e log | I provider possono conservare richieste, risposte o log per monitoraggio abusi, fatturazione o supporto. Comprendi i periodi di retention e se puoi limitare o disattivare il logging. |
| Ubicazione dati | Dove elabora i dati il provider? Preferisci UE o altre regioni allineate agli iscritti e al DPA. |
| Sub-responsabili | Opper instrada verso Azure, OpenAI o altri backend per lo slug scelto? Leggi i termini di Opper e del provider sottostante. |
| Dati iscritti | Sessy AI in-app può accedere ai dati della palestra tramite strumenti (calendario, iscritti, ecc.). Attiva BYOK solo se modello e regione sono accettabili per tali dati. |
| Contratti | Serve un DPA con Opper o il cloud provider? Potrebbe essere richiesto un account business. |
| Policy interna | Alcune organizzazioni escludono certi provider o richiedono approvazione per «extended thinking» o output ad alto volume di token. |
Indicazioni pratiche
- Preferisci slug orientati UE (ad es.
azure/…) per iscritti in UE. - Usa la modalità piattaforma se vuoi un stack gestito da Sessy senza gestire Opper da solo.
- Usa token MCP limitati (non BYOK) quando gli strumenti esterni non devono ricevere dati iscritti — vedi Collega agente IA.
- In caso di dubbio, consulta il tuo consulente legale o privacy prima di collegare dati iscritti in produzione.
Sessy non certifica modelli di terze parti per la tua giurisdizione. Disponibilità e routing possono cambiare lato Opper senza preavviso.
5. Livello di ragionamento e token di output max
Queste impostazioni si applicano solo al BYOK nell’app Sessy.
Livello di ragionamento (opzionale)
Predefinito: Disattivato. Lascia il ragionamento disattivato salvo motivo specifico.
| Livello | Quando usarlo |
|---|---|
| Disattivato (predefinito) | Consigliato per uso in-app normale. Funziona meglio con l’assistente strumenti di Sessy (prenotazioni, calendario, iscritti). |
| Basso / Medio / Alto | Può migliorare il ragionamento su alcuni modelli. Non tutti i modelli supportano il ragionamento con strumenti — potresti vedere errori del provider. Rimetti su Disattivato e riprova. |
Token di output max
Controlla la lunghezza massima di una risposta del modello. Il valore predefinito (4096) è adatto alla maggior parte delle attività admin. Valori molto alti possono aumentare costi e latenza sul tuo account Opper.
6. Accesso esterno (MCP)
La scheda Accesso esterno (MCP) nella stessa sezione Sessy AI è dove crei token agente per Claude, Cursor, ChatGPT e altri strumenti compatibili MCP.
È separato dai limiti di query in-app:
- Crediti piattaforma e BYOK si applicano solo all’assistente in-app.
- I token MCP servono per collegare assistenti e strumenti IA esterni.
Per configurazione e istruzioni sull’accesso esterno: Collega agente IA e Competenze dell’agente IA.
7. Query incluse e crediti acquistati
In modalità piattaforma, la palestra ha due riserve separate per le query dell’assistente in-app:
| Riserva | Cosa è | Si resetta? |
|---|---|---|
| Query mensili incluse | 50 query per mese di calendario (incluse nella licenza) | Sì — il 1° di ogni mese |
| Crediti acquistati | Query bonus dai pacchetti (+100, +500 o +2000) | No — restano fino all’uso |
La scheda Utilizzo mostra entrambi: query incluse usate questo mese, query incluse rimanenti, saldo crediti acquistati e totale query disponibili (incluse rimanenti + crediti acquistati).
Quale riserva viene usata per prima?
Le query incluse vengono sempre usate per prime. I crediti acquistati si scalano solo dopo aver usato tutte le query incluse del mese corrente.
Esempio: se hai usato 12 su 50 query incluse questo mese e hai 800 crediti acquistati, ogni nuova query conta ancora sulle tue 38 query incluse rimanenti. I crediti acquistati restano in riserva finché non superi 50 query in quel mese.
Cosa conta come una query?
Una risposta riuscita dell’assistente nell’app conta come una query. I tentativi falliti (ad es. errori di rete o blocchi prima di una risposta) non consumano query.
Al cambio mese
In un nuovo mese di calendario, la quota inclusa si resetta a 50 (o l’importo configurato per il piano). I crediti acquistati non si resettano — qualsiasi saldo restante passa al mese successivo.
Quando entrambi sono esauriti
Se hai usato tutte le query incluse e non hai più crediti acquistati, l’assistente in-app è bloccato fino al mese successivo o finché non acquisti altri crediti. Puoi anche passare al BYOK o usare l’accesso MCP esterno.
8. Limiti di velocità e scrittura (in-app)
L’assistente in-app usa gli stessi limiti di sicurezza dei token MCP, ma per palestra (non per utente):
| Limite | Valore |
|---|---|
| Richieste chat | 60 al minuto per palestra |
| Modifiche confermate (mutazioni) | 30 al minuto e 500 al giorno (UTC) per palestra |
| Modifiche confermate al mese | 200 per mese di calendario per palestra |
Un’azione batch (ad es. pianificare una settimana ricorrente completa o un aggiornamento massivo) conta come una scrittura.
Se raggiungi un limite, attendi un minuto o riprova più tardi. Per automazione intensiva, usa l’accesso MCP esterno con un token agent dedicato.