Questa pagina descrive come fare riferimento alle risorse di dati Google Cloud quando utilizzi Google Cloud Data Agent Kit. Puoi fare riferimento alle risorse nel tuo ambiente di sviluppo o nell'agente di programmazione supportato utilizzando riferimenti espliciti o impliciti, a seconda dell'ambiente e dell'agente che utilizzi.
- Riferimento esplicito. Identifichi esplicitamente una risorsa nella chat o nell'interfaccia utente, ad esempio digitando
@RESOURCE_NAME, selezionando una risorsa dal menu delle risorse Model Context Protocol (MCP) o utilizzando il trascinamento. - Riferimento implicito. Fai riferimento a una risorsa tramite il contesto del linguaggio naturale
nella chat, ad esempio digitando
"this table"o"this dataset", facendo riferimento alla risorsa aperta o selezionata.
Metodi di riferimento
Se l'ambiente di sviluppo e l'agente di codifica supportano i riferimenti, puoi fare riferimento alle risorse di dati nei seguenti modi:
- Menzioni nella chat: nelle interfacce di chat supportate, digita
@seguito dal nome o dall'ID della risorsa (ad esempio,@DATASET_NAME) per allegare esplicitamente il contesto della risorsa al prompt. - Menu delle risorse MCP: seleziona una risorsa direttamente dal selettore di risorse Model Context Protocol (MCP) nel tuo IDE.
- Trascina: trascina una risorsa di dati dall'albero dell'explorer direttamente nella finestra della chat o dell'editor.
- Riferimento in linguaggio naturale: negli ambienti che supportano i riferimenti impliciti, utilizza frasi contestuali come
"this table"o"this dataset"per consentire all'agente di dedurre automaticamente la risorsa attiva.
La tabella seguente descrive i metodi di riferimento supportati per ciascun ambiente di sviluppo e agente di codifica.
| Ambiente di sviluppo o agente | Menzione nella chat (@) | Menu delle risorse MCP | Trascina | Linguaggio naturale |
|---|---|---|---|---|
| VS Code (GitHub Copilot), Cursor, Antigravity IDE | Supportato | Supportato | Supportato | Supportato |
| CLI Claude Code (standalone) | Supportato | Non supportata | Non supportata | Supportato |
| Antigravity 2.0, Antigravity CLI, Claude Code (estensione VS Code) | Non supportata | Non supportata | Non supportata | Supportato |
Risorse supportate
La tabella seguente descrive la sintassi di riferimento e le frasi in linguaggio naturale per le risorse Google Cloud supportate nei vari servizi.
|
|||
| Servizio | Risorsa | Sintassi delle menzioni nella chat (@) | Riferimento al linguaggio naturale |
|---|---|---|---|
| BigQuery | Set di dati1 | @DATASET_NAME |
"this dataset" |
| Tabella | @TABLE_NAME |
"this table" |
|
| Visualizza | @VIEW_NAME |
"this view" |
|
| AlloyDB per PostgreSQL, Cloud SQL, Spanner | Tabella | @TABLE_NAME |
"this table" |
| Visualizza | @VIEW_NAME |
"this view" |
|
| Spark | Cluster | @CLUSTER_NAME |
"this cluster" |
| Runtime serverless | @RUNTIME_NAME |
"this runtime" |
|
| Job | @JOB_NAME |
"this job" |
|
| Sessione interattiva2 | @SESSION_NAME |
"this session" |
|
| Batch3 | @BATCH_NAME |
Non supportata | |