Utilizzare Gemini CLI

Utilizzare Gemini CLI

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Questa pagina descrive come utilizzare l'interfaccia a riga di comando (CLI) di Gemini con un'istanza di Vertex AI Workbench.

Questo documento è destinato ad analisti di dati, data scientist e sviluppatori di dati che lavorano con Vertex AI Workbench. Questo documento presuppone che tu sappia scrivere codice in un ambiente notebook.

Panoramica

Gemini CLI è un agente AI open source che fornisce l'accesso a Gemini direttamente in un terminale. Per ulteriori informazioni, visita il sito geminicli.com.

Gemini CLI è disponibile nelle istanze Vertex AI Workbench. Puoi utilizzare Gemini CLI per:

• Crea un nuovo notebook.
• Esegui le celle del notebook.
• Scrivere e modificare le celle di codice e di testo di un notebook.
• Spiegare il codice e i concetti tecnici.
• Interagire con il file system locale di un'istanza Vertex AI Workbench, incluse operazioni complesse sui file che interessano più file in base a una singola istruzione di alto livello.
• Esegui comandi shell di base.
• Esegui comandi per interagire con altri servizi, come Gemini Enterprise Agent Platform e BigQuery. Google Cloud

Limitazioni

Tieni presente le seguenti limitazioni quando utilizzi Gemini CLI con Vertex AI Workbench:

• Gemini CLI è solo una CLI. Non sono inclusi un'interfaccia di chat grafica e strumenti avanzati nell'editor.

• Quando chiedi a Gemini CLI di modificare un blocco note, Gemini CLI modifica il file del blocco note direttamente sul disco dell'istanza. Per questo motivo, non puoi annullare le modifiche apportate da Gemini CLI utilizzando il pulsante Annulla dell'editor del blocco note o Control+Z (Command+Z su macOS). Tuttavia, puoi chiedere a Gemini CLI di annullare una modifica utilizzando un comando in linguaggio naturale, ad esempio Undo your last change.

Prima di iniziare

Poiché si tratta di una tecnologia in fase iniziale, Gemini per i prodotti Google Cloud può generare output apparentemente plausibili, ma di fatto errati. Ti consigliamo di verificare tutti gli output di Gemini per i prodotti Google Cloud prima di utilizzarli. Per saperne di più, consulta Gemini for Google Cloud e l'AI responsabile.

Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei carichi di lavoro.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, Notebooks, and Agent Platform APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, Notebooks, and Agent Platform APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Ruoli obbligatori

Per utilizzare la CLI Gemini in Vertex AI Workbench, devi concedere le autorizzazioni all'utente dell'istanza di Vertex AI Workbench e al account di servizio dell'istanza.

Nota: la Gemini CLI opera rigorosamente all'interno delle autorizzazioni dell'ambiente dell'istanza Vertex AI Workbench. Se tu (o il account di servizio utilizzato dall'istanza) non disponi dell'autorizzazione per accedere a una risorsa specifica, nemmeno la Gemini CLI potrà accedervi. Se un comando non va a buon fine a causa delle autorizzazioni, chiedi all'amministratore di concedere le autorizzazioni necessarie.

Concedi le autorizzazioni all'utente dell'istanza

Per ottenere le autorizzazioni necessarie per utilizzare la CLI Gemini in un'istanza Vertex AI Workbench, chiedi all'amministratore di concederti il ruolo IAM Agent Platform User (roles/aiplatform.user)) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Concedi un'autorizzazione al account di servizio della tua istanza

Per assicurarti che il service account dell'istanza di Vertex AI Workbench disponga dell'autorizzazione necessaria per consentire l'esecuzione della CLI Gemini in un'istanza di Vertex AI Workbench, chiedi all'amministratore di concedere il ruolo IAM Utente della piattaforma di agenti (roles/aiplatform.user)) al account di servizio account dell'istanza di Vertex AI Workbench nel progetto.

Importante: devi concedere questo ruolo al account di servizio dell'istanza di Vertex AI Workbench, non al tuo account utente. La mancata concessione del ruolo all'entità corretta potrebbe comportare errori di autorizzazione.

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione aiplatform.endpoints.predict necessaria per consentire l'esecuzione di Gemini CLI in un'istanza di Vertex AI Workbench.

