Passa al contenuto principale

Come attivare l'AI Assistant

Questa guida ti accompagna nell'ottenere una chiave API Gemini da Google AI Studio e collegarla ad Agon, per sbloccare l'Assistente IA di supporto e la Modalità Azione IA.

Prima di iniziare​

  • L'AI Assistant è disponibile solo sul piano AI Assistant (un componente aggiuntivo del tuo abbonamento). Se il tuo studio è sul piano base, le Impostazioni mostreranno un invito all'upgrade invece del form di configurazione — vedi i Termini di servizio per i dettagli sulla fatturazione.
  • Ti serve un account Google per creare una chiave API Gemini. È separato dal tuo account Agon.
  • Solo lo studio manager può configurare l'AI Assistant.
  • Leggi la sezione Privacy e uso dei dati più sotto prima di attivarlo — spiega cosa esce dalla tua macchina e perché, con i link alla guida GDPR completa.

Passaggi​

  1. Vai su Google AI Studio e accedi con il tuo account Google. [SCREENSHOT: La homepage di Google AI Studio con il pulsante di accesso]

  2. Crea una nuova chiave API. Google AI Studio ha un livello gratuito con una quota giornaliera generosa — non serve inserire un metodo di pagamento per iniziare. [SCREENSHOT: Il pulsante "Create API key" e la chiave generata]

  3. Copia la chiave. Trattala come una password — chiunque abbia questa chiave può fare richieste addebitate al tuo account Google.

  4. In Agon, apri Impostazioni e trova la sezione AI Assistant. [SCREENSHOT: La sezione AI Assistant nella pagina Impostazioni di Agon]

  5. Incolla la tua chiave nel campo previsto e salva.

  6. Agon verifica immediatamente la chiave e conferma se è valida. Una volta verificata, l'Assistente IA di supporto diventa disponibile in tutta l'app, e puoi facoltativamente attivare la Modalità Azione IA.

Se prevedi un uso intenso — attiva la fatturazione Google​

Il livello gratuito è sufficiente per la maggior parte degli studi, ma ha un limite giornaliero di richieste condiviso da tutto ciò che usa quella chiave. Se il tuo studio è grande o attivi la Modalità Azione IA nelle ore di punta e prevedi di superare la quota gratuita:

  1. In Google AI Studio, apri il progetto Google Cloud associato alla chiave API.
  2. Attiva la fatturazione per quel progetto e collega un metodo di pagamento, seguendo le istruzioni a schermo di Google.
  3. Una volta attivata la fatturazione, la stessa chiave passa automaticamente ai limiti di utilizzo del livello a pagamento — non serve generare una nuova chiave o riconfigurare nulla in Agon.

Google ti addebita direttamente qualsiasi utilizzo oltre il livello gratuito; Agon non applica alcun ricarico né rivende questo utilizzo.

Privacy e uso dei dati​

Il fatto che la tua chiave API sia sul livello gratuito o sul livello a pagamento cambia cosa fa Google con i tuoi dati, e questo ha implicazioni GDPR per il tuo studio:

  • Livello gratuito: secondo i termini di Google per il livello gratuito dell'API Gemini, i prompt e le risposte possono essere usati da Google per migliorare i propri prodotti, il che può includere una revisione umana. Questo significa che le domande dei clienti o i dati inclusi in un prompt (ad esempio, se un manager incolla i dettagli di un cliente in una domanda di supporto) potrebbero essere visti da Google in questo processo.
  • Livello a pagamento (fatturazione attiva): secondo i termini di Google per l'utilizzo a pagamento, i prompt e le risposte non vengono usati per addestrare i modelli di Google e sono gestiti secondo i termini standard di Google per il trattamento dati dell'API a pagamento.

Poiché i dati dei clienti di Agon vivono localmente sulla tua macchina (vedi Benvenuto in Agon), l'unico dato che raggiunge il fornitore IA è quello incluso in un messaggio di chat che tu o il tuo cliente scrivete all'assistente, oppure ciò di cui una richiesta in Modalità Azione IA ha bisogno per risolvere una richiesta di pianificazione. Evita di incollare dati sensibili dei clienti nella chat se sei sul livello gratuito e non hai valutato le implicazioni.

Se sei soggetto al GDPR, usare un fornitore IA di terze parti per trattare dati personali significa che quel fornitore è un subresponsabile del trattamento del tuo studio. Leggi la Guida GDPR per gli studio manager prima di attivare l'AI Assistant, e valuta di attivare la fatturazione (livello a pagamento) se prevedi che staff o clienti facciano riferimento a dati personali nelle conversazioni con l'IA.

Cosa fare se qualcosa va storto?​

Agon dice che la mia chiave non è valida Controlla di aver copiato l'intera chiave senza spazi extra. Assicurati che la chiave non sia stata eliminata o rigenerata in Google AI Studio. Se l'hai appena creata, attendi un minuto e riprova a salvare — le nuove chiavi possono impiegare un po' di tempo per attivarsi.

Ricevo continuamente errori di limite di frequenza (rate limit) Probabilmente stai raggiungendo la quota giornaliera del livello gratuito. Attiva la fatturazione sul progetto Google Cloud della chiave (vedi sopra) per passare ai limiti del livello a pagamento.

Non vedo la sezione AI Assistant nelle Impostazioni Il tuo studio è sul piano base, che non include l'AI Assistant. Contattaci per l'upgrade — vedi i Termini di servizio.

Voglio smettere di usare l'AI Assistant Rimuovi la chiave dalla sezione AI Assistant nelle Impostazioni. Questo disattiva immediatamente l'Assistente IA di supporto e la Modalità Azione IA; nient'altro in Agon viene influenzato.

Pagine correlate​