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 (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. 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 Workbench-Instanzen der Agentenplattform 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.
• Interagieren Sie mit dem lokalen Dateisystem einer Agent Platform Workbench-Instanz. Führen Sie beispielsweise komplexe Dateioperationen aus, die sich über mehrere Dateien erstrecken und auf einer einzelnen High-Level-Anweisung basieren.
• Grundlegende Shell-Befehle ausführen
• Führen Sie Befehle aus, um mit anderen Google Cloud -Diensten wie der Gemini Enterprise Agent Platform und BigQuery zu interagieren.

Beschränkungen

Beachten Sie die folgenden Einschränkungen, wenn Sie die Gemini CLI mit der Agent Platform Workbench verwenden:

• Die Gemini CLI ist nur eine Befehlszeile. Eine grafische Chatoberfläche und erweiterte Tools im Editor sind nicht enthalten.

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

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

Erforderliche Rollen

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

Hinweis: Die Gemini CLI arbeitet ausschließlich im Rahmen der Berechtigungen der Umgebung Ihrer Agent Platform Workbench-Instanz. Wenn Sie (oder das von Ihrer Instanz verwendete Dienstkonto) keine Berechtigung für den Zugriff auf eine bestimmte Ressource haben, kann die Gemini CLI auch nicht darauf zugreifen. Wenn ein Befehl aufgrund von Berechtigungen fehlschlägt, bitten Sie Ihren Administrator, Ihnen die erforderlichen Berechtigungen zu gewähren.

Dem Nutzer der Instanz Berechtigungen gewähren

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Agent Platform User (roles/aiplatform.user) für das Projekt zu gewähren, 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.

Dem Dienstkonto Ihrer Instanz eine Berechtigung gewähren

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

Wichtig: Sie müssen diese Rolle dem Dienstkonto Ihrer Agent Platform Workbench-Instanz und nicht Ihrem Nutzerkonto zuweisen. Wenn die Rolle nicht dem richtigen Hauptkonto 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, um die Gemini CLI in einer Agent Platform Workbench-Instanz auszuführen.

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 Seite Instanzen 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 Abschnitt 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 auf 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 hilfreiche Prompts finden Sie unter Beispiel-Prompts.

Beispiel-Prompts

Die folgenden Beispiel-Prompts können Ihnen als Inspiration für die Verwendung der Gemini CLI dienen:

• „Erstelle ein neues Notebook, das ein Modell trainiert, um ‚income bracket‘ aus 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 mir einen schnellen Überblick über die Notebooks in diesem Verzeichnis verschaffen. Zeige mir für jede .ipynb-Datei die ersten fünf Zeilen der Datei.“

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

• „Zeigen Sie mir, wie ich über die 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 einer Einkommensklasse von > 50.000 zu ermitteln.“

• „Setze mein Standardprojekt für Google Cloud auf ‚my-project‘.“

• „Erstelle einen Cloud Storage-Bucket und lade alle CSV-Dateien aus meinem aktuellen Verzeichnis dorthin 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‘ ausführt. Fügen Sie Textzellen hinzu, die den Code erklären.“

Zugriff auf die Gemini CLI verwalten

Sie können den Zugriff auf die Gemini CLI in der 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 gewährt wird, kann ein Administrator verhindern, dass bestimmte Identitäten Gemini-Endpunkte für die Inferenz verwenden.

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

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

Nächste Schritte

• Gemini

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