L'amministratore potrebbe anche essere in grado di concedere al service account dell'istanza di Vertex AI Workbench questa autorizzazione tramite ruoli personalizzati o altri ruoli predefiniti.

Utilizzare Gemini CLI

1. Nella console Google Cloud , vai alla pagina Istanze.

   Vai a Istanze

2. Accanto al nome di un'istanza di Vertex AI Workbench, fai clic su Apri JupyterLab.

   L'istanza di Vertex AI Workbench apre JupyterLab.

3. In JupyterLab, fai clic su File > Nuovo launcher.

4. Nella scheda Avvio app, nella sezione Altro, fai clic sul riquadro Gemini CLI.

5. Se è la prima volta che apri un terminale Gemini CLI, inserisci Y per accettare i termini e le condizioni.

   L'istanza di Vertex AI Workbench installa Gemini CLI.

6. Nel terminale Gemini CLI, inserisci un prompt.

   Ad esempio, potresti inserire Create a new notebook named 'test-notebook'. Per vedere esempi di prompt che potrebbero esserti utili, consulta Prompt di esempio.

Prompt di esempio

Per aiutarti a trovare idee su come utilizzare Gemini CLI, consulta i seguenti prompt di esempio:

• "Crea un nuovo notebook che addestri un modello per prevedere 'income bracket' da bigquery-public-data.ml_datasets.census_adult_income, utilizzando BigQuery e Python."

• "Riassumi il notebook denominato "test-file" e proponi i passaggi successivi per il progetto."

• "Voglio una panoramica rapida dei notebook in questa directory. Per ogni file .ipynb, mostrami le prime 5 righe del file."

• "Crea uno script utilizzando i contenuti del blocco note "test-file"."

• "Mostrami come accedere ai dati delle tabelle BigQuery da Vertex AI Workbench."

• "Esegui una query sulla tabella bigquery-public-data.ml_datasets.census_adult_income per trovare il numero di persone con una fascia di reddito superiore a 50.000 €".

• "Imposta il mio progetto Google Cloud predefinito su my-project."

• "Crea un bucket Cloud Storage e carica tutti i file CSV dalla mia directory attuale."

• "Crea un'istanza Compute Engine con un'immagine Debian 11 e un tipo di macchina n1-standard-4."

• "Crea un file notebook che esegua il codice in "test-script". Aggiungi celle di testo che spieghino il codice."

Controllare l'accesso a Gemini CLI

Puoi controllare l'accesso alla Gemini CLI in Vertex AI Workbench utilizzando i seguenti metodi:

• Un amministratore può configurare una policy dell'organizzazione per limitare l'utilizzo di modelli Gemini specifici a livello di organizzazione, cartella o progetto. Vedi Controllare l'accesso ai modelli di Model Garden. Gemini CLI continua a essere visualizzata in JupyterLab, ma non risponde ai prompt.

• Se non concede l'autorizzazione aiplatform.endpoints.predict, un amministratore può impedire ad alcune identità di utilizzare gli endpoint Gemini per l'inferenza.

Utilizzare il comando magico di Gemini CLI

Per utilizzare Gemini CLI direttamente all'interno di una cella del file del blocco note, segui questi passaggi:

1. Assicurati che Gemini CLI sia abilitata e che l'utente o il creator abbia accettato i termini e le condizioni.
2. Nella prima riga di una nuova cella, inserisci %%geminicli_magic.
3. Nella stessa cella, inserisci il prompt nella riga successiva.
4. Esegui la cella.

La CLI Gemini aggiunge una nuova cella in basso con la sua risposta.

Risoluzione dei problemi

Se riscontri un problema durante l'utilizzo della CLI Gemini con le istanze di Vertex AI Workbench, consulta la sezione Risoluzione dei problemi di Vertex AI Workbench per assistenza in caso di problemi comuni.

Passaggi successivi

• Scopri di più su Gemini.

• Per scoprire i metodi per eseguire query sui dati BigQuery nei notebook Vertex AI Workbench, consulta Esegui query sui dati in BigQuery da JupyterLab.