Recursos de referencia

En esta página, se describe cómo hacer referencia a los Google Cloud recursos de datos cuando trabajas con el kit de herramientas de Google Cloud Data Agent. Puedes hacer referencia a los recursos en tu entorno de desarrollo o en el agente de programación compatible con referencias explícitas o implícitas, según el entorno y el agente que uses.

  • Referencias explícitas. Identificas explícitamente un recurso en el chat o la interfaz de usuario, por ejemplo, escribiendo @RESOURCE_NAME, seleccionando un recurso en el menú de recursos del Protocolo de contexto del modelo (MCP) o usando la función de arrastrar y soltar.
  • Referencias implícitas. Te refieres a un recurso a través del contexto del lenguaje natural en el chat, por ejemplo, escribiendo "this table" o "this dataset", en referencia al recurso abierto o seleccionado.

Métodos de referencia

Si tu entorno de desarrollo y tu agente de codificación admiten referencias, puedes hacer referencia a los recursos de datos de las siguientes maneras:

  • Menciones en el chat: En las interfaces de chat compatibles, escribe @ seguido del nombre o el ID del recurso (por ejemplo, @DATASET_NAME) para adjuntar de forma explícita el contexto del recurso a tu instrucción.
  • Menú de recursos de MCP: Selecciona un recurso directamente desde el selector de recursos del Protocolo de contexto del modelo (MCP) en tu IDE.
  • Arrastrar y soltar: Arrastra un activo de datos desde el árbol del explorador directamente a la ventana de chat o del editor.
  • Referencia en lenguaje natural: En los entornos que admiten referencias implícitas, usa frases contextuales como "this table" o "this dataset" para que el agente infiera automáticamente el recurso activo.

En la siguiente tabla, se describen los métodos de referencia admitidos para cada entorno de desarrollo y agente de codificación.

Entorno de desarrollo o agente Mención de Chat (@) Menú de recursos del MCP Arrastrar y soltar Lenguaje natural
VS Code (GitHub Copilot), Cursor y el IDE de Antigravity Admitido Compatible Compatible Admitido
CLI de Claude Code (independiente) Admitido No compatible No compatible Admitido
Antigravity 2.0, CLI de Antigravity, Claude Code (extensión de VS Code) No compatible No compatible No compatible Admitido

Recursos admitidos

En la siguiente tabla, se describen la sintaxis de referencia y las frases en lenguaje natural para los recursos de Google Cloud admitidos en todos los servicios.

  1. También se admite el nombre parcial de la tabla.
  2. En la CLI de Claude Code, usa @SESSION_ID.
  3. En la CLI de Claude Code, usa @BATCH_ID. No se admiten las referencias implícitas.
Servicio Recurso Sintaxis de mención en el chat (@) Referencia de lenguaje natural
BigQuery Conjunto de datos1 @DATASET_NAME "this dataset"
  Tabla @TABLE_NAME "this table"
  Ver @VIEW_NAME "this view"
AlloyDB para PostgreSQL, Cloud SQL y Spanner Tabla @TABLE_NAME "this table"
  Ver @VIEW_NAME "this view"
Spark Clúster @CLUSTER_NAME "this cluster"
  Tiempo de ejecución sin servidores @RUNTIME_NAME "this runtime"
  Trabajo @JOB_NAME "this job"
  Sesión interactiva2 @SESSION_NAME "this session"
  Lote3 @BATCH_NAME No compatible

¿Qué sigue?