Data Agent Kit installieren

Mit dem Google Cloud Data Agent Kit können Sie mit Ihren Google Cloud Datenressourcen in Ihrer bevorzugten IDE oder agentischen Programmierumgebung arbeiten. Je nach Einrichtung installieren Sie entweder eine IDE-Erweiterung oder ein Plug-in.

Das Data Agent Kit ist mit den folgenden Google CloudDiensten vorinstalliert:

  • Cloud Shell
  • Cloud Workstations

Hinweis

Führen Sie vor der Installation des Data Agent Kit die folgenden Schritte aus.

Lokale Umgebung einrichten

Installieren Sie auf Ihrem lokalen Computer Ihre bevorzugte IDE oder Ihren bevorzugten Coding-Agent und Node.js.

  1. Installieren und richten Sie Ihre IDE, die Agentic CLI oder den Coding-Agent ein. Wenn sie bereits installiert ist, aktualisieren Sie sie auf die neueste Version.
  2. Installieren Sie Node.js.

Einrichtung von Google Cloud

  1. Falls Sie noch kein Projekt haben, erstellen Sie ein Google Cloud Projekt.
  2. Abrechnung aktivieren

Erforderliche Rollen

Das Data Agent Kit benachrichtigt Sie, wenn Sie zusätzliche Berechtigungen für eine Aufgabe benötigen. Sie benötigen nur Berechtigungen für die Dienste, die Sie verwenden. Eine vollständige Liste der Berechtigungen und APIs, die für jeden Dienst im Data Agent Kit erforderlich sind, finden Sie unter Berechtigungen.

Erweiterung oder Plug-in installieren

Der Installationsprozess hängt von der IDE oder dem Coding-Agent ab, den Sie verwenden.

VS Code

Wenn Sie das Data Agent Kit in VS Code verwenden möchten, installieren Sie die Erweiterung:

  1. Klicken Sie in der IDE auf Erweiterungen oder drücken Sie Ctrl/Cmd+Shift+X.
  2. Suchen Sie nach Google Cloud Data Agent Kit.
  3. Klicken Sie auf Installieren.
  4. Starten Sie Ihre IDE neu, wenn Sie dazu aufgefordert werden. Nach erfolgreicher Installation der Erweiterung wird das Symbol für das Google Cloud Data Agent Kit in der Aktivitätsleiste angezeigt.

Sie können die Erweiterung auch über den Visual Studio Marketplace installieren.

Antigravity

Klicken Sie, um die Anleitung für das Antigravity-Tool zu maximieren, das Sie verwenden.

Antigravity IDE

Wenn Sie das Data Agent Kit in der Antigravity IDE verwenden möchten, müssen Sie die Erweiterung installieren.

  1. Klicken Sie in der IDE auf Erweiterungen oder drücken Sie Ctrl/Cmd+Shift+X.
  2. Suchen Sie nach Google Cloud Data Agent Kit.
  3. Klicken Sie auf Installieren.
  4. Starten Sie Ihre IDE neu, wenn Sie dazu aufgefordert werden. Nach erfolgreicher Installation der Erweiterung wird das Symbol für das Google Cloud Data Agent Kit in der Aktivitätsleiste angezeigt.

Antigravity CLI

Wenn Sie das Data Agent Kit mit der Antigravity CLI verwenden möchten, installieren Sie das Plug-in. Führen Sie im Terminal den folgenden Befehl aus:

agy plugin install https://github.com/GoogleCloudPlatform/data-agent-kit-plugin

Antigravity 2.0

Wenn Sie das Data Agent Kit mit der Antigravity CLI verwenden möchten, installieren Sie das Plug-in.

  1. Klicken Sie auf Einstellungen.
  2. Klicken Sie im Bereich Einstellungen auf Anpassungen.
  3. Suchen Sie nach Build with Google Plugins und klicken Sie auf Customize (Anpassen).
  4. Suchen Sie in der Liste nach Google Cloud Data Agent Kit und klicken Sie auf Herunterladen.

Antigravity-Erweiterung für VS Code

So verwenden Sie das Data Agent Kit in VS Code, wenn Sie die Antigravity for VS Code-Erweiterung verwenden:

  1. Klicken Sie in der VS Code-Statusleiste auf Antigravity – Einstellungen.
  2. Klicken Sie im Bereich Einstellungen auf Anpassungen.
  3. Suchen Sie nach Build with Google Plugins und klicken Sie auf Customize (Anpassen).
  4. Suchen Sie in der Liste nach Google Cloud Data Agent Kit und klicken Sie auf Herunterladen.

