Connectez Antigravity à Observagent.

1. Préparer PowerShell et Python

Vous avez besoin de la commande agy, de Python 3, d'un projet Observagent, et d'une clé API de projet avec la permission telemetry:write.

agy --help
python --version

Créez ou sélectionnez un projet dans Observagent, activez Journaux, et générez une clé de projet. Traitez la clé complète comme un secret ; ne la commettez jamais dans le contrôle de version et ne la collez jamais dans une documentation publique.

2. Installer l'adaptateur local

Placez antigravity_to_observagent.py dans un répertoire d'intégration local, créez un environnement virtuel et installez la dépendance protobuf OTLP.

New-Item -ItemType Directory -Force "$HOME\antigravity-observagent"
Set-Location "$HOME\antigravity-observagent"
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install opentelemetry-proto

Utilisez directement le Python de l'environnement virtuel dans les wrappers afin que l'intégration ne dépende pas de l'activation ou du PATH Python du shell actuel.

3. Configurer la destination de manière sécurisée

Définissez l'URL de base d'ingestion et la clé de projet dans la session PowerShell qui lance Antigravity. L'adaptateur ajoute /v1/logs à l'URL de base.

$env:OBSERVAGENT_ENDPOINT = "https://dashboard.observagent.cloud"
$env:OBSERVAGENT_API_KEY = (Read-Host "Observagent project API key").Trim()
$env:OBSERVAGENT_USER_ID = "local-user"

Les variables d'environnement définies ainsi ne durent que pour le processus PowerShell actuel. Ne stockez pas une clé active dans un profil ou script de configuration commité.

4. Envoyer une télémétrie détaillée en mode impression

$adapter = "$HOME\antigravity-observagent\antigravity_to_observagent.py"
agy --model gemini-3.8-flash -p "Explain observability in one sentence" --output-format stream-json |
  & "$HOME\antigravity-observagent\.venv\Scripts\python.exe" $adapter

L'adaptateur affiche le texte de réponse tout en exportant les événements pris en charge. N'ajoutez pas une deuxième option output-format. Chaque journal étiqueté d'un modèle émis peut contribuer à l'usage de modèle, donc le total du graphique n'est pas nécessairement un par invite.

5. Préserver le CLI interactif

Une fonction PowerShell peut envelopper l'exécutable réel sans acheminer sa sortie terminal. Capturez le chemin de l'exécutable avant de définir la fonction pour éviter la récursion. Envoyez session-start, lancez Antigravity normalement, puis envoyez session-end dans un bloc finally.

$script:AntigravityExe = (Get-Command agy -CommandType Application).Source
$script:Adapter = "$HOME\antigravity-observagent\antigravity_to_observagent.py"
$script:AdapterPython = "$HOME\antigravity-observagent\.venv\Scripts\python.exe"

function global:agy {
  $sessionId = [guid]::NewGuid().ToString()
  $started = Get-Date
  $exitCode = 1
  $model = "gemini-3.8-flash"
  for ($i = 0; $i -lt $args.Count; $i++) {
    if ($args[$i] -eq "--model" -and $i + 1 -lt $args.Count) { $model = $args[$i + 1]; break }
    if ($args[$i] -is [string] -and $args[$i].StartsWith("--model=")) { $model = $args[$i].Substring(8); break }
  }
  & $script:AdapterPython $script:Adapter session-start --session-id $sessionId --cwd (Get-Location).Path --model $model
  try {
    & $script:AntigravityExe @args
    $exitCode = $LASTEXITCODE
  } finally {
    $durationMs = ((Get-Date) - $started).TotalMilliseconds
    & $script:AdapterPython $script:Adapter session-end --session-id $sessionId --exit-code $exitCode --duration-ms $durationMs --model $model
    $global:LASTEXITCODE = $exitCode
  }
}

Exécutez agy normalement après avoir chargé la fonction. Une session ouverte émet un enregistrement de début ; en sortir émet un enregistrement de fin. Envoyer six invites dans cette session ne produit toujours que ces deux enregistrements.

6. Vérifier les enregistrements dans Observagent

Ouvrez Données de télémétrie, choisissez une plage de temps incluant la nouvelle activité, effacez les anciens filtres, et recherchez agent:antigravity-cli. Inspectez les attributs originaux pour event.name, session.id, model, et les champs de durée.

• Début interactif : antigravity.session.started.
• Complétion interactive : antigravity.session.completed.
• Complétion de conversation en mode impression : antigravity.response.completed.
• L'usage de modèle compte les enregistrements contenant un champ de modèle reconnu, pas les invites uniques.

Dépanner une télémétrie manquante

• Aucun enregistrement : confirmez le point de terminaison, assurez-vous que la clé a telemetry:write, et activez Journaux pour le projet sélectionné.
• L'usage de modèle affiche un lors d'une session interactive : seul l'enregistrement de début existe jusqu'à ce que vous quittiez Antigravity.
• L'usage de modèle affiche deux après de nombreuses invites : le mode interactif enregistre les limites de session, pas les limites d'invite.
• Modèle non signalé : rechargez le dernier wrapper et passez --model ou configurez le bon modèle par défaut.
• Aucun total de jetons en mode interactif : le CLI interactif documenté n'expose pas l'usage de jetons par tour au wrapper.
• HTTP 401 : remplacez la valeur configurée par la clé de projet brute complète. Ne partagez jamais la clé dans une sortie de diagnostic.