Configurer les paramètres

Ce document explique comment configurer les paramètres initiaux après avoir installé l'extension Google Cloud Data Agent Kit pour Visual Studio Code.

Avant de commencer

Avant de commencer, suivez les étapes décrites dans Installer l'extension.

Configurer le projet et la région Google Cloud

Si vous n'avez pas configuré votre projet et votre région, procédez comme suit.

  1. Pour ouvrir l'éditeur des paramètres Data Cloud, cliquez sur l'icône Google Cloud Data Agent Kit dans la barre d'activité.
  2. Développez Settings (Paramètres), puis cliquez sur Settings (Paramètres).
  3. Sélectionnez Common (Commun).
  4. Sélectionnez votre ID de projet et votre région. L'ID du projet doit correspondre à l'ID du projet que vous avez spécifié dans la gcloud CLI.
  5. Cliquez sur Save (Enregistrer).

Vérifier les rôles requis

  1. Pour ouvrir l'éditeur des paramètres Data Cloud, cliquez sur l'icône Google Cloud Data Agent Kit dans la barre d'activité.
  2. Développez Settings (Paramètres), puis cliquez sur Settings (Paramètres).

  3. Accédez à Common (Commun) > Required Permissions (Autorisations requises).

    La colonne Access (Accès) indique si vous êtes un compte principal dans un rôle requis.

  4. Pour obtenir les autorisations manquantes dont vous avez besoin pour utiliser l'extension Data Agent Kit pour VS Code, demandez à votre administrateur de vous accorder les rôles IAM (Identity and Access Management) correspondants sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Configurer la région BigQuery

  1. Pour ouvrir l'éditeur des paramètres Data Cloud, cliquez sur l'icône Google Cloud Data Agent Kit dans la barre d'activité.
  2. Développez Settings (Paramètres), puis cliquez sur Settings (Paramètres).
  3. Sélectionnez BigQuery.
  4. Sélectionnez une région BigQuery.
  5. Cliquez sur Save (Enregistrer).

Afficher les environnements d'exécution sans serveur pour Apache Spark

  1. Pour ouvrir l'éditeur des paramètres Data Cloud, cliquez sur l'icône Google Cloud Data Agent Kit dans la barre d'activité.
  2. Développez Settings (Paramètres), puis cliquez sur Settings (Paramètres).
  3. Sélectionnez Apache Spark. Tous les environnements d'exécution sans serveur de votre projet s'affichent.
  4. Pour afficher la configuration d'un environnement d'exécution sans serveur, cliquez sur son nom.

Créer un environnement d'exécution sans serveur pour Apache Spark

  1. Pour ouvrir l'éditeur des paramètres Data Cloud, cliquez sur l'icône Google Cloud Data Agent Kit dans la barre d'activité.
  2. Développez Settings (Paramètres), puis cliquez sur Settings (Paramètres).
  3. Sélectionnez Apache Spark.
  4. Cliquez sur Create (Créer).
  5. Remplissez les champs, puis cliquez sur Save (Enregistrer).

Supprimer un environnement d'exécution sans serveur pour Apache Spark

  1. Pour ouvrir l'éditeur des paramètres Data Cloud, cliquez sur l'icône Google Cloud Data Agent Kit dans la barre d'activité.
  2. Développez Settings (Paramètres), puis cliquez sur Settings (Paramètres).
  3. Sélectionnez Apache Spark.
  4. Pour l'environnement d'exécution sans serveur que vous souhaitez supprimer, cliquez sur Actions, puis sur Delete (Supprimer).

Configurer le programmeur

  1. Pour ouvrir l'éditeur des paramètres Google Cloud Data Agent Kit, cliquez sur l'icône Google Cloud Data Agent Kit dans la barre d'activité.
  2. Développez Settings (Paramètres), puis cliquez sur Settings (Paramètres).
  3. Cliquez sur Scheduler (Programmeur).
  4. Sélectionnez un projet et une région. Le projet et la région ne doivent pas nécessairement correspondre à ceux que vous avez sélectionnés dans l'onglet "Common" (Commun).
  5. Sélectionnez un environnement Managed Service pour Apache Airflow pour configurer les workflows.
  6. Cliquez sur Save (Enregistrer).

Vérifier les compétences de l'agent

L'extension Data Agent Kit pour VS Code est fournie avec des compétences d'agent que vous pouvez utiliser dans vos workflows.

  1. Pour ouvrir l'éditeur des paramètres Data Cloud, cliquez sur l'icône Google Cloud Data Agent Kit dans la barre d'activité.
  2. Développez Settings (Paramètres), puis cliquez sur Settings (Paramètres).
  3. Cliquez sur Skills (Compétences).
  4. Pour lire le code Markdown qui définit une compétence, cliquez sur le titre de la compétence.

Installer des dépendances

Certaines opérations Google Cloud Data Agent Kit nécessitent l'installation de logiciels supplémentaires après l'installation de l'extension. Dans certains cas, vous êtes invité à accepter l'installation automatique. Dans d'autres cas, vous devez installer le logiciel manuellement.

Orchestration Pipelines

Pour utiliser Orchestration Pipelines dans votre IDE, installez les éléments suivants :

Notebooks

Lorsque vous tentez une opération qui nécessite les éléments suivants, l'IDE vous demande votre consentement, puis installe le logiciel pour vous :

  • BigQuery DataFrames (version 2.36 ou ultérieure)
  • Anywidget
  • BigQuery ML

Pour autoriser l'agent à exécuter des cellules de code dans vos notebooks, vous pouvez activer le paramètre google.datacloud.executeCellToolForNotebookMCP dans les paramètres de votre IDE. Ce paramètre active l'outil execute_cell pour le protocole MCP (Model Context Protocol) du notebook.

Résoudre les problèmes

Si vous rencontrez des problèmes, essayez de vous déconnecter de Google Cloud Data Agent Kit et de la gcloud CLI, puis de vous reconnecter. Pour connaître d'autres méthodes de diagnostic et de résolution des erreurs de configuration, consultez Résoudre les problèmes liés à l'extension Data Agent Kit pour VS Code.

Signaler un problème

Pour signaler un problème, procédez comme suit :

  1. Dans le menu Google Cloud Data Agent Kit de la barre d'activité, cliquez sur Report bug (Signaler un bug).
  2. Dans le formulaire qui s'ouvre, décrivez le problème, puis cliquez sur Submit (Envoyer).

Étape suivante