Antigravity es un bucle. Su agente edita archivos, ejecuta comandos de terminal, lee la salida y decide qué hacer a continuación. Entonces, ¿por qué sus pruebas de API no están en ese bucle? Se encuentran en Apidog detrás de una interfaz gráfica de usuario y se ejecutan cuando alguien recuerda hacer clic. El agente nunca los toca.
La solución es un bloque de configuración. La CLI de Apidog es un paquete npm, apidog-cli, que ejecuta los escenarios de prueba que construyó en Apidog directamente desde una terminal. Una vez que la CLI está instalada y Antigravity sabe que existe, el agente ejecuta un escenario de Apidog de la misma manera que ejecuta sus pruebas unitarias: dispara el comando, lee el código de salida y corrige el código si está en rojo.
Si aún no ha instalado la CLI, hágalo primero. Cómo instalar la CLI de Apidog con un agente de codificación de IA explica la instalación de npm, la autenticación y la primera ejecución, con el agente haciendo la escritura. Este artículo asume que apidog --version imprime un número y que su cuenta de Apidog está autenticada.
De qué Antigravity se trata
Antigravity es la plataforma de desarrollo agéntico de Google, construida sobre Gemini 3, que se lanzó a finales de 2025. Ejecuta el agente a través de un Gestor de Agentes que planifica el trabajo, edita archivos en todo su repositorio y ejecuta comandos de shell en su propio terminal y navegador. El agente es la superficie principal y opera directamente en su máquina local. Si ha abierto Antigravity, iniciado una tarea y observado al agente ejecutar comandos e informar, está en el lugar correcto. Para un recorrido más amplio, consulte qué es Google Antigravity y cómo usarlo.
La distinción importa porque Antigravity tiene su propia forma de aprender las reglas del proyecto, y ese mecanismo convierte un "ejecutar mis pruebas" puntual en algo que el agente busca por sí mismo.
Paso 1: Proporcionar a Antigravity un archivo de reglas
Antigravity reconoce un directorio especial .agents/ en la raíz de su espacio de trabajo. El propio codelab de Google sobre la creación de pipelines de desarrollo autónomos en Antigravity muestra al agente recogiendo de forma nativa los archivos que coloca allí, y las reglas del espacio de trabajo residen en .agents/rules/. Ponga las reglas de su proyecto en un archivo como .agents/rules/apidog.md. Antigravity también lee un archivo AGENTS.md simple en la raíz del espacio de trabajo como base para múltiples herramientas, el mismo archivo que Codex lee para la CLI de Apidog; si ya tiene uno, añada el bloque de Apidog allí en lugar de mantener dos.
Coloque un bloque corto de Apidog en ese archivo de reglas. Algo como esto:
## Pruebas de API con la CLI de Apidog
- Para probar la API, ejecute el escenario de Apidog, no haga clic en la interfaz gráfica de usuario.
- Comando: apidog run -t <scenario_id> -e <env_id> -r cli
- El código de salida 0 significa que todas las aserciones pasaron. Un valor distinto de cero significa un fallo; abra el informe y corrija el código.
- La máquina ya está autenticada a través de `apidog login`. Nunca añada el flag --access-token y nunca ponga un token en este archivo.
Por eso se escribe la CLI en el archivo de reglas en lugar de mencionarla en el chat. Antigravity no recuerda lo que le enseña entre sesiones; cierre la ventana, vuelva a abrirla y el entrenamiento desaparecerá. Un ID de escenario tecleado en el chat desaparece cuando la sesión finaliza. Uno escrito en su archivo de reglas estará ahí para cada compañero de equipo y cada ejecución de Antigravity a partir de ahora.
Paso 2: Obtener el comando de Apidog
No tiene que adivinar los IDs de escenario y entorno. Abra el escenario de prueba en Apidog, vaya a su pestaña CI/CD y copie el comando generado. Se ve así:
apidog run -t 123456 -e 789012 -r cli
El flag -t es el ID del escenario de prueba, -e es el ID del entorno, y -r cli selecciona el reportero que imprime los resultados en línea. Pegue esos IDs reales en su bloque .agents/rules/apidog.md para que el agente ejecute el comando exacto que Apidog le dio. Para cada flag, consulte la referencia del comando apidog run.
Paso 3: Hacer que el agente ejecute la prueba
Con el bloque en su lugar, inicie una tarea en Antigravity. El agente carga sus reglas al principio, por lo que ya sabe que la CLI está allí. Realice un cambio que afecte a su API, o simplemente pídale que ejecute la verificación:
Ejecuta el escenario de prueba de Apidog y dime el código de salida.
El agente emite el comando apidog run desde su archivo de reglas en su propio terminal. Si se ejecuta sin preguntar depende de su configuración de permisos. El Preset de Seguridad de Antigravity determina si usted revisa los comandos de terminal y los accesos a archivos antes de que el agente actúe, como se describe en el codelab de introducción de Google sobre cómo empezar con Antigravity. Si el preset solicita una revisión, apruebe el comando apidog run cuando se le solicite; un escenario de prueba de solo lectura contra un entorno de ensayo es exactamente el tipo de comando seguro, dentro del espacio de trabajo, que está bien aprobar. Si ha configurado el agente para que proceda por sí solo, ejecutará el comando e informará sin detenerse.
Usted quiere ver la ejecución en progreso y al agente informando tanto el resumen como el código de salida, no una paráfrasis.
Paso 4: Leer el informe dentro de Antigravity
Cuando una ejecución falla (se pone en rojo), el informe tiene la respuesta. Con -r cli, el agente obtiene un desglose legible en su terminal: cada solicitud, cada aserción y cuál falló con el valor esperado frente al real. La aserción fallida nombra el campo o código de estado exacto, lo que suele ser suficiente para que el agente encuentre la solución.
Para un informe que pueda abrir en un navegador o entregar a un compañero de equipo, añada el reportero HTML:
apidog run -t 123456 -e 789012 -r cli,html
El reportero html escribe un archivo autocontenido en ./apidog-reports. Mantenga cli en la lista para que el agente siga obteniendo la salida en línea que lee para decidir su siguiente paso. Para ver el conjunto completo de reporteros, incluido el formato JUnit que analizan los paneles de CI, consulte la guía completa de la CLI de Apidog y cómo leer los informes de prueba de la CLI de Apidog.
Antigravity probando dentro de su propio bucle
El punto es lo que sucede cuando deja de preguntar y el agente ejecuta el escenario por sí mismo porque el archivo de reglas se lo indicó.
Imagine al agente editando un controlador que construye una respuesta de pago. Su bucle cambia. Edita el código, luego, en lugar de declarar victoria, ejecuta su escenario de Apidog contra el entorno de ensayo, lee el código de salida y actúa en consecuencia. Si es verde, avanza. Si es rojo, abre el informe, lee qué aserción falló (el código de estado, el campo faltante, el valor incorrecto), intenta una corrección y vuelve a ejecutar. La prueba de API se convierte en parte del mismo bucle de editar-probar-corregir que el agente ya usa para sus pruebas unitarias. Usted escribió una instrucción y el agente incorporó el comando a su funcionamiento habitual.
Este es el modelo de delegar-y-verificar que hace que cualquier flujo de trabajo de agente sea seguro. Antigravity ejecuta el comando y lee el resultado; usted sigue creando escenarios visualmente en Apidog y verifica que el agente lea los códigos de salida honestamente. Para el patrón más amplio, consulte cómo usar agentes de IA para pruebas de API y el arnés de pruebas de IA de Apidog.
Verificar que Antigravity realmente esté ejecutando la CLI
Los agentes reportan éxitos que no obtuvieron, y Antigravity no es una excepción. Tres verificaciones, en orden de la frecuencia con la que detectan problemas.
Primero, confirme que el comando se ejecutó. Antigravity muestra los comandos que ejecutó y su salida en su terminal. Busque la línea literal apidog run ... y un resultado debajo. Si el agente dice que ejecutó las pruebas pero usted no ve el comando, resumió algo que nunca hizo. Pídale que lo ejecute de nuevo y muestre la salida sin procesar.
Segundo, confirme el código de salida, el que importa. Pregunte directamente:
¿Cuál fue el código de salida de ese comando apidog run?
apidog run sale con 0 cuando todas las aserciones pasan y con un valor distinto de cero cuando algo falla. Ese comportamiento único permite al agente, o a un pipeline, tratar la ejecución como una puerta limpia. Cuando la prosa del agente dice "pruebas superadas" pero el código de salida no es cero, el código de salida es el correcto.
Tercero, confirme que utilizó el escenario real. Si una ejecución falla con "escenario no encontrado", el agente podría haber inventado o recordado mal un ID. Vuelva a verificar los valores -t y -e con su archivo de reglas y el comando que Apidog generó en la pestaña CI/CD. Los IDs en su archivo de reglas son la verdad.
Opcional: conectar el servidor MCP de Apidog
Ejecutar apidog run desde su archivo de reglas cubre la mayor parte de lo que necesita. Para ir más allá, conecte un servidor MCP.
Antigravity es compatible con el Protocolo de Contexto del Modelo (MCP), y sus servidores MCP se configuran en el archivo $HOME/.gemini/config/mcp_config.json, según el codelab de introducción de Google. Usted añade un servidor como una entrada en el objeto mcpServers de ese archivo con su command, args y env, luego actualiza MCP en la configuración de Antigravity. El servidor MCP de Apidog expone sus especificaciones de API a través de MCP, para que el agente pueda leer su esquema mientras escribe código, y no solo después. La CLI ejecuta las pruebas; MCP alimenta al agente la especificación.
Cuando Antigravity se equivoca
Algunos fallos aparecen a menudo durante la configuración.
Ignora el archivo de reglas. Si el agente ejecuta un comando genérico o ninguno, es posible que las reglas no se estén cargando. Confirme que el archivo tiene el nombre correcto y que se encuentra donde Antigravity lo espera para su espacio de trabajo, luego inicie una tarea nueva para que vuelva a leer las reglas.
De todos modos, pasa un token de acceso. Si el agente intenta añadir --access-token, está adivinando a partir de ejemplos públicos. Su bloque de reglas ya le dice que no lo haga, ya que la máquina está autenticada a través de apidog login. Refuerce la línea y nunca ponga un token real en el archivo de reglas. Para saber cómo funciona realmente la autenticación, consulte Autenticación de la CLI de Apidog.
Inventa un flag. Un error de "opción desconocida" significa que el agente adivinó un flag que su versión no tiene. Dígale que ejecute apidog run --help y copie el flag exacto de allí, que siempre es correcto para su versión instalada.
Informa de un éxito en una ejecución fallida. Es el más costoso, y la razón por la que la regla del código de salida está en su archivo de reglas y en su paso de verificación. Cuando el resumen y el código de salida no coinciden, el código de salida es el que tiene la razón.
De un agente diario a un bucle probado
Esa es la configuración. Instale apidog-cli una vez siguiendo la guía de instalación, añada un bloque corto de Apidog a su archivo de reglas de Antigravity, y el agente sabrá cómo ejecutar sus pruebas de API y leer el resultado dentro del mismo bucle que ya usa para editar código. Un endpoint roto se detecta mientras el agente aún está trabajando en el cambio, no después de que se despliegue.
Una prueba detrás de una GUI se ejecuta cuando un humano hace clic; un comando de una línea se ejecuta cuando Antigravity lo decide. Usted sigue construyendo escenarios visualmente en Apidog, y su agente los ejecuta donde usted no está mirando. Descargue Apidog, construya un escenario, coloque su comando apidog run en su archivo de reglas y observe cómo el agente lo recoge en el siguiente cambio. Cuando esté listo para ejecutar el mismo comando en un pipeline sin el agente presente, Apidog CLI en GitHub Actions cubre los secretos, reporteros y la verificación de código de salida.