Ressources de référence

Cette page explique comment référencer les ressources de données Google Cloud lorsque vous utilisez le kit d'agent de données Google Cloud. Vous pouvez faire référence à des ressources dans votre environnement de développement ou votre agent de programmation compatible à l'aide de références explicites ou implicites, selon l'environnement et l'agent que vous utilisez.

  • Références explicites : Vous identifiez explicitement une ressource dans le chat ou l'interface utilisateur, par exemple en saisissant @RESOURCE_NAME, en sélectionnant une ressource dans le menu des ressources MCP (Model Context Protocol) ou en utilisant le glisser-déposer.
  • Références implicites : Vous pouvez faire référence à une ressource en utilisant le langage naturel dans le chat, par exemple en saisissant "this table" ou "this dataset", en référence à la ressource ouverte ou sélectionnée.

Méthodes de référencement

Si votre environnement de développement et votre agent de codage acceptent les références, vous pouvez faire référence à des ressources de données de différentes manières :

  • Mentions dans le chat : dans les interfaces de chat compatibles, saisissez @ suivi du nom ou de l'ID de la ressource (par exemple, @DATASET_NAME) pour associer explicitement le contexte de la ressource à votre requête.
  • Menu des ressources MCP : sélectionnez une ressource directement dans le sélecteur de ressources MCP (Model Context Protocol) de votre IDE.
  • Glisser-déposer : faites glisser un composant de données de l'arborescence de l'explorateur directement dans la fenêtre de chat ou de l'éditeur.
  • Référence en langage naturel : dans les environnements qui acceptent les références implicites, utilisez des expressions contextuelles telles que "this table" ou "this dataset" pour que l'agent déduise automatiquement la ressource active.

Le tableau suivant décrit les méthodes de référencement compatibles pour chaque environnement de développement et agent de codage.

Environnement de développement ou agent Mention dans Chat (@) Menu des ressources MCP Glisser-déposer Langage naturel
VS Code (GitHub Copilot), Cursor, Antigravity IDE Compatible Compatible Compatible Compatible
CLI Claude Code (autonome) Compatible Non compatible Non compatible Compatible
Antigravity 2.0, CLI Antigravity, Claude Code (extension VS Code) Non compatible Non compatible Non compatible Compatible

Ressources compatibles

Le tableau suivant décrit la syntaxe de référence et les expressions en langage naturel pour les ressources Google Cloud compatibles dans les services.

  1. Les noms de table partiels sont également acceptés.
  2. Dans la CLI Claude Code, utilisez @SESSION_ID.
  3. Dans la CLI Claude Code, utilisez @BATCH_ID. Le référencement implicite n'est pas accepté.
Service Ressource Syntaxe des mentions dans Chat (@) Documentation de référence sur le langage naturel
BigQuery Ensemble de données1 @DATASET_NAME "this dataset"
  Table @TABLE_NAME "this table"
  Afficher @VIEW_NAME "this view"
AlloyDB pour PostgreSQL, Cloud SQL, Spanner Table @TABLE_NAME "this table"
  Afficher @VIEW_NAME "this view"
Spark Cluster @CLUSTER_NAME "this cluster"
  Environnement d'exécution sans serveur @RUNTIME_NAME "this runtime"
  Job @JOB_NAME "this job"
  Session interactive2 @SESSION_NAME "this session"
  Lot3 @BATCH_NAME Non compatible

Étapes suivantes