Einstellungen einrichten und konfigurieren

In diesem Dokument wird beschrieben, wie Sie die Ersteinrichtung nach der Installation der IDE-Erweiterung für das Google Cloud Data Agent Kit konfigurieren.

Hinweis

Führen Sie zuerst die Schritte unter Data Agent Kit installieren aus, einschließlich der Auswahl der Dienste, die Sie verwenden möchten. In den Abschnitten des Google Cloud Data Agent Kit-Menüs für Dienste, die Sie nicht ausgewählt haben, wird Integration ist nicht aktiviert angezeigt, bis Sie sie auswählen.

Google Cloud Projekt und Region konfigurieren

Wenn Sie Ihr Projekt und Ihre Region noch nicht konfiguriert haben, gehen Sie so vor:

  1. Klicken Sie zum Öffnen des Editors für Data Cloud-Einstellungen in der Aktivitätsleiste auf das Symbol Google Cloud Data Agent Kit.
  2. Maximieren Sie die Einstellungen und klicken Sie dann auf Einstellungen.
  3. Wählen Sie Häufig aus.
  4. Wählen Sie Ihre Projekt-ID und Region aus. Die Projekt-ID muss mit der Projekt-ID übereinstimmen, die Sie in der gcloud CLI angegeben haben.
  5. Klicken Sie auf Speichern.

Erforderliche Rollen prüfen

Das Data Agent Kit prüft Ihre IAM-Rollen (Identity and Access Management), wenn Sie die Dienste auswählen, die Sie verwenden möchten.

  1. Klicken Sie zum Öffnen des Editors für Data Cloud-Einstellungen in der Aktivitätsleiste auf das Symbol Google Cloud Data Agent Kit.
  2. Maximieren Sie die Einstellungen und klicken Sie dann auf Einstellungen.
  3. Klicken Sie auf Service Integrations (Serviceintegrationen).

  4. Wählen Sie die Dienste aus, die Sie verwenden möchten, und klicken Sie auf Weiter.

    Wenn Ihnen erforderliche Rollen oder APIs fehlen, wird die Seite Fehlende Berechtigungen geöffnet. Darin sind die empfohlenen IAM-Berechtigungen für jeden ausgewählten Dienst und die APIs aufgeführt, die aktiviert werden müssen.

  5. Wenn Sie fehlende Berechtigungen erhalten möchten, die Sie für die Verwendung des Data Agent Kit benötigen, klicken Sie auf E‑Mail-Liste, um die Liste an Ihren Administrator zu senden, oder auf Liste kopieren. Bitten Sie Ihren Administrator, Ihnen die entsprechenden IAM-Rollen für das Projekt zuzuweisen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

BigQuery-Region konfigurieren

  1. Klicken Sie zum Öffnen des Editors für Data Cloud-Einstellungen in der Aktivitätsleiste auf das Symbol Google Cloud Data Agent Kit.
  2. Maximieren Sie die Einstellungen und klicken Sie dann auf Einstellungen.
  3. Wählen Sie BigQuery aus.
  4. Wählen Sie eine BigQuery-Region aus.
  5. Klicken Sie auf Speichern.

Serverless-Laufzeiten für Apache Spark ansehen

  1. Klicken Sie zum Öffnen des Editors für Data Cloud-Einstellungen in der Aktivitätsleiste auf das Symbol Google Cloud Data Agent Kit.
  2. Maximieren Sie die Einstellungen und klicken Sie dann auf Einstellungen.
  3. Wählen Sie Apache Spark aus. Alle serverlosen Runtimes für Ihr Projekt werden angezeigt.
  4. Wenn Sie sich die Konfiguration einer serverlosen Laufzeit ansehen möchten, klicken Sie auf ihren Namen.

Serverless-Laufzeit für Apache Spark erstellen

  1. Klicken Sie zum Öffnen des Editors für Data Cloud-Einstellungen in der Aktivitätsleiste auf das Symbol Google Cloud Data Agent Kit.
  2. Maximieren Sie die Einstellungen und klicken Sie dann auf Einstellungen.
  3. Wählen Sie Apache Spark aus.
  4. Klicken Sie auf Erstellen.
  5. Füllen Sie die Felder aus und klicken Sie dann auf Speichern.

Serverless Runtime for Apache Spark löschen

  1. Klicken Sie zum Öffnen des Editors für Data Cloud-Einstellungen in der Aktivitätsleiste auf das Symbol Google Cloud Data Agent Kit.
  2. Maximieren Sie die Einstellungen und klicken Sie dann auf Einstellungen.
  3. Wählen Sie Apache Spark aus.
  4. Klicken Sie bei der serverlosen Laufzeit, die Sie löschen möchten, auf Löschen.

Planer einrichten

  1. Klicken Sie zum Öffnen des Editors für die Einstellungen des Google Cloud Data Agent Kit in der Aktivitätsleiste auf das Symbol Google Cloud Data Agent Kit.
  2. Maximieren Sie die Einstellungen und klicken Sie dann auf Einstellungen.
  3. Klicken Sie auf Scheduler (Planer).
  4. Wählen Sie ein Projekt und eine Region aus. Das Projekt und die Region müssen nicht mit dem Projekt und der Region übereinstimmen, die Sie auf dem Tab „Allgemein“ ausgewählt haben.
  5. Wählen Sie eine Managed Service for Apache Airflow-Umgebung aus, um Workflows einzurichten.
  6. Klicken Sie auf Speichern.

Abhängigkeiten installieren

Für einige Vorgänge im Google Cloud Data Agent Kit müssen Sie zusätzliche Software installieren, nachdem Sie die Erweiterung installiert haben. In einigen Fällen werden Sie aufgefordert, der automatischen Installation zuzustimmen. In anderen Fällen müssen Sie die Software manuell installieren.

Orchestration Pipelines

Wenn Sie Orchestration Pipelines in Ihrer IDE verwenden möchten, installieren Sie Folgendes:

Notebooks

Die von Google Cloud Data Agent Kit generierten Notebooks enthalten eine auskommentierte %pip install --upgrade bigframes-Zelle. Wenn BigQuery DataFrames nicht in Ihrem Kernel installiert ist, entfernen Sie die Auskommentierung der Zelle und führen Sie sie aus, bevor Sie den Rest des Notebooks ausführen.

Damit der Agent Codezellen in Ihren Notebooks ausführen kann, können Sie die Einstellung google.datacloud.executeCellToolForNotebookMCP in den IDE-Einstellungen aktivieren. Mit dieser Einstellung wird das execute_cell-Tool für das Notebook Model Context Protocol (MCP) aktiviert.

Fehlerbehebung

Wenn Probleme auftreten, melden Sie sich vom Google Cloud Data Agent Kit und der gcloud CLI ab und dann wieder an. Weitere Methoden zur Diagnose und Behebung von Konfigurationsfehlern finden Sie unter Fehlerbehebung beim Data Agent Kit.

Problem melden

So melden Sie ein Problem:

  1. Klicken Sie in der Aktivitätsleiste im Menü „Google Cloud Data Agent Kit“ auf Fehler melden.
  2. Dokumentieren Sie das Problem im angezeigten Formular und klicken Sie auf Senden.

Nächste Schritte