> [!WARNING]
>
> **Preview**
>
>
> This product is
>
> subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the
> [Service Specific
> Terms](https://docs.cloud.google.com/terms/service-terms#1), and the
> [Additional Terms for Generative AI
> Preview Products](https://cloud.google.com/trustedtester/aitos).
>
> Pre-GA products are available "as is" and might have limited support.
>
> For more information, see the
> [launch stage descriptions](https://cloud.google.com/products/#product-launch-stages).

This page describes how to reference Google Cloud data resources
when working with Google Cloud Data Agent Kit. You can reference resources in your
development environment or supported coding agent using explicit or implicit
referencing, depending on the environment and agent that you use.

- **Explicit referencing** . You explicitly identify a resource in chat or the user interface, such as by typing `@RESOURCE_NAME`, selecting a resource from the Model Context Protocol (MCP) resource menu, or using drag-and-drop.
- **Implicit referencing** . You refer to a resource through natural language context in chat, such as typing `"this table"` or `"this dataset"`, referring to the open or selected resource.

## Referencing methods

If your development environment and coding agent support referencing, you can
reference data resources in the following ways:

- **Chat mentions** : In supported chat interfaces, type `@` followed by the resource name or ID (for example, `@DATASET_NAME`) to explicitly attach the resource context to your prompt.
- **MCP resource menu**: Select a resource directly from the Model Context Protocol (MCP) resource picker in your IDE.
- **Drag-and-drop**: Drag a data asset from the explorer tree directly into the chat or editor window.
- **Natural language reference** : In environments that support implicit referencing, use contextual phrases like `"this table"` or `"this dataset"` to have the agent automatically infer the active resource.

The following table describes the supported referencing methods for each
development environment and coding agent.

| Development environment or agent | Chat mention (@) | MCP resource menu | Drag-and-drop | Natural language |
|---|---|---|---|---|
| VS Code (GitHub Copilot), Cursor, Antigravity IDE | Supported | Supported | Supported | Supported |
| Claude Code CLI (standalone) | Supported | Not supported | Not supported | Supported |
| Antigravity 2.0, Antigravity CLI, Claude Code (VS Code extension) | Not supported | Not supported | Not supported | Supported |

## Supported resources

The following table describes the referencing syntax and natural language
phrases for supported Google Cloud resources across services.

| Service | Resource | Chat mention syntax (@) | Natural language reference |
|---|---|---|---|
| BigQuery | Dataset^1^ | `@DATASET_NAME` | `"this dataset"` |
|   | Table | `@TABLE_NAME` | `"this table"` |
|   | View | `@VIEW_NAME` | `"this view"` |
| AlloyDB for PostgreSQL, Cloud SQL, Spanner | Table | `@TABLE_NAME` | `"this table"` |
|   | View | `@VIEW_NAME` | `"this view"` |
| Spark | Cluster | `@CLUSTER_NAME` | `"this cluster"` |
|   | Serverless runtime | `@RUNTIME_NAME` | `"this runtime"` |
|   | Job | `@JOB_NAME` | `"this job"` |
|   | Interactive session^2^ | `@SESSION_NAME` | `"this session"` |
|   | Batch^3^ | `@BATCH_NAME` | Not supported |

## What's next

- [Find and explore data](https://docs.cloud.google.com/data-agent-kit/find-explore-data)
- [Query your data](https://docs.cloud.google.com/data-agent-kit/query-data)
- [Use MCP servers](https://docs.cloud.google.com/data-agent-kit/use-mcp-servers)