Utiliser la CLI Antigravity

Utiliser la CLI Antigravity

Aperçu

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Cette page explique comment utiliser l'interface de ligne de commande (CLI) Antigravity avec une instance Gemini Enterprise Agent Platform Workbench.

Ce document est destiné aux analystes de données, aux data scientists et aux développeurs de données qui travaillent avec Agent Platform Workbench. Ce document suppose que vous savez écrire du code dans un environnement de notebook.

Présentation

La CLI Antigravity est l'interface de terminal de Google Antigravity, un agent de codage IA qui s'exécute dans un terminal. Pour en savoir plus, consultez antigravity.google.

La CLI Antigravity est disponible dans un terminal de l'interface JupyterLab de votre instance Agent Platform Workbench. Vous pouvez l'utiliser pour travailler avec les notebooks et les fichiers de votre instance, et pour exécuter des commandes shell et des commandes Google Cloud , en fournissant des instructions en langage naturel.

Agent Platform Workbench ajoute les éléments suivants à la CLI Antigravity :

• Compétences de notebook qui créent, expliquent, modifient, vérifient et exécutent des notebooks, et créent des noyaux Jupyter.
• Un plug-inGoogle Cloud avec la documentation et des conseils sur les commandes Google Cloud gcloud.
• La commande magique de cellule %%agy, qui écrit le code d'une cellule de notebook à partir de votre description.

Limites

Tenez compte des limites suivantes lorsque vous utilisez la CLI Antigravity avec Agent Platform Workbench :

• La CLI Antigravity est une CLI uniquement. L'interface de chat graphique et les outils avancés dans l'éditeur ne sont pas inclus.

• Lorsque vous demandez à la CLI Antigravity de modifier un notebook, elle modifie le fichier du notebook directement sur le disque de l'instance. Par conséquent, vous ne pouvez pas annuler les modifications apportées par la CLI Antigravity à l'aide du bouton Annuler de l'éditeur de notebook ou de Ctrl+Z (Cmd+Z sur macOS). Toutefois, vous pouvez demander à la CLI Antigravity d'annuler une modification à l'aide d'une commande en langage naturel, telle que Undo your last change.

• La CLI Antigravity écrit directement sur le disque et peut modifier les fichiers que vous avez également ouverts dans JupyterLab. Si vous avez des modifications non enregistrées dans un notebook, enregistrez-les avant de demander à la CLI Antigravity de modifier ce même notebook.

• La CLI Antigravity est épinglée à la version incluse dans l'image de votre instance et ne peut pas se mettre à jour automatiquement. Pour utiliser une version plus récente, mettez à niveau votre instance vers une version d'image plus récente. Pour en savoir plus, consultez Mettre à niveau l'environnement d'une instance.

• La CLI Antigravity s'exécute avec les identifiants actifs sur votre instance. Par défaut, il s'agit des identifiants du compte de service de votre instance Agent Platform Workbench. La CLI Antigravity peut donc accéder aux mêmes ressources que l'instance. Si vous authentifiez une autre identité sur l'instance (par exemple, en exécutant gcloud auth login ou gcloud auth application-default login), la CLI Antigravity utilise les autorisations de cette identité à la place.

Avant de commencer

Cette technologie étant à un stade précoce, il se peut que les produits Gemini pour Google Cloudgénèrent des résultats qui semblent plausibles, mais qui sont en fait incorrects. Nous vous recommandons de vérifier tous les résultats des produits Gemini pour Google Cloud avant de les utiliser. Pour en savoir plus, consultez la page Gemini pour Google Cloud et l'IA responsable.

Connectez-vous à votre compte Google Cloud . Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits sans frais pour exécuter, tester et déployer des charges de travail.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, Notebooks, and Agent Platform APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, Notebooks, and Agent Platform APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

Rôles requis

Pour utiliser la CLI Antigravity dans Agent Platform Workbench, vous devez accorder des autorisations à l'utilisateur de l'instance Agent Platform Workbench et au compte de service de l'instance.

Remarque : La CLI Antigravity fonctionne strictement dans le cadre des autorisations de l'environnement de votre instance Agent Platform Workbench. Si vous (ou le compte de service utilisé par votre instance) n'êtes pas autorisé à accéder à une ressource spécifique, la CLI Antigravity ne pourra pas non plus y accéder. Si une commande échoue en raison d'autorisations, demandez à votre administrateur de vous accorder les autorisations nécessaires.

