Skip to main content
Le plugin CoreWeave Forge pour Google Antigravity trace les tours de conversation des agents, les appels de modèle, les appels d’outils et les sous-agents. Lorsqu’un tour de conversation se termine, le Stop hook du plugin lit la transcription de la conversation et envoie le tour à Agent Lens sous la forme d’une trace unique. Les tours d’une même conversation Antigravity partagent un ID de conversation, ce qui permet à Agent Lens de les regrouper en une seule conversation. Ce guide explique comment installer et configurer le plugin, consulter les traces générées et résoudre les problèmes courants.
Ce plugin envoie les données de session Antigravity à Agent Lens. Ces données peuvent inclure vos prompts, les réponses et le raisonnement du modèle, ainsi que les arguments et les résultats des outils, y compris tout ce qu’un outil affiche.Le nettoyage des informations personnelles identifiables (PII) et le masquage des données sensibles ne sont pas implémentés. Le plugin ne supprime ni les secrets ni les données personnelles du contenu capturé. Pour exclure les prompts, les réponses, le raisonnement ainsi que les arguments et les résultats des outils, définissez FORGE_ANTIGRAVITY_INCLUDE_CONTENT=false. Les spans contiennent tout de même les noms, les durées et les chemins du Workspace. Voir Capture du contenu. Si vos exigences de sécurité ou de conformité ne vous permettent pas d’envoyer ces données à Agent Lens, n’installez pas ce plugin.

​
Prérequis

Avant d’installer le plugin, vous devez disposer des éléments suivants :
  • Antigravity CLI (agy) 1.1.10 ou version ultérieure
  • uv, dont la commande uvx exécute le hook
  • Python 3.10 ou version ultérieure
  • Un compte CoreWeave Forge et une clé API
  • Un projet Agent Lens ([YOUR-TEAM]/[YOUR-PROJECT]) destiné à recevoir les traces

​
Installer le plugin

Suivez les étapes ci-dessous pour installer le plugin et envoyer votre première trace à Agent Lens.
1

Définir votre projet et votre clé API

Remplacez [YOUR-TEAM]/[YOUR-PROJECT] par votre projet Agent Lens et [YOUR-API-KEY] par votre clé API, puis exportez-les :
Le hook s’exécute dans l’environnement à partir duquel agy a été lancé. Définissez FORGE_TRACE_PROJECT et la clé API dans le profil de votre shell, ou à l’endroit d’où vous lancez agy, et vérifiez que uvx figure bien dans ce PATH. À la place de WANDB_API_KEY, le hook peut aussi lire la clé dans l’entrée de l’hôte Weights & Biases du fichier ~/.netrc.
2

Exécuter le programme d’installation

Le programme d’installation enregistre le plugin à l’aide de agy plugin install, vérifie les paramètres dont le hook a besoin et indique où les traces apparaîtront :
Si le programme d’installation affiche ✗ Hook command, consultez la section Dépannage.
3

Démarrer une nouvelle session

Lancez une nouvelle session agy. Chaque tour de conversation terminé apparaît dans Agent Lens.

​
Afficher les traces Antigravity dans Agent Lens

Le programme d’installation affiche un lien vers les traces de votre projet. Vous pouvez également ouvrir votre projet dans l’interface d’Agent Lens :
  1. Accédez à CoreWeave Forge, sélectionnez Agent Lens dans le menu des produits, puis sélectionnez votre projet dans le sélecteur de projet, en haut du menu latéral.
  2. Dans le menu latéral, sélectionnez Conversations.
  3. Sélectionnez l’onglet Conversations pour afficher toutes les conversations d’agent enregistrées pour votre projet.
  4. Sélectionnez une conversation pour en examiner l’arborescence complète.
Pour plus d’informations sur l’onglet Conversations, voir Afficher l’activité des agents. Le plugin nomme chaque conversation d’après le premier dossier du Workspace de la session. Si la session ne comporte aucun dossier de Workspace, la conversation est nommée Antigravity.

​
Ce qui est tracé

Chaque tour de conversation correspond à une trace :
Les spans suivent les conventions sémantiques GenAI d’OpenTelemetry (OTel) (attributs gen_ai.*) et leur durée est calculée à partir des horodatages des étapes de la transcription Antigravity.

​
Limitations

Le plugin présente les limitations suivantes :
  • La transcription d’Antigravity n’enregistre ni l’utilisation des jetons, ni les paramètres des requêtes au modèle, ni les ID de réponse : les traces n’indiquent donc ni nombres de jetons ni coûts.
  • Le span invoke_agent d’un sous-agent contient son prompt et son résultat, mais aucun span enfant, car la transcription n’enregistre pas les appels au modèle ni les appels d’outils effectués par le sous-agent lui-même.

​
Référence de configuration

Configurez le plugin à l’aide de variables d’environnement définies dans l’environnement à partir duquel vous lancez agy.

​
Capture du contenu

Avec FORGE_ANTIGRAVITY_INCLUDE_CONTENT=false, les spans contiennent toujours les éléments suivants :
  • Les noms des modèles, des outils et des sous-agents, ainsi que les rôles des sous-agents
  • Les informations de durée
  • Les chemins du Workspace
  • Le numéro d’exécution du Stop hook et le motif de son arrêt
Le SDK Forge ajoute également à chaque span les versions de votre système d’exploitation et de Python.

​
Dépannage

Si les traces n’arrivent pas dans Agent Lens, commencez par rechercher les messages du plugin à l’aide de la commande grep. Antigravity n’affiche la sortie des hooks ni dans son interface de terminal ni dans la sortie de agy -p. Il écrit les messages du hook, notamment les liens permettant de consulter les traces et les éventuelles erreurs d’exportation, dans les journaux de sa CLI :
Comparez ensuite vos observations avec le tableau suivant.

​
Gérer le plugin

Pour mettre à niveau le plugin, réexécutez la commande d’installation : elle remplace le plugin installé. Pour figer une version ou passer à une version donnée, installez le plugin à partir de cette version :
Désactivez, réactivez ou supprimez le plugin à l’aide de agy plugin :
Si vous avez installé la version 0.1.0 ou 0.1.1 avec uv tool install, cet exécutable n’est plus utilisé après la mise à niveau. Supprimez-le avec la commande suivante :
Dernière modification le 15 octobre 2026