Gemini CLI verwenden

Gemini CLI verwenden

Vorschau – Private Service Connect-Schnittstelle

Diese Funktion unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Auf dieser Seite wird beschrieben, wie Sie die Gemini-Befehlszeile (Command Line Interface, CLI) mit einer Vertex AI Workbench-Instanz verwenden.

Dieses Dokument richtet sich an Datenanalysten, Data Scientists und Datenentwickler, die mit Vertex AI Workbench arbeiten. Es wird davon ausgegangen, dass Sie wissen, wie Sie Code in einer Notebook-Umgebung schreiben.

Übersicht

Die Gemini CLI ist ein Open-Source-KI-Agent, der direkt in einem Terminal Zugriff auf Gemini bietet. Weitere Informationen finden Sie unter geminicli.com.

Die Gemini CLI ist in Vertex AI Workbench-Instanzen verfügbar. Mit der Gemini CLI können Sie Folgendes tun:

• Erstellen Sie ein neues Notebook.
• Notebookzellen ausführen.
• Code- und Textzellen eines Notebooks schreiben und bearbeiten.
• Code und technische Konzepte erklären.
• Mit dem lokalen Dateisystem einer Vertex AI Workbench-Instanz interagieren, einschließlich der Ausführung komplexer Dateivorgänge, die sich über mehrere Dateien erstrecken und auf einer einzelnen High-Level-Anweisung basieren.
• Einfache Shell-Befehle ausführen.
• Befehle ausführen, um mit anderen Google Cloud Diensten wie Vertex AI und BigQuery zu interagieren.

Beschränkungen

Beachten Sie die folgenden Einschränkungen, wenn Sie die Gemini CLI mit Vertex AI Workbench verwenden:

• Die Gemini CLI ist nur eine Befehlszeile. Eine grafische Chat-Oberfläche und erweiterte In-Editor-Tools sind nicht enthalten.

• Wenn Sie die Gemini CLI bitten, ein Notebook zu ändern, ändert die Gemini CLI die Notebook-Datei direkt auf dem Laufwerk der Instanz. Daher können Sie Änderungen, die von der Gemini CLI vorgenommen wurden, nicht mit der Schaltfläche Rückgängig des Notebook-Editors oder mit Strg+Z (Cmd+Z unter macOS) rückgängig machen. Sie können die Gemini CLI jedoch bitten, eine Änderung mit einem Befehl in natürlicher Sprache rückgängig zu machen, z. B. Undo your last change.

Hinweis

Da es sich bei Produkten von Gemini for Google Cloud Technologie in einem frühen Entwicklungsstadium handelt, kann es zu Ergebnissen kommen, die zwar plausibel erscheinen, aber faktisch falsch sind. Ausgaben der Produkte von Gemini für Google Cloud sollten daher vor der Verwendung geprüft werden. Weitere Informationen finden Sie unter Gemini für Google Cloud und verantwortungsbewusste Anwendung von KI.

Melden Sie sich in Ihrem Google Cloud Konto an. Wenn Sie noch kein Konto haben, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Google CloudNeukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

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 Vertex AI 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 Vertex AI 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

Erforderliche Rollen

Wenn Sie die Gemini CLI in Vertex AI Workbench verwenden möchten, müssen Sie dem Nutzer der Vertex AI Workbench-Instanz und dem Dienstkonto der Instanz Berechtigungen erteilen.

Hinweis: Die Gemini CLI funktioniert ausschließlich mit den Berechtigungen der Umgebung Ihrer Vertex AI Workbench-Instanz. Wenn Sie (oder das Dienstkonto, das Ihre Instanz verwendet) keine Berechtigung für den Zugriff auf eine bestimmte Ressource haben, kann auch die Gemini CLI nicht darauf zugreifen. Wenn ein Befehl aufgrund von Berechtigungen fehlschlägt, bitten Sie Ihren Administrator die erforderlichen Berechtigungen zu erteilen.

Berechtigungen für den Nutzer der Instanz erteilen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle „Vertex AI-Nutzer“ (roles/aiplatform.user)) für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Verwenden der Gemini CLI in einer Vertex AI Workbench-Instanz benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Berechtigung für das Dienstkonto Ihrer Instanz erteilen

