本頁說明使用 Google Cloud Data Agent Kit 時，如何參照 Google Cloud 資料資源 。您可以在開發環境或支援的程式碼代理程式中，使用明確或隱含參照來參照資源，具體做法取決於您使用的環境和代理程式。
- 明確參照。在即時通訊或使用者介面中明確指出資源，例如輸入
@RESOURCE_NAME、從 Model Context Protocol (MCP) 資源選單中選取資源，或是使用拖曳功能。 - 隱含參照。在對話中，您可以透過自然語言參照資源，例如輸入
"this table"或"this dataset"，參照開啟或選取的資源。
參照方法
如果開發環境和程式碼編寫代理程式支援參照，您可以透過下列方式參照資料資源：
- 對話提及：在支援的對話介面中，輸入
@，然後輸入資源名稱或 ID (例如@DATASET_NAME)，即可將資源內容明確附加至提示。 - MCP 資源選單：直接從 IDE 的 Model Context Protocol (MCP) 資源挑選器選取資源。
- 拖曳：將資料資產從探索工具樹狀結構直接拖曳到對話或編輯器視窗。
- 自然語言參照：在支援隱含參照的環境中，使用
"this table"或"this dataset"等情境式片語，讓代理程式自動推斷有效資源。
下表說明各開發環境和編碼代理程式支援的參照方法。
| 開發環境或代理程式 | 在對話中提及他人 (@) | MCP 資源選單 | 拖曳 | 自然語言 |
|---|---|---|---|---|
| VS Code (GitHub Copilot)、Cursor、Antigravity IDE | 支援 | 支援 | 支援 | 支援 |
| Claude Code CLI (獨立) | 支援 | 不支援 | 不支援 | 支援 |
| Antigravity 2.0、Antigravity CLI、Claude Code (VS Code 擴充功能) | 不支援 | 不支援 | 不支援 | 支援 |
支援的資源
下表說明各項服務支援的 Google Cloud 資源參照語法和自然語言片語。
|
|||
| 服務 | 資源 | Chat 提及語法 (@) | 自然語言參考資料 |
|---|---|---|---|
| BigQuery | 資料集1 | @DATASET_NAME |
"this dataset" |
| 資料表 | @TABLE_NAME |
"this table" |
|
| 查看 | @VIEW_NAME |
"this view" |
|
| PostgreSQL 適用的 AlloyDB、Cloud SQL、Spanner | 資料表 | @TABLE_NAME |
"this table" |
| 查看 | @VIEW_NAME |
"this view" |
|
| Spark | 叢集 | @CLUSTER_NAME |
"this cluster" |
| 無伺服器執行階段 | @RUNTIME_NAME |
"this runtime" |
|
| 工作 | @JOB_NAME |
"this job" |
|
| 互動式工作階段2 | @SESSION_NAME |
"this session" |
|
| 批次3 | @BATCH_NAME |
不支援 | |