Antigravity ist eine Schleife. Ihr Agent bearbeitet Dateien, führt Terminalbefehle aus, liest die Ausgabe und entscheidet, was als Nächstes zu tun ist. Warum sind Ihre API-Tests also nicht in dieser Schleife? Sie sitzen in Apidog hinter einer GUI und werden ausgeführt, wenn jemand daran denkt, zu klicken. Der Agent berührt sie nie.
Die Lösung ist ein einziger Konfigurationsblock. Die Apidog CLI ist ein npm-Paket, `apidog-cli`, das die in Apidog erstellten Testszenarien direkt über ein Terminal ausführt. Sobald die CLI installiert ist und Antigravity ihre Existenz kennt, führt der Agent ein Apidog-Szenario auf dieselbe Weise aus wie Ihre Unit-Tests: Befehl auslösen, Exit-Code lesen, Code korrigieren, wenn er rot ist.
Falls Sie die CLI noch nicht installiert haben, tun Sie dies zuerst. Wie man die Apidog CLI mit einem KI-Codierungsagenten installiert führt durch die npm-Installation, Authentifizierung und den ersten Lauf, wobei der Agent die Eingaben tätigt. Dieser Artikel geht davon aus, dass `apidog --version` eine Nummer ausgibt und Ihr Apidog-Konto authentifiziert ist.
Um welches Antigravity es hier geht
Antigravity ist Googles agentische Entwicklungsplattform, die auf Gemini 3 aufbaut und Ende 2025 gestartet wurde. Sie steuert den Agenten über einen Agent Manager, der die Arbeit plant, Dateien im gesamten Repository bearbeitet und Shell-Befehle in seinem eigenen Terminal und Browser ausführt. Der Agent ist die primäre Schnittstelle und agiert direkt auf Ihrem lokalen Computer. Wenn Sie Antigravity geöffnet, eine Aufgabe gestartet und beobachtet haben, wie der Agent Befehle ausführt und Ergebnisse zurückmeldet, sind Sie hier richtig. Für eine umfassendere Tour siehe was Google Antigravity ist und wie man es benutzt.
Die Unterscheidung ist wichtig, weil Antigravity eine eigene Methode hat, Projektregeln zu lernen, und dieser Mechanismus ein einmaliges „Meine Tests ausführen“ in etwas verwandelt, das der Agent von selbst aufruft.
Schritt 1: Antigravity eine Regeldatei geben
Antigravity erkennt ein spezielles Verzeichnis `.agents/` im Root Ihres Arbeitsbereichs. Googles eigenes Codelab zum Erstellen autonomer Entwickler-Pipelines in Antigravity zeigt, wie der Agent Dateien, die Sie dort ablegen, nativ aufnimmt, und Arbeitsbereichsregeln befinden sich in `.agents/rules/`. Legen Sie Ihre Projektregeln in einer Datei wie `.agents/rules/apidog.md` ab. Antigravity liest auch eine einfache `AGENTS.md` im Root des Arbeitsbereichs als grundlegende, werkzeugübergreifende Datei, dieselbe Datei, die Codex für die Apidog CLI liest; wenn Sie bereits eine besitzen, fügen Sie den Apidog-Block dort hinzu, anstatt zwei zu pflegen.
Fügen Sie einen kurzen Apidog-Block in diese Regeldatei ein. So etwas wie das hier:
## API testing with the Apidog CLI
- To test the API, run the Apidog scenario, do not click through the GUI.
- Command: apidog run -t <scenario_id> -e <env_id> -r cli
- Exit code 0 means every assertion passed. Non-zero means a failure; open the report and fix the code.
- The machine is already authenticated via `apidog login`. Never add an --access-token flag and never put a token in this file.
Deshalb schreiben Sie die CLI in die Regeldatei, anstatt sie im Chat zu erwähnen. Antigravity merkt sich nicht, was Sie ihm zwischen den Sitzungen beibringen; schließen Sie das Fenster, öffnen Sie es erneut, und die Anweisung ist verschwunden. Eine in den Chat eingegebene Szenario-ID verschwindet, wenn die Sitzung endet. Eine in Ihre Regeldatei geschriebene ist von nun an für jedes Teammitglied und jeden Antigravity-Lauf verfügbar.
Schritt 2: Den Befehl von Apidog erhalten
Sie müssen die Szenario- und Umgebungs-IDs nicht erraten. Öffnen Sie das Testszenario in Apidog, gehen Sie zum CI/CD-Tab und kopieren Sie den generierten Befehl. Er sieht so aus:
apidog run -t 123456 -e 789012 -r cli
Das Flag `-t` ist die Test-Szenario-ID, `-e` ist die Umgebungs-ID, und `-r cli` wählt den Reporter aus, der die Ergebnisse inline ausgibt. Fügen Sie diese echten IDs in Ihren `.agents/rules/apidog.md`-Block ein, damit der Agent genau den Befehl ausführt, den Apidog Ihnen gegeben hat. Für jedes Flag siehe die apidog run Befehlsreferenz.
Schritt 3: Den Agenten den Test ausführen lassen
Mit dem platzierten Block starten Sie eine Aufgabe in Antigravity. Der Agent lädt Ihre Regeln beim Start, sodass er bereits weiß, dass die CLI vorhanden ist. Nehmen Sie eine Änderung vor, die Ihre API betrifft, oder bitten Sie ihn einfach, die Überprüfung auszuführen:
Run the Apidog test scenario and tell me the exit code.
Der Agent gibt den `apidog run`-Befehl aus Ihrer Regeldatei in seinem eigenen Terminal aus. Ob er ohne Nachfrage ausgeführt wird, hängt von Ihren Berechtigungseinstellungen ab. Antigravitys Sicherheitseinstellung bestimmt, ob Terminalbefehle und Dateizugriffe von Ihnen überprüft werden, bevor der Agent handelt, wie in Googles Antigravity-Einstiegs-Codelab beschrieben. Wenn die Voreinstellung eine Überprüfung anfordert, genehmigen Sie den `apidog run`-Befehl, wenn er dazu auffordert; ein schreibgeschütztes Testszenario gegen Staging ist genau die Art von sicherem Befehl innerhalb des Arbeitsbereichs, den man genehmigen kann. Wenn Sie den Agenten so eingestellt haben, dass er selbstständig vorgeht, führt er den Befehl aus und meldet ohne Unterbrechung zurück.
Sie möchten sehen, wie der Lauf ausgeführt wird und der Agent sowohl die Zusammenfassung als auch den Exit-Code meldet, nicht eine Umschreibung.
Schritt 4: Den Bericht in Antigravity lesen
Wenn ein Lauf fehlschlägt, enthält der Bericht die Antwort. Mit `-r cli` erhält der Agent eine lesbare Aufschlüsselung in seinem Terminal: jede Anfrage, jede Assertion und welche davon mit erwartetem versus tatsächlichem Wert fehlgeschlagen ist. Die fehlerhafte Assertion benennt das genaue Feld oder den Statuscode, was dem Agenten meist ausreicht, um die Korrektur zu finden.
Für einen Bericht, den Sie in einem Browser öffnen oder an einen Teamkollegen weitergeben können, fügen Sie den HTML-Reporter hinzu:
apidog run -t 123456 -e 789012 -r cli,html
Der `html`-Reporter schreibt eine eigenständige Datei nach `./apidog-reports`. Behalten Sie `cli` in der Liste, damit der Agent weiterhin die Inline-Ausgabe erhält, die er zur Entscheidung des nächsten Schritts liest. Für den vollständigen Satz an Reportern, einschließlich des JUnit-Formats, das CI-Dashboards parsen, siehe den vollständigen Apidog CLI-Leitfaden und wie man Apidog CLI-Testberichte liest.
Antigravity-Tests in der eigenen Schleife
Der Punkt ist, was passiert, wenn Sie aufhören zu fragen und der Agent das Szenario von selbst ausführt, weil die Regeldatei es ihm gesagt hat.
Stellen Sie sich vor, der Agent bearbeitet einen Handler, der eine Kassenantwort erstellt. Seine Schleife ändert sich. Er bearbeitet den Code, dann, anstatt den Sieg zu erklären, führt er Ihr Apidog-Szenario gegen Staging aus, liest den Exit-Code und handelt danach. Grün, er fährt fort. Rot, er öffnet den Bericht, liest, welche Assertion fehlgeschlagen ist (der Statuscode, das fehlende Feld, der falsche Wert), versucht eine Korrektur und führt den Test erneut aus. Der API-Test wird Teil derselben Bearbeitungs-Test-Korrektur-Schleife, durch die der Agent bereits Ihre Unit-Tests laufen lässt. Sie haben eine Anweisung geschrieben und der Agent hat den Befehl in seine bereits bestehende Arbeitsweise integriert.
Dies ist das Delegieren-und-Verifizieren-Modell, das jeden Agenten-Workflow sicher macht. Antigravity führt den Befehl aus und liest das Ergebnis; Sie erstellen weiterhin Szenarien visuell in Apidog und überprüfen stichprobenartig, ob der Agent Exit-Codes ehrlich liest. Für das breitere Muster siehe wie man KI-Agenten für API-Tests verwendet und das Apidog AI-Test-Harness.
Überprüfen, ob Antigravity die CLI tatsächlich ausführt
Agenten melden Erfolge, die sie nicht verdient haben, und Antigravity ist keine Ausnahme. Drei Überprüfungen, in der Reihenfolge, wie oft sie Probleme aufdecken.
Zuerst bestätigen Sie, dass der Befehl überhaupt ausgeführt wurde. Antigravity zeigt die ausgeführten Befehle und deren Ausgabe in seinem Terminal an. Suchen Sie nach der wörtlichen Zeile `apidog run ...` und einem Ergebnis darunter. Wenn der Agent sagt, er habe die Tests ausgeführt, Sie den Befehl aber nicht sehen, hat er etwas zusammengefasst, das er nie getan hat. Bitten Sie ihn, es erneut auszuführen und die Rohausgabe anzuzeigen.
Zweitens, bestätigen Sie den Exit-Code, den, der zählt. Fragen Sie direkt:
What was the exit code of that apidog run command?
`apidog run` beendet mit `0`, wenn jede Assertion erfolgreich ist, und mit einem Wert ungleich Null, wenn etwas fehlschlägt. Dieses einzige Verhalten ermöglicht es dem Agenten oder einer Pipeline, den Lauf als sauberes Gate zu behandeln. Wenn die Prosa des Agenten sagt „Tests bestanden“, aber der Exit-Code ungleich Null ist, ist der Exit-Code richtig.
Drittens, bestätigen Sie, dass das reale Szenario verwendet wurde. Wenn ein Lauf mit „Szenario nicht gefunden“ fehlschlägt, hat der Agent möglicherweise eine ID erfunden oder falsch erinnert. Überprüfen Sie die Werte von `-t` und `-e` erneut mit Ihrer Regeldatei und dem von Apidog im CI/CD-Tab generierten Befehl. Die IDs in Ihrer Regeldatei sind die Wahrheit.
Optional: Den Apidog MCP-Server verbinden
Das Ausführen von `apidog run` aus Ihrer Regeldatei deckt das meiste ab, was Sie benötigen. Um weiterzugehen, verbinden Sie einen MCP-Server.
Antigravity unterstützt das Model Context Protocol, und seine MCP-Server werden in der Datei `$HOME/.gemini/config/mcp_config.json` konfiguriert, gemäß Googles Einstiegs-Codelab. Sie fügen einen Server als Eintrag im `mcpServers`-Objekt dieser Datei mit seinem `command`, `args` und `env` hinzu und aktualisieren dann MCP in den Antigravity-Einstellungen. Der Apidog MCP-Server macht Ihre API-Spezifikationen über MCP verfügbar, sodass der Agent Ihr Schema lesen kann, während er Code schreibt, nicht erst nachträglich. Die CLI führt die Tests aus; MCP füttert dem Agenten die Spezifikation.
Wenn Antigravity es falsch macht
Einige Fehler treten oft während der Einrichtung auf.
Es ignoriert die Regeldatei. Wenn der Agent einen generischen Befehl oder gar keinen ausführt, werden die Regeln möglicherweise nicht geladen. Bestätigen Sie, dass die Datei korrekt benannt ist und sich dort befindet, wo Antigravity sie für Ihren Arbeitsbereich erwartet, und starten Sie dann eine neue Aufgabe, damit die Regeln neu gelesen werden.
Es übergibt trotzdem ein Zugriffstoken. Wenn der Agent versucht, `--access-token` hinzuzufügen, rät er aus öffentlichen Beispielen. Ihr Regelblock weist ihn bereits an, dies nicht zu tun, da der Computer über `apidog login` authentifiziert ist. Bekräftigen Sie die Zeile und legen Sie niemals ein echtes Token in der Regeldatei ab. Wie die Authentifizierung tatsächlich funktioniert, erfahren Sie unter Apidog CLI-Authentifizierung.
Es erfindet ein Flag. Ein Fehler „unbekannte Option“ bedeutet, dass der Agent ein Flag erraten hat, das Ihre Version nicht besitzt. Sagen Sie ihm, er solle `apidog run --help` ausführen und das genaue Flag von dort kopieren, was für Ihre installierte Version immer korrekt ist.
Es meldet einen Erfolg bei einem fehlgeschlagenen Lauf. Der kostspieligste Fehler und der Grund, warum die Exit-Code-Regel in Ihrer Regeldatei und Ihrem Überprüfungsschritt enthalten ist. Wenn die Zusammenfassung und der Exit-Code nicht übereinstimmen, gewinnt der Exit-Code.
Vom täglichen Agenten zur getesteten Schleife
Das ist die Einrichtung. Installieren Sie `apidog-cli` einmal gemäß dem Installationshandbuch, fügen Sie einen kurzen Apidog-Block zu Ihrer Antigravity-Regeldatei hinzu, und der Agent weiß, wie er Ihre API-Tests ausführt und das Ergebnis innerhalb derselben Schleife liest, die er bereits zum Bearbeiten von Code verwendet. Ein fehlerhafter Endpunkt wird erkannt, während der Agent noch an der Änderung arbeitet, nicht erst nach dem Deployment.
Ein Test hinter einer GUI wird ausgeführt, wenn ein Mensch klickt; ein einzeiliger Befehl wird ausgeführt, wann immer Antigravity dies entscheidet. Sie erstellen weiterhin Szenarien visuell in Apidog, und Ihr Agent führt sie aus, wo Sie nicht zusehen. Laden Sie Apidog herunter, erstellen Sie ein Szenario, fügen Sie seinen `apidog run`-Befehl in Ihre Regeldatei ein und beobachten Sie, wie der Agent ihn bei der nächsten Änderung aufnimmt. Wenn Sie bereit sind, denselben Befehl in einer Pipeline ohne anwesenden Agenten auszuführen, deckt Apidog CLI in GitHub Actions die Geheimnisse, Reporter und Exit-Code-Gating ab.