Recursos de referência

Nesta página, descrevemos como referenciar recursos de dados Google Cloud ao trabalhar com o Google Cloud Data Agent Kit. É possível referenciar recursos no seu ambiente de desenvolvimento ou agente de programação compatível usando referências explícitas ou implícitas, dependendo do ambiente e do agente que você usa.

  • Referência explícita. Você identifica explicitamente um recurso no chat ou na interface do usuário, por exemplo, digitando @RESOURCE_NAME, selecionando um recurso no menu de recursos do Protocolo de Contexto de Modelo (MCP) ou usando a função de arrastar e soltar.
  • Referência implícita. Você se refere a um recurso usando o contexto de linguagem natural no chat, como digitar "this table" ou "this dataset", referindo-se ao recurso aberto ou selecionado.

Métodos de referência

Se o ambiente de desenvolvimento e o agente de programação oferecerem suporte a referências, você poderá referenciar recursos de dados das seguintes maneiras:

  • Menções no chat: em interfaces de chat compatíveis, digite @ seguido do nome ou ID do recurso (por exemplo, @DATASET_NAME) para anexar explicitamente o contexto do recurso ao comando.
  • Menu de recursos do MCP: selecione um recurso diretamente no seletor de recursos do Protocolo de Contexto de Modelo (MCP) no seu ambiente de desenvolvimento integrado.
  • Arrastar e soltar: arraste um recurso de dados da árvore do gerenciador diretamente para a janela de chat ou do editor.
  • Referência em linguagem natural: em ambientes que aceitam referências implícitas, use frases contextuais como "this table" ou "this dataset" para que o agente infira automaticamente o recurso ativo.

A tabela a seguir descreve os métodos de referência compatíveis com cada ambiente de desenvolvimento e agente de programação.

Ambiente de desenvolvimento ou agente Menção no chat (@) Menu de recursos do MCP Arrastar e soltar Linguagem natural
VS Code (GitHub Copilot), Cursor, Antigravity IDE Com suporte Compatível Compatível Com suporte
CLI do Claude Code (independente) Com suporte Sem suporte Sem suporte Com suporte
Antigravity 2.0, CLI do Antigravity, Claude Code (extensão do VS Code) Sem suporte Sem suporte Sem suporte Com suporte

Recursos suportados

A tabela a seguir descreve a sintaxe de referência e as frases em linguagem natural para recursos do Google Cloud compatíveis em todos os serviços.

  1. Também é possível usar um nome parcial.
  2. Na CLI do Claude Code, use @SESSION_ID.
  3. Na CLI do Claude Code, use @BATCH_ID. Não há suporte para referências implícitas.
Serviço Recurso Sintaxe de menção no chat (@) Referência de linguagem natural
BigQuery Conjunto de dados1 @DATASET_NAME "this dataset"
  Tabela @TABLE_NAME "this table"
  Ver @VIEW_NAME "this view"
AlloyDB para PostgreSQL, Cloud SQL e Spanner Tabela @TABLE_NAME "this table"
  Ver @VIEW_NAME "this view"
Spark Cluster @CLUSTER_NAME "this cluster"
  Ambiente de execução sem servidor @RUNTIME_NAME "this runtime"
  Job @JOB_NAME "this job"
  Sessão interativa2 @SESSION_NAME "this session"
  Lote3 @BATCH_NAME Sem suporte

A seguir