このページでは、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 |
非対応 | |