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

Questo documento è destinato 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 geminicli.com.

Gemini CLI è disponibile nelle istanze Workbench di Agent Platform. Puoi utilizzare Gemini CLI per:

• Creare un nuovo notebook.
• Eseguire 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 Workbench di Agent Platform, incluse operazioni complesse sui file che interessano più file in base a una singola istruzione di alto livello.
• Eseguire comandi shell di base.
• Eseguire comandi per interagire con altri Google Cloud servizi, come Gemini Enterprise Agent Platform e BigQuery.

Limitazioni

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

• Gemini CLI è solo una CLI. 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 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 Google Cloud i prodotti può generare risultati apparentemente plausibili, ma di fatto errati. Ti consigliamo di convalidare tutti gli output di Gemini per i Google Cloud prodotti prima di utilizzarli. Per saperne di più, consulta Gemini per Google Cloud e l'AI responsabile.

Accedi al tuo Google Cloud account. 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 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.

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 Gemini CLI in Agent Platform Workbench, devi concedere le autorizzazioni all'utente dell'istanza Workbench di Agent Platform e al account di servizio dell'istanza.

Nota: Gemini CLI opera rigorosamente all'interno delle autorizzazioni dell'ambiente dell'istanza Workbench di Agent Platform. Se tu (o il account di servizio utilizzato dall'istanza) non hai l'autorizzazione ad accedere a una risorsa specifica, neanche Gemini CLI potrà accedervi Se un comando non riesce a causa delle autorizzazioni, chiedi all'amministratore di concedere le autorizzazioni necessarie.

Concedere le autorizzazioni all'utente dell'istanza

Per ottenere le autorizzazioni necessarie per utilizzare Gemini CLI in un'istanza Workbench di Agent Platform, chiedi all'amministratore di concederti il ruolo IAM Utente di Agent Platform (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.

Concedere un'autorizzazione al account di servizio dell'istanza

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

Importante: devi concedere questo ruolo al account di servizio dell'istanza Workbench di Agent Platform, 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' aiplatform.endpoints.predict autorizzazione, necessaria per consentire l'esecuzione di Gemini CLI in un'istanza Workbench di Agent Platform.

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

Utilizzare Gemini CLI

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

   Vai a Istanze

2. Fai clic su Apri JupyterLab accanto al nome di un'istanza Workbench di Agent Platform.

   L'istanza Workbench di Agent Platform apre JupyterLab.

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

4. Nella scheda Launcher, 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 Workbench di Agent Platform installa the Gemini CLI.

6. Nel terminale Gemini CLI, inserisci un prompt.

   Ad esempio, puoi 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:

• "Create a new notebook that trains a model to predict 'income bracket' from bigquery-public-data.ml_datasets.census_adult_income, using BigQuery and Python."

• "Summarize the notebook named 'test-file', and propose next steps for the project."

• "I want to get a quick overview of the notebooks in this directory. For every .ipynb file, show me the first 5 lines of the file."

• "Create a script using the contents of the 'test-file' notebook."

• "Show me how to access data from BigQuery tables from within Agent Platform Workbench."

• "Query the bigquery-public-data.ml_datasets.census_adult_income table to find the number of people with an income bracket of > 50K."

• "Set my default Google Cloud project to my-project."

• Create a bucket Cloud Storage, and upload all the CSV files from my current directory to it.

• Create a Compute Engine instance with a Debian 11 image and an n1-standard-4 tipo di macchina.

• "Create a notebook file that runs through the code in the 'test-script'. Add text cells that explain the code."

Controllare 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 Controllare l'accesso ai modelli di Model Garden modelli. Gemini CLI continua a essere visualizzata in JupyterLab, ma la CLI 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 Gemini CLI

Per utilizzare Gemini CLI direttamente all'interno di una cella del file del notebook:

1. Assicurati che Gemini CLI sia abilitata e che l'utente o il creatore 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 seguente.
4. Esegui la cella.

Gemini CLI aggiunge una nuova cella di seguito con la sua risposta.

Risoluzione dei problemi

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

Passaggi successivi

• Scopri di più su Gemini.

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