Installer Data Agent Kit

Google Cloud Data Agent Kit vous permet de travailler avec vos ressources de données Google Cloud dans l'IDE ou l'environnement de codage agentique de votre choix. Selon votre configuration, vous installez une extension ou un plug-in IDE.

Le Data Agent Kit est préinstallé avec les services Google Cloudsuivants :

  • Cloud Shell
  • Cloud Workstations

Avant de commencer

Avant d'installer le Data Agent Kit, procédez comme suit.

Configurer votre environnement local

Sur votre ordinateur local, installez votre IDE ou agent de programmation préféré, ainsi que Node.js.

  1. Installez et configurez votre IDE, votre CLI agentique ou votre agent de codage. Si elle est déjà installée, mettez-la à jour pour obtenir la dernière version.
  2. Installez Node.js.

Configurer Google Cloud

  1. Si ce n'est pas déjà fait, créez un projet Google Cloud .
  2. Activez la facturation.

Rôles requis

Le Data Agent Kit vous avertit lorsque vous avez besoin d'autorisations supplémentaires pour accomplir une tâche. Vous n'avez besoin d'autorisations que pour les services que vous utilisez. Pour obtenir la liste complète des autorisations et des API requises pour chaque service du Data Agent Kit, consultez Autorisations.

Installer l'extension ou le plug-in

La procédure d'installation dépend de l'IDE ou de l'agent de codage que vous utilisez.

VS Code

Pour utiliser Data Agent Kit dans VS Code, installez l'extension :

  1. Dans l'IDE, cliquez sur Extensions ou appuyez sur Ctrl/Cmd+Shift+X.
  2. Recherchez Google Cloud Data Agent Kit.
  3. Cliquez sur Installer.
  4. Si vous y êtes invité, redémarrez votre IDE. Une fois l'extension correctement installée, l'icône Google Cloud Data Agent Kit est ajoutée à la barre d'activité.

Vous pouvez également installer l'extension depuis Visual Studio Marketplace.

Antigravity

Cliquez pour développer les instructions concernant l'outil Antigravity que vous utilisez.

IDE Antigravity

Pour utiliser Data Agent Kit dans l'IDE Antigravity, installez l'extension.

  1. Dans l'IDE, cliquez sur Extensions ou appuyez sur Ctrl/Cmd+Shift+X.
  2. Recherchez Google Cloud Data Agent Kit.
  3. Cliquez sur Installer.
  4. Si vous y êtes invité, redémarrez votre IDE. Une fois l'extension correctement installée, l'icône Google Cloud Data Agent Kit est ajoutée à la barre d'activité.

CLI Antigravity

Pour utiliser Data Agent Kit avec la CLI Antigravity, installez le plug-in. Dans le terminal, exécutez la commande suivante :

agy plugin install https://github.com/GoogleCloudPlatform/data-agent-kit-plugin

Antigravity 2.0

Pour utiliser Data Agent Kit avec la CLI Antigravity, installez le plug-in.

  1. Cliquez sur Paramètres.
  2. Dans le volet Paramètres, cliquez sur Personnalisations.
  3. Recherchez Compiler avec les plug-ins Google, puis cliquez sur Personnaliser.
  4. Recherchez Google Cloud Data Agent Kit dans la liste, puis cliquez sur Télécharger.

Extension Antigravity pour VS Code

Pour utiliser Data Agent Kit dans VS Code lorsque vous utilisez l'extension Antigravity pour VS Code, procédez comme suit :

  1. Dans la barre d'état VS Code, cliquez sur Antigravity - Paramètres.
  2. Dans le volet Paramètres, cliquez sur Personnalisations.
  3. Recherchez Compiler avec les plug-ins Google, puis cliquez sur Personnaliser.
  4. Recherchez Google Cloud Data Agent Kit dans la liste, puis cliquez sur Télécharger.

Interface de ligne de commande Claude Code

Pour utiliser Data Agent Kit avec la CLI Claude Code, installez le plug-in. Exécutez la commande suivante dans votre terminal :

claude plugin install data-agent-kit-starter-pack@claude-plugins-official

Codex CLI

Pour utiliser Data Agent Kit avec la CLI Codex, installez le plug-in. Exécutez les commandes suivantes dans votre terminal :

codex plugin marketplace add GoogleCloudPlatform/data-agent-kit-plugin
codex plugin add dak@dak-marketplace

Cursor

Pour utiliser Data Agent Kit dans Cursor, installez l'extension.

  1. Dans l'IDE, cliquez sur Extensions ou appuyez sur Ctrl/Cmd+Shift+X.
  2. Recherchez Google Cloud Data Agent Kit.
  3. Cliquez sur Installer.
  4. Si vous y êtes invité, redémarrez votre IDE. Une fois l'extension correctement installée, l'icône Google Cloud Data Agent Kit est ajoutée à la barre d'activité.

IDE basés sur VS Code

Pour utiliser Data Agent Kit avec tous les autres IDE basés sur VS Code, installez l'extension.

  1. Dans l'IDE, cliquez sur Extensions ou appuyez sur Ctrl/Cmd+Shift+X.
  2. Recherchez Google Cloud Data Agent Kit.
  3. Cliquez sur Installer.
  4. Si vous y êtes invité, redémarrez votre IDE. Une fois l'extension correctement installée, l'icône Google Cloud Data Agent Kit est ajoutée à la barre d'activité.

Se connecter à Data Agent Kit

Après avoir installé l'extension ou le plug-in, vous devez vous connecter.

Connexion à l'extension

Si vous avez installé l'extension IDE, vous devez vous authentifier auprès de Google Cloud Data Agent Kit.

  1. Si la boîte de dialogue Connexion ne s'ouvre pas automatiquement, recherchez un lien de connexion Google Cloud Data Agent Kit dans la barre d'état en bas de la fenêtre de l'IDE, puis cliquez dessus.

    Vous pouvez également appuyer sur Ctrl/Cmd+Shift+P pour ouvrir la palette de commandes, rechercher et sélectionner Google Cloud Data Agent Kit: Sign in (Google Cloud Data Agent Kit : se connecter).

  2. Suivez les instructions et connectez-vous.

    Une page Web confirmant que l'authentification est terminée s'affiche.

  3. Fermez la page et revenez à l'IDE.

Connexion au plug-in

Installez la Google Cloud CLI et connectez-vous. Le plug-in Data Agent Kit utilise les identifiants de gcloud CLI et les identifiants par défaut de l'application (ADC).

  1. Ouvrez le terminal sur votre machine locale ou dans votre IDE.
  2. Si vous n'avez pas encore installé la gcloud CLI, suivez les étapes décrites dans Installer la gcloud CLI pour la télécharger et l'installer.
  3. Dans le terminal, exécutez gcloud init pour initialiser gcloud CLI : 
    gcloud init
  4. Exécutez la commande suivante et suivez les instructions pour vous authentifier et configurer les identifiants par défaut de l'application : 
    gcloud auth login && gcloud auth application-default login
  5. Mettez à jour gcloud CLI vers la dernière version : 
    gcloud components update

Résoudre les problèmes

Si vous rencontrez des problèmes, essayez de vous déconnecter, puis de vous reconnecter. Pour connaître d'autres méthodes de diagnostic et de résolution des erreurs d'installation, consultez Dépannage.

Étapes suivantes