Utilizza Gemini CLI

Utilizza 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 Gemini Enterprise Agent Platform Workbench.

Questo documento è rivolto ad analisti di dati, data scientist e sviluppatori di dati che lavorano con Agent Platform Workbench. Questo documento presuppone che tu sappia come 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 saperne di più, visita il sito geminicli.com.

Gemini CLI è disponibile nelle istanze Workbench di Agent Platform. 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 Agent Platform Workbench, incluse operazioni su file complesse che interessano più file in base a una singola istruzione di alto livello.
• Eseguire comandi di base della shell.
• Esegui comandi per interagire con altri servizi Google Cloud , come Gemini Enterprise Agent Platform e BigQuery.

Limitazioni

Tieni presente le seguenti limitazioni quando utilizzi Gemini CLI con Agent Platform Workbench:

• Gemini CLI è solo un'interfaccia a riga di comando. Non sono incluse un'interfaccia di chat grafica e strumenti avanzati nell'editor.

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

Prima di iniziare

Poiché si tratta di una tecnologia in fase iniziale, Gemini per i prodotti Google Cloud può generare risultati 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 in 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 di workload.

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, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). 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, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

Ruoli obbligatori

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

Nota: Gemini CLI opera esclusivamente nell'ambito delle autorizzazioni dell'ambiente dell'istanza di Agent Platform Workbench. Se tu (o il account di servizio utilizzato dalla tua istanza) non disponi dell'autorizzazione per accedere a una risorsa specifica, neanche Gemini CLI potrà accedervi. Se un comando non va a buon fine a causa delle autorizzazioni, chiedi all'amministratore di concederti le autorizzazioni necessarie.

Concedi le autorizzazioni all'utente dell'istanza

Per ottenere le autorizzazioni necessarie per utilizzare la Gemini CLI in un'istanza di Agent Platform 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 dell'istanza

Per assicurarti che il account di servizio della tua istanza Agent Platform Workbench disponga delle autorizzazioni necessarie per consentire l'esecuzione di Gemini CLI in un'istanza Agent Platform Workbench, chiedi all'amministratore di concedere il ruolo IAM Agent Platform User (roles/aiplatform.user) al account di servizio della tua istanza Agent Platform Workbench nel progetto.

Importante: devi concedere questo ruolo al account di servizio dell'istanza Workbench della piattaforma agente, 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 abilitare l'esecuzione dell'interfaccia a riga di comando di Gemini in un'istanza di Agent Platform Workbench.

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

Utilizza Gemini CLI

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

   Vai a Istanze

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

   L'istanza di Agent Platform Workbench apre JupyterLab.

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

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 condizioni.

   L'istanza di Agent Platform Workbench installa Gemini CLI.

6. Nel terminale di Gemini CLI, inserisci un prompt.

   Ad esempio, potresti inserire Create a new notebook named 'test-notebook'. Per vedere esempi di prompt che potrebbero essere 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 addestra 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 avere una rapida panoramica 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 Agent Platform 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 del notebook che esegua il codice in 'test-script'. Aggiungi celle di testo che spiegano il codice."

Controlla l'accesso a Gemini CLI

Puoi controllare l'accesso a Gemini CLI in Agent Platform 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. Consulta Controlla l'accesso ai modelli di Model Garden. L'interfaccia a riga di comando di Gemini 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.

Utilizza il comando magico di Gemini CLI

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

1. Assicurati che Gemini CLI sia abilitato e che l'utente o il creator abbia accettato i Termini e 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.

Gemini CLI aggiunge una nuova cella sotto con la sua risposta.

Risoluzione dei problemi

Se riscontri un problema durante l'utilizzo di Gemini CLI con le istanze di Agent Platform Workbench, consulta Risoluzione dei problemi di Agent Platform Workbench per assistenza con i problemi comuni.

Passaggi successivi

• Scopri di più su Gemini.

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