本页介绍了在使用 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"等上下文短语，让代理自动推断出有效资源。
下表介绍了每种开发环境和编码代理支持的引用方法。
| 开发环境或代理 | Chat 提及 (@) | 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" |
|
| AlloyDB for PostgreSQL、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 |
不支持 | |