Claude Code – CLI

Wenn Sie das Data Agent Kit mit der Claude Code-Befehlszeile verwenden möchten, installieren Sie das Plug-in. Führen Sie im Terminal den folgenden Befehl aus:

claude plugin marketplace add https://github.com/GoogleCloudPlatform/data-agent-kit-plugin
claude plugin install dak@dak-marketplace

Codex CLI

Wenn Sie das Data Agent Kit mit der Codex-Befehlszeile verwenden möchten, installieren Sie das Plug-in. Führen Sie im Terminal die folgenden Befehle aus:

codex plugin marketplace add GoogleCloudPlatform/data-agent-kit-plugin
codex plugin add dak@dak-marketplace

Cursor

Wenn Sie das Data Agent Kit in Cursor verwenden möchten, müssen Sie die Erweiterung installieren.

  1. Klicken Sie in der IDE auf Erweiterungen oder drücken Sie Ctrl/Cmd+Shift+X.
  2. Suchen Sie nach Google Cloud Data Agent Kit.
  3. Klicken Sie auf Installieren.
  4. Starten Sie Ihre IDE neu, wenn Sie dazu aufgefordert werden. Nach erfolgreicher Installation der Erweiterung wird das Symbol für das Google Cloud Data Agent Kit in der Aktivitätsleiste angezeigt.

Auf VS Code basierende IDEs

Wenn Sie das Data Agent Kit mit anderen IDEs verwenden möchten, die auf VS Code basieren, installieren Sie die Erweiterung.

  1. Klicken Sie in der IDE auf Erweiterungen oder drücken Sie Ctrl/Cmd+Shift+X.
  2. Suchen Sie nach Google Cloud Data Agent Kit.
  3. Klicken Sie auf Installieren.
  4. Starten Sie Ihre IDE neu, wenn Sie dazu aufgefordert werden. Nach erfolgreicher Installation der Erweiterung wird das Symbol für das Google Cloud Data Agent Kit in der Aktivitätsleiste angezeigt.

Im Data Agent Kit anmelden

Nach der Installation der Erweiterung oder des Plug-ins müssen Sie sich anmelden.

Anmeldung für Erweiterungen

Wenn Sie die IDE-Erweiterung installiert haben, müssen Sie sich beim Google Cloud Data Agent Kit authentifizieren.

  1. Wenn das Anmeldedialogfeld nicht automatisch geöffnet wird, suchen Sie in der Statusleiste unten im IDE-Fenster nach einem Anmeldelink für das Google Cloud Data Agent Kit und klicken Sie darauf.

    Alternativ können Sie Ctrl/Cmd+Shift+P drücken, um die Befehlspalette zu öffnen, nach Google Cloud Data Agent Kit: Sign in suchen und diese Option auswählen.

  2. Folgen Sie der Anleitung, um die Anmeldung abzuschließen.

    Eine Webseite wird angezeigt, die bestätigt, dass die Authentifizierung abgeschlossen ist.

  3. Schließen Sie die Seite und kehren Sie zur IDE zurück.

Plug‑in-Anmeldung

Installieren Sie die Google Cloud CLI und melden Sie sich an. Das Data Agent Kit-Plug-in verwendet Anmeldedaten aus den gcloud CLI-Anmeldedaten und den Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC).

  1. Öffnen Sie das Terminal auf Ihrem lokalen Computer oder in Ihrer IDE.
  2. Wenn Sie die gcloud CLI noch nicht installiert haben, folgen Sie der Anleitung unter gcloud CLI installieren, um die gcloud CLI herunterzuladen und zu installieren.
  3. Führen Sie im Terminal gcloud init aus, um die gcloud CLI zu initialisieren: 
    gcloud init
  4. Führen Sie den folgenden Befehl aus und folgen Sie der Anleitung, um sich zu authentifizieren und Standardanmeldedaten für Anwendungen einzurichten: 
    gcloud auth login && gcloud auth application-default login
  5. Aktualisieren Sie die gcloud CLI auf die neueste Version: 
    gcloud components update

Fehlerbehebung

Wenn Probleme auftreten, melden Sie sich ab und dann wieder an. Weitere Methoden zur Diagnose und Behebung von Installationsfehlern finden Sie unter Fehlerbehebung.

Nächste Schritte