Inizia a utilizzare Gemini

Questa pagina aiuta gli sviluppatori a configurare un progetto air-gapped Google Distributed Cloud (GDC) per utilizzare i modelli Gemini. Questo processo include la creazione di un progetto, l'abilitazione dell'API Gemini, l'installazione delle librerie client, la definizione delle variabili di ambiente e l'autenticazione delle credenziali. Se non hai mai usato Gemini, scopri di più sulle sue funzionalità.

Per iniziare a utilizzare Gemini, usa la console GDC e la CLI gdcloud nel seguente modo:

• Console GDC: attiva l'API Gemini e visualizza lo stato e l'endpoint del modello.
• gcloud CLI: configura i service account, installa le librerie client e autentica le richieste API.

Crea un progetto

La creazione di un progetto all'interno della gerarchia di risorse di Distributed Cloud organizza le risorse, tra cui collaboratori, API abilitate, credenziali di autenticazione e controlli dell'accesso.

Gemini è uno dei modelli di AI generativa offerti da Vertex AI su GDC. Pertanto, per creare un progetto, consulta Configurare un progetto per Vertex AI. L'ID progetto è necessario per effettuare chiamate API.

Suggerimento: migliora la sicurezza, la gestione delle risorse e il monitoraggio dei costi isolando i tuoi workload sperimentali, di test e di produzione in progetti Distributed Cloud separati.

Richiedere le autorizzazioni sviluppatore

Per accedere alle funzionalità di Gemini e generare token API per l'autenticazione e l'autorizzazione delle richieste, devi disporre dei ruoli appropriati nel progetto.

Chiedi all'amministratore IAM del progetto di concedere uno dei ruoli Gemini associati al tuo utente o account di servizio all'interno dello spazio dei nomi del progetto. Per informazioni sui ruoli Gemini, consulta Preparare le autorizzazioni IAM.

Abilitare l'API Gemini

Devi abilitare l'API Gemini per il tuo progetto. Se abilitata, puoi visualizzare lo stato del servizio e l'endpoint dell'API Gemini.

Installazione delle librerie client

Le librerie client sono disponibili per il linguaggio di programmazione Python. Consigliamo di utilizzare queste librerie client per effettuare chiamate all'API Gemini perché semplificano l'accesso alle API.

Per utilizzare l'SDK Python compatibile con OpenAI, installa l'SDK OpenAI e altre librerie Python richieste:

pip install openai
pip install absl-py
pip install typing
pip install protobuf

Imposta le variabili di ambiente

Dopo aver installato le librerie client, puoi interagire con l'API da uno script Python.

Se configuri un service account nel tuo progetto per effettuare chiamate API autorizzate a livello di programmazione, puoi definire variabili di ambiente in uno script Python per accedere a valori come le chiavi del service account.

Segui questi passaggi per impostare le variabili di ambiente richieste in uno script Python:

1. Crea uno script Python.

2. Aggiungi il seguente codice allo script Python:

   Produzione

   import os
   
   os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"
   

   Sostituisci APPLICATION_DEFAULT_CREDENTIALS_FILENAME con il nome del file JSON che contiene le chiavi dell'account di servizio che hai creato nel progetto, ad esempio my-service-key.json.

   Sviluppo

   import os
   
   os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"
   os.environ["GRPC_DEFAULT_SSL_ROOTS_FILE_PATH"] = "CERT_NAME"
   

   Sostituisci quanto segue:

   • APPLICATION_DEFAULT_CREDENTIALS_FILENAME: il nome del file JSON che contiene le chiavi dell'account di servizio che hai creato nel progetto, ad esempio my-service-key.json.
   • CERT_NAME: il nome del file del certificato dell'autorità di certificazione (CA), ad esempio org-1-trust-bundle-ca.cert. Per ulteriori informazioni, vedi Generare il file del certificato CA del bundle di attendibilità in un ambiente di sviluppo.

3. Salva lo script Python con un nome.

4. Esegui lo script Python per impostare le variabili di ambiente:

   python SCRIPT_NAME
   

   Sostituisci SCRIPT_NAME con il nome che hai assegnato allo script Python.

Nota :tieni aperto lo script quando utilizzi le variabili di ambiente da Python o quando ottieni un token di autenticazione.

Configura l'autenticazione

Prima di poter iniziare a utilizzare l'API Gemini, devi autenticare le credenziali client e richiedere l'accesso all'account alle risorse del progetto. Per maggiori informazioni, vedi Autenticare le richieste API.