Gemini CLI verwenden

Gemini CLI verwenden

Vorschau

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-Befehlszeilenschnittstelle (CLI) mit einer Vertex AI Workbench-Instanz verwenden.

Dieses Dokument richtet sich an Datenanalysten, Data Scientists und Datenentwickler, die mit Vertex AI Workbench arbeiten. In diesem Dokument 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.
• Notebook-Zellen 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.
• Grundlegende 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 eine reine CLI. 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 der Festplatte der Instanz. Aus diesem Grund können Sie Änderungen, die mit der Gemini CLI vorgenommen wurden, nicht mit der Schaltfläche Rückgängig des Notebook-Editors oder mit Strg+Z (Befehl+Z unter macOS) rückgängig machen. Sie können die Gemini CLI jedoch bitten, eine Änderung mit einem Befehl in natürlicher Sprache wie Undo your last change rückgängig zu machen.

Hinweis

Da es sich bei Produkten von Gemini for Google Cloudum 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 mit Google Cloudnoch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden 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 arbeitet ausschließlich innerhalb der Berechtigungen der Umgebung Ihrer Vertex AI Workbench-Instanz. Wenn Sie (oder das Dienstkonto, das von Ihrer Instanz verwendet wird) 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.

Dem Nutzer der Instanz Berechtigungen 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.

Dem Dienstkonto Ihrer Instanz eine Berechtigung erteilen

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

Wichtig:Sie müssen diese Rolle dem Dienstkonto Ihrer Vertex AI Workbench-Instanz und nicht Ihrem Nutzerkonto zuweisen. Wenn die Rolle nicht dem richtigen Prinzipal zugewiesen wird, können Berechtigungsfehler auftreten.

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

Diese vordefinierte Rolle enthält die Berechtigung aiplatform.endpoints.predict, 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 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 Other auf die Kachel Gemini CLI.

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

   Auf Ihrer Vertex AI Workbench-Instanz wird die Gemini CLI installiert.

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

   Sie können beispielsweise Create a new notebook named 'test-notebook' eingeben. Beispiel-Prompts

Beispiel-Prompts

Die folgenden Beispielprompts können Ihnen helfen, Ideen für die Verwendung der Gemini CLI zu sammeln:

• „Erstelle ein neues Notebook, in dem ein Modell trainiert wird, um ‚income bracket‘ anhand von bigquery-public-data.ml_datasets.census_adult_income mit BigQuery und Python vorherzusagen.“

• Fasse das Notebook mit dem Namen „test-file“ zusammen und schlage die nächsten Schritte für das Projekt vor.

• „Ich möchte einen schnellen Überblick über die Notebooks in diesem Verzeichnis erhalten. Zeige mir für jede .ipynb-Datei die ersten fünf Zeilen der Datei an.“

• „Erstelle ein Skript mit dem Inhalt des Notebooks ‚test-file‘.“

• „Zeige mir, wie ich in Vertex AI Workbench auf Daten aus BigQuery-Tabellen zugreifen kann.“

• „Frage die Tabelle ‚bigquery-public-data.ml_datasets.census_adult_income‘ ab, um die Anzahl der Personen mit einem Einkommensbereich von > 50.000 $ zu ermitteln.“

• „Setze mein Standardprojekt Google Cloud auf ‚mein-projekt‘.“

• Erstelle einen Cloud Storage-Bucket und lade alle CSV-Dateien aus meinem aktuellen Verzeichnis in diesen Bucket hoch.

• „Erstelle eine Compute Engine-Instanz mit einem Debian 11-Image und dem Maschinentyp ‚n1-standard-4‘.“

• „Erstelle eine Notebook-Datei, in der der Code im ‚test-script‘ ausgeführt wird. Fügen Sie Textzellen hinzu, in denen der Code erläutert wird.“

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 ein Administrator die Berechtigung aiplatform.endpoints.predict nicht erteilt, kann er verhindern, dass bestimmte Identitäten Gemini-Endpunkte für die Inferenz verwenden können.

Gemini CLI-Magic-Befehl 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 nächsten Zeile Ihren Prompt ein.
4. Führen Sie die Zelle aus.

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

Fehlerbehebung

Wenn bei der Verwendung der Gemini CLI mit Vertex AI Workbench-Instanzen Probleme auftreten, finden Sie unter Fehlerbehebung bei Vertex AI Workbench Informationen zu häufig auftretenden Problemen.

Nächste Schritte

• Gemini

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