Accorder des autorisations à l'utilisateur de l'instance

Pour obtenir les autorisations nécessaires pour utiliser la CLI Antigravity dans une instance Agent Platform Workbench, demandez à votre administrateur de vous attribuer le rôle IAM Utilisateur Agent Platform (roles/aiplatform.user) 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.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Accorder une autorisation au compte de service de votre instance

Pour vous assurer que le compte de service de votre instance Agent Platform Workbench dispose de l'autorisation nécessaire pour permettre à la CLI Antigravity de s'exécuter dans une instance Agent Platform Workbench, demandez à votre administrateur d'accorder le rôle IAM Utilisateur Agent Platform (roles/aiplatform.user) au compte de service de votre instance Agent Platform Workbench sur le projet.

Important : Vous devez attribuer ce rôle au compte de service de votre instance Agent Platform Workbench, et non à votre compte utilisateur. Si vous ne l'accordez pas au bon compte principal, vous risquez de rencontrer des erreurs d'autorisation.

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient l'autorisation aiplatform.endpoints.predict, qui est requise pour permettre à la CLI Antigravity de s'exécuter dans une instance Agent Platform Workbench.

Votre administrateur peut également attribuer cette autorisation au compte de service de votre instance Agent Platform Workbench avec des rôles personnalisés ou d'autres rôles prédéfinis.

Activer la CLI Antigravity

La CLI Antigravity n'est disponible que sur les instances Agent Platform Workbench qui utilisent une image Debian 12 (workbench-instances-2603) ou version ultérieure. Il n'est pas installé sur les instances qui utilisent l'image Debian 11 (workbench-instances).

La CLI Antigravity est activée par défaut sur les nouvelles instances. Si vous ne définissez pas la clé de métadonnées d'instance enable-antigravity lorsque vous créez une instance, Agent Platform Workbench la définit sur true.

Pour activer ou désactiver la CLI Antigravity pour une instance, définissez la clé de métadonnées d'instance enable-antigravity sur false ou true, puis arrêtez et démarrez l'instance. L'instance applique le paramètre au démarrage. Pour en savoir plus, consultez Gérer les caractéristiques via les métadonnées.

Utiliser la CLI Antigravity

1. Dans la console Google Cloud , accédez à la page Instances.

   Accéder à la page "Instances"

2. À côté du nom d'une instance Agent Platform Workbench, cliquez sur Ouvrir JupyterLab.

