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-Befehlszeile (Command Line Interface, CLI) mit einer Gemini Enterprise Agent Platform Workbench-Instanz verwenden.

Dieses Dokument richtet sich an Datenanalysten, Data Scientists und Datenentwickler, die mit Agent Platform 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 Agent Platform 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 Agent Platform 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 Gemini Enterprise Agent Platform und BigQuery zu interagieren.

Beschränkungen

Beachten Sie bei der Verwendung der Gemini CLI mit Agent Platform Workbench die folgenden Einschränkungen:

• 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 (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 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 einfach 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 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

Erforderliche Rollen

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

Hinweis: Die Gemini CLI funktioniert ausschließlich mit den Berechtigungen der Umgebung Ihrer Agent Platform 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 Agent Platform User (roles/aiplatform.user) IAM-Rolle für das Projekt zu erteilen, um die Berechtigungen zu erhalten, die Sie zum Verwenden der Gemini CLI in einer Agent Platform 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

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

Wichtig: Sie müssen diese Rolle dem Dienstkonto Ihrer Agent Platform 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 aiplatform.endpoints.predict Berechtigung, die erforderlich ist, damit die Gemini CLI in einer Agent Platform Workbench-Instanz ausgeführt werden kann.

Ihr Administrator kann dem Dienstkonto Ihrer Agent Platform 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 Instanzen Seite auf.

   Zur Seite „VM-Instanzen“

2. Klicken Sie neben dem Namen einer Agent Platform Workbench-Instanz auf JupyterLab öffnen.

   Ihre Agent Platform 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 Agent Platform 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:

• „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.“

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

• „Zeige mir, wie ich aus Agent Platform 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 Einkommen von über 50.000 $ zu ermitteln.“

• „Lege mein Standard Google Cloud projekt auf mein-projekt fest.“

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

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

• „Erstelle eine Notebook-Datei, die den Code in ‚test-script‘ durchläuft. Füge Textzellen hinzu, in denen der Code erklärt wird.“

Zugriff auf die Gemini CLI steuern

Sie können den Zugriff auf die Gemini CLI in Agent Platform 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. Achten Sie darauf, dass 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 unten eine neue Zelle mit ihrer Antwort hinzu.

Fehlerbehebung

Wenn bei der Verwendung der Gemini CLI mit Agent Platform Workbench-Instanzen ein Problem auftritt, finden Sie unter Fehlerbehebung für Agent Platform Workbench Informationen zu häufig auftretenden Problemen.

Nächste Schritte

• Weitere Informationen zu Gemini.

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