Referenzressourcen

Auf dieser Seite wird beschrieben, wie Sie beim Arbeiten mit dem Google Cloud Data Agent Kit auf Google Cloud Datenressourcen verweisen. Sie können in Ihrer Entwicklungsumgebung oder Ihrem unterstützten Coding-Agenten explizit oder implizit auf Ressourcen verweisen, je nachdem, welche Umgebung und welcher Agent verwendet werden.

  • Explizite Referenzierung: Sie identifizieren eine Ressource explizit im Chat oder in der Benutzeroberfläche, z. B. durch Eingabe von @RESOURCE_NAME, durch Auswahl einer Ressource aus dem MCP-Ressourcenmenü (Model Context Protocol) oder per Drag-and-drop.
  • Implizite Referenzierung: Sie verweisen in natürlicher Sprache im Chat auf eine Ressource, indem Sie z. B. "this table" oder "this dataset" eingeben. Damit wird auf die geöffnete oder ausgewählte Ressource verwiesen.

Referenzierungsmethoden

Wenn Ihre Entwicklungsumgebung und Ihr Coding-Agent das Referenzieren unterstützen, können Sie Datenressourcen auf folgende Weise referenzieren:

  • Chat-Erwähnungen: Geben Sie in unterstützten Chat-Oberflächen @ gefolgt vom Ressourcennamen oder der ID ein (z. B. @DATASET_NAME), um den Ressourcenkontext explizit an Ihren Prompt anzuhängen.
  • MCP-Ressourcenmenü: Wählen Sie eine Ressource direkt über die MCP-Ressourcenauswahl (Model Context Protocol) in Ihrer IDE aus.
  • Drag-and-drop: Ziehen Sie ein Daten-Asset aus der Explorer-Baumstruktur direkt in das Chat- oder Editorfenster.
  • Referenz in natürlicher Sprache: In Umgebungen, die implizite Referenzierung unterstützen, können Sie Kontextphrasen wie "this table" oder "this dataset" verwenden, damit der Agent die aktive Ressource automatisch ableitet.

In der folgenden Tabelle werden die unterstützten Referenzierungsmethoden für jede Entwicklungsumgebung und jeden Coding-Agent beschrieben.

Entwicklungsumgebung oder KI-Agent Chat-Erwähnung (@) MCP-Ressourcenmenü Drag-and-drop Natürliche Sprache
VS Code (GitHub Copilot), Cursor, Antigravity IDE Unterstützt Unterstützt Unterstützt Unterstützt
Claude Code – CLI (eigenständig) Unterstützt Nicht unterstützt Nicht unterstützt Unterstützt
Antigravity 2.0, Antigravity CLI, Claude Code (VS Code-Erweiterung) Nicht unterstützt Nicht unterstützt Nicht unterstützt Unterstützt

Unterstützte Ressourcen

In der folgenden Tabelle werden die Referenzierungssyntax und die Formulierungen in natürlicher Sprache für unterstützte Google Cloud -Ressourcen in verschiedenen Diensten beschrieben.

  1. Auch ein Teil des Tabellennamens wird unterstützt.
  2. Verwenden Sie in der Claude Code CLI @SESSION_ID.
  3. Verwenden Sie in der Claude Code CLI @BATCH_ID. Implizite Verweise werden nicht unterstützt.
Dienst Ressource Syntax für Erwähnungen im Chat (@) Referenz in natürlicher Sprache
BigQuery Dataset1 @DATASET_NAME "this dataset"
  Tabelle @TABLE_NAME "this table"
  Ansehen @VIEW_NAME "this view"
AlloyDB for PostgreSQL, Cloud SQL, Spanner Tabelle @TABLE_NAME "this table"
  Ansehen @VIEW_NAME "this view"
Spark Cluster @CLUSTER_NAME "this cluster"
  Serverlose Laufzeit @RUNTIME_NAME "this runtime"
  Job @JOB_NAME "this job"
  Interaktive Sitzung2 @SESSION_NAME "this session"
  Batch3 @BATCH_NAME Nicht unterstützt

Nächste Schritte