Come impostare le chiavi API di Gemini per Discourse AI
Introduzione
Questo argomento spiega come impostare la chiave API di Google Gemini con un progetto di account Google Cloud esistente. Gemini non è un servizio gratuito, pertanto è necessario assicurarsi di aver configurato la fatturazione nell’amministrazione di Google Cloud.
Ci sono alcune informazioni importanti con link nella pagina di generazione delle chiavi di Gemini Developer studio a riguardo:
Ok, iniziamo!
NOTA: È necessario disporre dell’accesso a livello di amministratore a Google Cloud e al forum di Discourse.
Passaggio 1: Configurazione di un progetto Google Cloud
Impostare correttamente una chiave API Gemini richiede l’accesso amministrativo all’account Google Cloud e la creazione di un progetto di fatturazione che è possibile utilizzare per l’utilizzo della chiave API Gemini.
È possibile creare la chiave in Gemini Studio e connettersi a Google Cloud, ma è leggermente più semplice eseguire tutto dalla console di Google Cloud in modo da non dover andare avanti e indietro.
Vai all’ amministrazione di Google Cloud per le API per la tua organizzazione e assicurati di essere nell’organizzazione principale (puoi vederla nel campo in alto accanto al logo di Google Cloud).
Dovrai creare un progetto per la tua chiave Gemini se non ne hai già uno che desideri utilizzare (nota che il link per selezionare o creare un nuovo progetto si trova in alto a sinistra della pagina).
Per un nuovo progetto, completa la pagina di creazione del nuovo progetto (assicurati che la tua organizzazione sia selezionata nel campo a discesa appropriato).
Per la gestione della fatturazione per il tuo progetto, dovrai configurare un account di fatturazione per il progetto in Fatturazione di Google Cloud, supponendo che la fatturazione sia configurata per la tua organizzazione. Tu (o il responsabile del tuo account di fatturazione) dovreste essere in grado di farlo successivamente, dopo la creazione della chiave. Nota che ci sono limiti sui progetti e sui progetti di fatturazione a seconda dell’account Google Cloud della tua organizzazione. Per abilitare la fatturazione sul tuo progetto, vai alla scheda Fatturazione nel menu di navigazione di Google Cloud e collega un account di fatturazione (vedi il link “Gestisci account di fatturazione”) e abilita la fatturazione per il progetto dalla pagina dei progetti di fatturazione.
Passaggio 2: Creare una chiave API Gemini
IMPORTANTE! Ricorda di utilizzare le tue chiavi API in modo sicuro. Ti preghiamo di leggere attentamente Mantieni sicura la tua chiave API e Pratiche consigliate per l’utilizzo sicuro delle chiavi API prima di procedere.
Ora sei pronto per creare una chiave API nel progetto. Vai alle credenziali per quel progetto, fai clic sul link “+ crea credenziali” in alto e seleziona “Chiave API” dalle opzioni a discesa.
Verrà creata una nuova chiave API per te. Copiala e assicurati di salvarla in un luogo sicuro come un’applicazione per la conservazione delle password. Non condividere le chiavi. Questa è la chiave che dovrai inserire nelle impostazioni di Discourse AI.
La chiave dovrebbe ora essere elencata nelle tue chiavi API. Cliccaci sopra per modificare la chiave API
Assegna un nome appropriato alla chiave, quindi scorri fino alla sezione Restrizioni API e seleziona “Restringi chiave”, quindi scegli “Generative Language API”.
Salva la chiave aggiornata. Fai clic sul link “Mostra chiave” per la tua nuova chiave e copiala.
Passaggio 3: Configurare Gemini nelle impostazioni di Discourse AI
Discourse AI utilizza ora un sistema Credenziali centralizzato per la gestione delle chiavi API. Invece di incollare la chiave direttamente in ogni configurazione LLM, crei prima una credenziale e poi la selezioni quando configuri il tuo modello Gemini.
Passaggio 3a: Creare una credenziale
Vai a Admin > Plugin > AI > Credenziali e fai clic su Nuova credenziale. Assegna un nome descrittivo (ad esempio, “Chiave API Gemini”) e incolla la chiave API che hai copiato da Google Cloud. Salva la credenziale.
Suggerimento: Puoi anche creare una credenziale in linea — quando aggiungi un nuovo LLM nel passaggio successivo, fai clic sul pulsante + accanto al selettore delle credenziali per crearne una al volo.
Passaggio 3b: Aggiungere un LLM Gemini
Ora vai a Admin > Plugin > AI > LLM. Fai clic su Aggiungi e seleziona uno dei modelli Gemini preconfigurati (ad esempio, Gemini 3 Flash o Gemini 3 Pro). Il nome del modello, l’URL dell’endpoint e altre impostazioni verranno precompilati per te. Utilizza il menu a discesa Credenziale per selezionare la credenziale che hai creato nel passaggio precedente, quindi salva.
Nota: La stessa credenziale può essere riutilizzata in più configurazioni LLM, quindi devi inserire la tua chiave API Gemini solo una volta.
Passaggio 4: Monitorare l’utilizzo della chiave API Gemini
Puoi monitorare l’utilizzo della tua chiave API Gemini dalla dashboard di Google Cloud nella fatturazione sotto “Gestisci account di fatturazione”
Quindi seleziona il tuo progetto specifico dall’elenco dei progetti di fatturazione e ti verrà mostrato il report di fatturazione in cui puoi specificare il/i progetto/i e vari altri dettagli che desideri utilizzare per monitorare i tuoi progetti con chiave API (puoi monitorare qui anche altre chiavi API di Google collegate al tuo account Google Cloud, ad esempio se hai configurato Google Custom Search API e motore di ricerca programmabile).