Bitten Sie Ihren Administrator, dem Dienstkonto Ihrer Vertex AI Workbench-Instanz die IAM-Rolle „Vertex AI-Nutzer“ (roles/aiplatform.user)) für das Projekt zuzuweisen, damit das Dienstkonto Ihrer Vertex AI Workbench-Instanz die erforderliche Berechtigung hat, die Gemini CLI in einer Vertex AI Workbench-Instanz auszuführen.

Wichtig: Sie müssen diese Rolle dem Dienstkonto Ihrer Vertex AI Workbench-Instanz und nicht Ihrem Nutzerkonto zuweisen. Wenn Sie die Rolle nicht dem richtigen Hauptkonto zuweisen, kann es zu Berechtigungsfehlern kommen.

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die aiplatform.endpoints.predict Berechtigung, die erforderlich ist, damit die Gemini CLI in einer Vertex AI Workbench-Instanz ausgeführt werden kann.

Ihr Administrator kann dem Dienstkonto Ihrer Vertex AI Workbench-Instanz möglicherweise auch diese Berechtigung mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erteilen.

Gemini CLI verwenden

1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.

   Zur Seite „VM-Instanzen“

2. Klicken Sie neben dem Namen einer Vertex AI Workbench-Instanz auf JupyterLab öffnen.

   Ihre Vertex AI Workbench-Instanz öffnet JupyterLab.

3. Klicken Sie in JupyterLab auf Datei > Neuer Launcher.

4. Klicken Sie auf dem Tab Launcher im Bereich Sonstiges auf die Kachel Gemini CLI.

5. Wenn Sie zum ersten Mal ein Gemini CLI-Terminal öffnen, geben Sie Y ein, um den Nutzungsbedingungen zuzustimmen.

   Die Gemini CLI wird von Ihrer Vertex AI Workbench-Instanz installiert.

6. Geben Sie im Gemini CLI-Terminal einen Prompt ein.

   Sie können beispielsweise Create a new notebook named 'test-notebook' eingeben. Beispiele für Prompts, die hilfreich sein können, finden Sie unter Beispiel-Prompts.

Beispiel-Prompts

Hier sind einige Beispiel-Prompts, die Ihnen Ideen für die Verwendung der Gemini CLI geben sollen:

• „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 Vertex AI 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 Cloud Storage-Bucket, 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 machine type.“

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

Zugriff auf die Gemini CLI steuern

Sie können den Zugriff auf die Gemini CLI in Vertex AI Workbench mit den folgenden Methoden steuern:

• Ein Administrator kann eine Organisationsrichtlinie einrichten, um die Verwendung bestimmter Gemini-Modelle auf Organisations-, Ordner- oder Projektebene einzuschränken. Weitere Informationen finden Sie unter Zugriff auf Model Garden Modelle steuern. Die Gemini CLI wird weiterhin in JupyterLab angezeigt, reagiert aber nicht auf Prompts.

• Wenn die Berechtigung aiplatform.endpoints.predict nicht erteilt wird, kann ein Administrator verhindern, dass bestimmte Identitäten Gemini-Endpunkte für die Inferenz verwenden.

Magic-Befehl der Gemini CLI verwenden

So verwenden Sie die Gemini CLI direkt in einer Zelle in Ihrer Notebook-Datei:

1. Prüfen Sie, ob die Gemini CLI aktiviert ist und der Nutzer oder Ersteller den Nutzungsbedingungen zugestimmt hat.
2. Geben Sie in der ersten Zeile einer neuen Zelle %%geminicli_magic ein.
3. Geben Sie in derselben Zelle in der folgenden Zeile Ihren Prompt ein.
4. Führen Sie die Zelle aus.

Die Gemini CLI fügt darunter eine neue Zelle mit ihrer Antwort hinzu.

Fehlerbehebung

Wenn beim Verwenden der Gemini CLI mit Vertex AI Workbench-Instanzen ein Problem auftritt, finden Sie unter Fehlerbehebung für Vertex AI Workbench Informationen zu häufig auftretenden Problemen.

Nächste Schritte

• Weitere Informationen zu Gemini.

• Informationen zu Methoden zum Abfragen von BigQuery-Daten in Vertex AI Workbench-Notebooks finden Sie unter Daten in BigQuery über JupyterLab abfragen.