Ce document explique comment configurer les paramètres initiaux après avoir installé l'extension Google Cloud Data Agent Kit pour Antigravity.
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.
- Pour ouvrir l'éditeur des paramètres Data Cloud, cliquez sur l'icône Google Cloud Data Agent Kit dans la barre d'activité.
- Développez Paramètres, puis cliquez sur Paramètres.
- Sélectionnez Common (Commun).
- Sélectionnez votre ID de projet et votre région. L'ID du projet doit correspondre à celui que vous avez spécifié dans la gcloud CLI.
- Cliquez sur Enregistrer.
Examiner les rôles requis
- Pour ouvrir l'éditeur des paramètres Data Cloud, cliquez sur l'icône Google Cloud Data Agent Kit dans la barre d'activité.
- Développez Paramètres, puis cliquez sur Paramètres.
Accédez à Common > Required Permissions (Commun > Autorisations requises).
La colonne Accès indique si vous êtes un compte principal disposant du rôle requis.
Pour obtenir les autorisations manquantes nécessaires pour utiliser l'extension Data Agent Kit pour Antigravity, 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 Gérer l'accès aux projets, aux dossiers et aux organisations.
Configurer la région BigQuery
- Pour ouvrir l'éditeur des paramètres Data Cloud, cliquez sur l'icône Google Cloud Data Agent Kit dans la barre d'activité.
- Développez Paramètres, puis cliquez sur Paramètres.
- Sélectionnez BigQuery.
- Sélectionnez une région BigQuery.
- Cliquez sur Enregistrer.
Afficher les environnements d'exécution Serverless pour Apache Spark
- Pour ouvrir l'éditeur des paramètres Data Cloud, cliquez sur l'icône Google Cloud Data Agent Kit dans la barre d'activité.
- Développez Paramètres, puis cliquez sur Paramètres.
- Sélectionnez Apache Spark. Tous les runtimes sans serveur de votre projet s'affichent.
- Pour afficher une configuration d'exécution sans serveur, cliquez sur son nom.
Créer un environnement d'exécution Serverless pour Apache Spark
- Pour ouvrir l'éditeur des paramètres Data Cloud, cliquez sur l'icône Google Cloud Data Agent Kit dans la barre d'activité.
- Développez Paramètres, puis cliquez sur Paramètres.
- Sélectionnez Apache Spark.
- Cliquez sur Créer.
- Remplissez les champs, puis cliquez sur Enregistrer.
Supprimer un environnement d'exécution Serverless pour Apache Spark
- Pour ouvrir l'éditeur des paramètres Data Cloud, cliquez sur l'icône Google Cloud Data Agent Kit dans la barre d'activité.
- Développez Paramètres, puis cliquez sur Paramètres.
- Sélectionnez Apache Spark.
- Pour le runtime serverless que vous souhaitez supprimer, cliquez sur Actions, puis sur Supprimer.
Configurer le planificateur
- Pour ouvrir l'éditeur de paramètres du kit d'agent de données Google Cloud, cliquez sur l'icône Kit d'agent de données Google Cloud dans la barre d'activité.
- Développez Paramètres, puis cliquez sur Paramètres.
- Cliquez sur Programmation.
- 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 "Commun".
- Sélectionnez un environnement Managed Service pour Apache Airflow afin de configurer des workflows.
- Cliquez sur Enregistrer.
Examiner les compétences des agents
L'extension Data Agent Kit pour Antigravity est fournie avec des compétences d'agent que vous pouvez utiliser dans vos workflows.
- Pour ouvrir l'éditeur des paramètres Data Cloud, cliquez sur l'icône Google Cloud Data Agent Kit dans la barre d'activité.
- Développez Paramètres, puis cliquez sur Paramètres.
- Cliquez sur Compétences.
- 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 du kit d'agent de données Google Cloud nécessitent l'installation de logiciels supplémentaires après l'installation de l'extension. Dans certains cas, vous êtes invité à autoriser l'installation automatique. Dans d'autres cas, vous devez installer le logiciel manuellement.
Pipelines d'orchestration
Pour utiliser les pipelines d'orchestration dans votre IDE, installez les éléments suivants :
Notebooks
Lorsque vous tentez d'effectuer une opération qui nécessite les éléments suivants, l'IDE vous demande votre autorisation, 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 (Notebook Model Context Protocol).
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 découvrir 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 Antigravity.
Signaler un problème
Pour signaler un problème, procédez comme suit :
- Dans le menu Google Cloud Data Agent Kit de la barre d'activité, cliquez sur Signaler un bug.
- Dans le formulaire qui s'ouvre, décrivez le problème, puis cliquez sur Envoyer.