3. Dans JupyterLab, cliquez sur File > New launcher (Fichier > Nouveau lanceur d'applications).

4. Dans l'onglet Lanceur d'applications, dans la section Autre, cliquez sur la tuile CLI Antigravity.

   Un terminal s'ouvre et lance la CLI Antigravity. Vous pouvez également saisir agy dans n'importe quel terminal JupyterLab.

5. Saisissez une requête, par exemple "Créer un notebook nommé 'test-notebook'". Pour en savoir plus, consultez Exemples de requêtes.

6. Lorsque la CLI Antigravity propose une action, comme modifier un fichier ou exécuter une commande shell, examinez-la, puis approuvez-la ou refusez-la. Pour en savoir plus, consultez Approuver les actions des outils.

Compétences de notebook et plug-in Google Cloud

Les compétences sont des instructions et des scripts que la CLI Antigravity utilise pour un type de tâche. Lorsque la CLI Antigravity est activée, Agent Platform Workbench lui attribue les compétences de notebook suivantes :

• Cibleur de notebook : recherche le notebook que vous avez ouvert dans JupyterLab afin que vous puissiez l'appeler "ce notebook".
• Explication de notebook : résume les cellules d'un notebook et leurs sorties textuelles.
• Modificateur de notebook : ajoute et modifie des cellules. Il ne modifie que la cellule cible et conserve le notebook au format utilisé par JupyterLab.
• Outil de validation de notebook : vérifie qu'un notebook est valide. Il vous demande avant de réparer un notebook qui n'était déjà pas valide.
• Créateur de notebook : crée un notebook avec un noyau disponible sur l'instance.
• Exécuteur de notebook : exécute un notebook sur les noyaux de l'instance et enregistre les résultats. Si une cellule échoue, elle est nommée.
• Créateur de noyau : crée un environnement Python et un noyau Jupyter avec les packages que vous demandez.

La CLI Antigravity est également fournie avec le plug-in google-cloud-developer de la place de marché des plug-ins Antigravity. Le plug-in fournit à la CLI Antigravity des conseils pour les commandes gcloud, une aide à l'authentification, Google Cloud de la documentation et des compétences pour des produits tels que Cloud Logging, Cloud Monitoring et Agent Platform.

La CLI Antigravity utilise une compétence ou le plug-in lorsque votre prompt en a besoin. Vous n'avez pas besoin de les nommer dans votre requête.

Exemples de prompts

Pour obtenir des idées d'utilisation de la CLI Antigravity, consultez les exemples de requêtes suivants :

• "Explique ce notebook."

• "Ajoute une cellule à ce notebook qui trace la distribution de la colonne 'age'."

• "Crée un notebook qui charge bigquery-public-data.ml_datasets.census_adult_income dans un DataFrame pandas, puis exécute-le."

• "Crée un kernel nommé 'forecast' avec pandas et prophet."

• "Vérifie que chaque notebook de ce répertoire est un notebook valide."

• "Interroge la table bigquery-public-data.ml_datasets.census_adult_income pour trouver le nombre de personnes dont la tranche de revenus est supérieure à 50 000."

Utiliser la commande magique de cellule %%agy

Pour que la CLI Antigravity écrive le code d'une cellule de votre notebook, procédez comme suit :

1. Sur la première ligne d'une nouvelle cellule d'un notebook Python, saisissez %%agy.
2. Sur les lignes suivantes de la même cellule, décrivez le code que vous souhaitez obtenir.
3. Exécutez le code de la cellule.

La CLI Antigravity ajoute une nouvelle cellule en dessous avec le code. Examinez le code avant de l'exécuter.

La commande magique de cellule %%agy est conçue strictement pour générer du code. Contrairement à l'interface du terminal, la commande magique de cellule ne peut pas vous demander d'approbation. Elle refuse donc automatiquement toute action nécessitant une approbation, comme l'exécution d'une commande shell.

La commande magique de cellule %%agy est disponible chaque fois que la CLI Antigravity est activée.

Approuver les actions associées à l'outil

Par défaut, la CLI Antigravity dans Agent Platform Workbench vous demande votre approbation avant d'effectuer une action, comme modifier un fichier, exécuter une commande shell ou récupérer une URL. Examinez chaque action proposée avant de l'approuver.

Cette valeur par défaut protège contre l'injection de prompt. Un notebook, un script ou une page Web que la CLI Antigravity lit peut contenir des instructions cachées qui tentent de faire exécuter à l'agent des commandes que vous n'aviez pas prévues, comme l'envoi de vos données à une adresse externe. La CLI Antigravity s'exécute avec les identifiants de votre instance. Par conséquent, l'exigence d'approbation vous permet de voir et d'arrêter une telle action avant qu'elle ne s'exécute.

Pour cette raison, l'option permettant d'ignorer les invites d'approbation est désactivée pour la CLI Antigravity sur les instances Agent Platform Workbench.

Contrôler l'accès à la CLI Antigravity

Vous pouvez contrôler l'accès à la CLI Antigravity dans Agent Platform Workbench à l'aide des méthodes suivantes :

• Un administrateur peut définir la clé de métadonnées d'instance enable-antigravity sur false. La vignette CLI Antigravity, les compétences du notebook, le plug-in et la cellule magique %%agy sont ensuite supprimés au prochain démarrage de l'instance. La commande agy reste installée. Pour empêcher les appels de modèle, utilisez les méthodes suivantes.

• Un administrateur peut configurer une règle d'administration pour limiter l'utilisation de modèles spécifiques au niveau de l'organisation, du dossier ou du projet. Consultez Contrôler l'accès aux modèles Model Garden.

• En n'accordant pas l'autorisation aiplatform.endpoints.predict, un administrateur peut empêcher certaines identités d'utiliser des points de terminaison de modèle pour l'inférence.

Étapes suivantes

• En savoir plus sur Gemini Enterprise Agent Platform

• Pour savoir comment définir les métadonnées d'instance, consultez Gérer les fonctionnalités via les métadonnées.