Referensi resource

Halaman ini menjelaskan cara mereferensikan Google Cloud resource data saat menggunakan Google Cloud Data Agent Kit. Anda dapat mereferensikan resource di lingkungan pengembangan atau agen coding yang didukung menggunakan referensi eksplisit atau implisit, bergantung pada lingkungan dan agen yang Anda gunakan.

  • Referensi eksplisit. Anda secara eksplisit mengidentifikasi resource dalam chat atau antarmuka pengguna, seperti dengan mengetik @RESOURCE_NAME, memilih resource dari menu resource Model Context Protocol (MCP), atau menggunakan tarik lalu lepas.
  • Referensi implisit. Anda merujuk ke resource melalui konteks bahasa alami dalam chat, seperti mengetik "this table" atau "this dataset", yang merujuk ke resource yang terbuka atau dipilih.

Metode perujukan

Jika lingkungan pengembangan dan agen coding Anda mendukung referensi, Anda dapat mereferensikan resource data dengan cara berikut:

  • Penyebutan chat: Di antarmuka chat yang didukung, ketik @, diikuti dengan nama atau ID resource (misalnya, @DATASET_NAME) untuk melampirkan konteks resource secara eksplisit ke perintah Anda.
  • Menu resource MCP: Pilih resource langsung dari pemilih resource Model Context Protocol (MCP) di IDE Anda.
  • Tarik lalu lepas: Tarik aset data dari hierarki penjelajah langsung ke jendela chat atau editor.
  • Referensi bahasa alami: Di lingkungan yang mendukung referensi implisit, gunakan frasa kontekstual seperti "this table" atau "this dataset" agar agen secara otomatis menyimpulkan resource aktif.

Tabel berikut menjelaskan metode pembuatan referensi yang didukung untuk setiap lingkungan pengembangan dan agen coding.

Lingkungan pengembangan atau agen Sebutan chat (@) Menu resource MCP Tarik lalu lepas Bahasa alami
VS Code (GitHub Copilot), Cursor, Antigravity IDE Didukung Didukung Didukung Didukung
CLI Claude Code (mandiri) Didukung Tidak didukung Tidak didukung Didukung
Antigravity 2.0, Antigravity CLI, Claude Code (ekstensi VS Code) Tidak didukung Tidak didukung Tidak didukung Didukung

Resource yang didukung

Tabel berikut menjelaskan sintaksis referensi dan frasa bahasa alami untuk resource Google Cloud yang didukung di seluruh layanan.

  1. Nama tabel parsial juga didukung.
  2. Di Claude Code CLI, gunakan @SESSION_ID.
  3. Di Claude Code CLI, gunakan @BATCH_ID. Referensi implisit tidak didukung.
Layanan Resource Sintaksis sebutan chat (@) Referensi bahasa alami
BigQuery Set data1 @DATASET_NAME "this dataset"
  Tabel @TABLE_NAME "this table"
  Lihat @VIEW_NAME "this view"
AlloyDB untuk PostgreSQL, Cloud SQL, Spanner Tabel @TABLE_NAME "this table"
  Lihat @VIEW_NAME "this view"
Spark Cluster @CLUSTER_NAME "this cluster"
  Runtime serverless @RUNTIME_NAME "this runtime"
  Tugas @JOB_NAME "this job"
  Sesi interaktif2 @SESSION_NAME "this session"
  Batch3 @BATCH_NAME Tidak didukung

Langkah berikutnya