Assistente AI di supporto
Questa guida spiega come usare l'assistente AI integrato per ottenere risposte immediate su come funziona Agon, senza uscire dall'app.
Prima di iniziare
L'assistente è accessibile da ogni schermata dell'applicazione. Per ottenere risposte in linguaggio naturale, collegalo a un provider AI con la chiave del tuo studio (una chiave gratuita di Google Gemini si crea in circa 3 minuti) oppure a un modello locale — vedi Come configurare l'Assistente AI.
Senza un provider AI, l'assistente funziona in modalità base: scrivi qualche parola chiave e ti mostra gli articoli della documentazione più pertinenti. Quando non trova una corrispondenza valida per quello che hai scritto — o saluti semplicemente — ti mostra invece un menu di argomenti da esplorare: clicca una categoria, poi una sottocategoria, poi una pagina (e, su una pagina con più sezioni, la sezione specifica) per trovare quello che cerchi senza dover indovinare le parole chiave giuste. La modalità base funziona interamente sul tuo computer e non può rispondere a domande libere né dare consigli sul business.
Cosa fa l'assistente AI
L'assistente AI risponde alle tue domande su Agon in linguaggio naturale. Puoi chiedergli cose come:
- "Come cancello una lezione?"
- "Cosa succede ai crediti di un cliente quando cancello una prenotazione?"
- "Come esporto un report?"
- "Come configuro un abbonamento ricorrente?"
Conosce tutto ciò che è trattato in questa documentazione: lezioni, prenotazioni, abbonamenti, check-in, report, pagamenti, impostazioni e altro. Risponde nella lingua in cui scrivi.
Cosa NON fa l'assistente AI
Di default, l'assistente risponde solo alle domande: non modifica mai i tuoi dati.
In particolare, non:
- Crea o modifica profili dei clienti
- Elabora pagamenti o cambia i piani di abbonamento
- Accede ai dati personali dei tuoi clienti
- Elimina dati
Se gli chiedi di eseguire una di queste azioni, ti spiega come farla da solo.
Eccezione: gli studio manager possono attivare la Modalità azioni AI per permettere all'assistente di eseguire un insieme definito di azioni reali a partire da una richiesta in linguaggio naturale: creare o cancellare una lezione, prenotare o fare il check-in di un cliente, creare un cliente, assegnare un abbonamento o ottenere un report. È una funzione da attivare esplicitamente, disponibile solo per l'account dello studio manager — consulta la guida Modalità azioni AI per l'elenco completo e per ciò che non può fare.
Domande da consulente di business
Gli studio manager possono anche fare all'assistente domande di analisi sul proprio studio, non solo domande del tipo "come faccio". Ad esempio:
- "Quando prenotano di più i miei clienti?"
- "Il prezzo del mio abbonamento Premium è giusto?"
- "Chi sono i miei clienti migliori e cosa fanno di diverso?"
- "Quanto sono solidi i miei ricavi?"
L'assistente risponde usando i dati aggregati reali del tuo studio — prenotazioni per ora/giorno e tipo di lezione, prezzi e adesione degli abbonamenti, comportamento della coorte dei clienti che spendono di più, andamento e concentrazione dei ricavi — e basa la risposta su quei numeri reali. Non inventa mai un numero, un orario di punta o una raccomandazione di prezzo.
Si tratta solo di consigli. L'assistente non può cambiare un prezzo né intraprendere alcuna azione in base a questi consigli: può solo dirti cosa vede e suggerirti cosa valutare. Se decidi di seguire il suo consiglio, vai tu stesso nella schermata pertinente (Abbonamenti, Report o Approfondimenti) e fai la modifica lì.
Le stesse quattro aree di cui l'assistente può parlare — andamento delle prenotazioni, prezzi, clienti che spendono di più e solidità dei ricavi — sono sempre visibili anche come dashboard permanente nella pagina Approfondimenti, quindi non serve fare una domanda per vederle.
Come usarlo
-
Clicca il pulsante rotondo della chat (💬) nell'angolo in basso a destra dello schermo. [SCREENSHOT: Il pulsante flottante della chat nell'angolo in basso a destra dell'app desktop Agon]
-
Si apre un pannello di chat intitolato "Agon AI Supporto", appena sopra il pulsante, nell'angolo in basso a destra. [SCREENSHOT: Il pannello di chat del supporto AI aperto, con il messaggio di benvenuto]
-
Scrivi la tua domanda nella casella di testo in fondo al pannello. Scrivi in linguaggio naturale: non servono comandi o parole chiave speciali. [SCREENSHOT: La casella di testo con una domanda di esempio]
-
Premi Invia oppure Invio sulla tastiera per inviare la domanda.
-
L'assistente risponde in pochi secondi. Se la domanda non è chiara, può farti una domanda di chiarimento per aiutarti meglio. [SCREENSHOT: Un esempio di domanda e risposta nel pannello di chat]
-
Per chiudere il pannello, clicca sulla × in alto nel pannello, oppure clicca di nuovo il pulsante della chat.
Domande frequenti
Che lingue parla? L'assistente risponde nella stessa lingua in cui scrivi. Se scrivi in italiano, risponde in italiano. Se scrivi in spagnolo, risponde in spagnolo. Supporta tutte le lingue principali.
Ha memoria tra una sessione e l'altra? All'interno della stessa chat, sì: riaprila dall'elenco delle chat a sinistra e continua — l'assistente ha ancora tutto ciò che è stato detto prima in quella chat. Cliccando Nuova Chat riparte da zero, senza memoria di nessun'altra conversazione. Le chat che lasci attive restano disponibili indefinitamente; solo una chat che hai archiviato esplicitamente viene eliminata, e solo dopo 30 giorni nell'archivio.
Cosa succede se dà una risposta sbagliata? L'assistente trae le sue conoscenze da questa documentazione. Se dà una risposta che non corrisponde a ciò che vedi nell'app, fidati di ciò che vedi nell'app. Puoi anche porre la domanda in modo diverso: a volte riformularla aiuta. Se ritieni che la risposta sia sistematicamente sbagliata, scrivi a support@agon-studio.dev così la documentazione può essere aggiornata.
Può aiutarmi con problemi non trattati nella documentazione? Le conoscenze dell'assistente si limitano alla documentazione di Agon. Per problemi al di fuori di questo ambito — come problemi di rete o errori del sistema operativo — scrivi a support@agon-studio.dev (vedi Feedback e supporto).
Cosa fare se qualcosa va storto?
L'assistente mostra solo articoli di aiuto invece di rispondere Nessun provider AI è collegato, quindi l'assistente è in modalità base. Aggiungi la chiave del provider del tuo studio in Impostazioni → Assistente AI — vedi Come configurare l'Assistente AI.
L'assistente dice che il mio provider AI sta limitando le richieste La chiave del tuo provider ha raggiunto il limite. Attendi un minuto e riprova, oppure aumenta i limiti presso il provider — vedi Se prevedi un uso intenso.
L'assistente non risponde dopo che premo Invia Controlla la connessione internet: un provider AI nel cloud (Gemini o Groq) ne ha bisogno. Con un modello locale, controlla che Ollama sia in esecuzione. Se è tutto a posto, prova a chiudere e riaprire il pannello di chat.
Il pannello di chat non si apre quando clicco sul pulsante Prova a riavviare l'applicazione Agon. Se il problema persiste, verifica che il servizio backend di Agon sia in esecuzione. Su macOS puoi farlo chiudendo completamente Agon e riaprendolo dalla cartella Applicazioni.
L'assistente dice di non trovare informazioni sulla mia domanda L'assistente abbina la tua domanda a questa documentazione in base al significato, non solo alle parole chiave esatte, quindi di solito non serve riformulare — ma se non trova comunque nulla di pertinente, prova a chiedere della funzione specifica per nome (ad esempio "come creo un abbonamento" invece di "come imposto un piano"). Prova anche a chiedere direttamente del prodotto Agon: l'assistente risponde solo a domande su Agon e rifiuta domande di cultura generale non pertinenti.