Antigravity é um loop. Seu agente edita arquivos, executa comandos de terminal, lê a saída e decide o que fazer em seguida. Então, por que seus testes de API não estão nesse loop? Eles ficam no Apidog atrás de uma GUI e são executados quando alguém lembra de clicar. O agente nunca os toca.
A solução é um bloco de configuração. A CLI do Apidog é um pacote npm, apidog-cli, que executa os cenários de teste que você construiu no Apidog diretamente de um terminal. Uma vez que a CLI é instalada e o Antigravity sabe que ela existe, o agente executa um cenário do Apidog da mesma forma que executa seus testes de unidade: dispara o comando, lê o código de saída, corrige o código se ele estiver vermelho.
Se você ainda não instalou a CLI, faça isso primeiro. Como instalar a CLI do Apidog com um agente de codificação de IA detalha a instalação via npm, autenticação e a primeira execução, com o agente digitando. Este artigo assume que apidog --version imprime um número e que sua conta Apidog está autenticada.
Sobre qual Antigravity estamos falando
Antigravity é a plataforma de desenvolvimento agentivo do Google, construída sobre o Gemini 3, que foi lançada no final de 2025. Ela executa o agente através de um Gerenciador de Agentes que planeja o trabalho, edita arquivos em seu repositório e executa comandos de shell em seu próprio terminal e navegador. O agente é a superfície primária e opera diretamente em sua máquina local. Se você abriu o Antigravity, iniciou uma tarefa e observou o agente executar comandos e reportar, você está no lugar certo. Para um tour mais abrangente, veja o que é o Google Antigravity e como usá-lo.
A distinção importa porque o Antigravity tem sua própria maneira de aprender as regras do projeto, e esse mecanismo transforma um "execute meus testes" pontual em algo que o agente busca por conta própria.
Passo 1: Forneça um arquivo de regras ao Antigravity
Antigravity reconhece um diretório especial .agents/ na raiz do seu espaço de trabalho. O próprio codelab do Google sobre como construir pipelines de desenvolvedor autônomos no Antigravity mostra o agente pegando nativamente os arquivos que você coloca lá, e as regras do espaço de trabalho residem em .agents/rules/. Coloque suas regras de projeto em um arquivo como .agents/rules/apidog.md. O Antigravity também lê um arquivo AGENTS.md simples na raiz do espaço de trabalho como uma base entre ferramentas, o mesmo arquivo que o Codex lê para a CLI do Apidog; se você já mantém um, adicione o bloco do Apidog lá em vez de manter dois.
Coloque um pequeno bloco Apidog nesse arquivo de regras. Algo assim:
## Teste de API com a CLI do Apidog
- Para testar a API, execute o cenário do Apidog, não clique na GUI.
- Comando: apidog run -t <scenario_id> -e <env_id> -r cli
- Código de saída 0 significa que todas as asserções passaram. Não-zero significa uma falha; abra o relatório e corrija o código.
- A máquina já está autenticada via `apidog login`. Nunca adicione uma flag --access-token e nunca coloque um token neste arquivo.
É por isso que você escreve a CLI no arquivo de regras em vez de mencioná-la no chat. O Antigravity não se lembra do que você ensina entre as sessões; feche a janela, reabra e o treinamento se foi. Um ID de cenário digitado no chat desaparece quando a sessão termina. Um escrito em seu arquivo de regras estará lá para cada colega de equipe e para cada execução do Antigravity a partir de agora.
Passo 2: Obtenha o comando do Apidog
Você não precisa adivinhar os IDs de cenário e ambiente. Abra o cenário de teste no Apidog, vá para a aba CI/CD e copie o comando gerado. Ele se parece com isto:
apidog run -t 123456 -e 789012 -r cli
A flag -t é o ID do cenário de teste, -e é o ID do ambiente, e -r cli seleciona o reporter que imprime os resultados inline. Cole esses IDs reais no seu bloco .agents/rules/apidog.md para que o agente execute o comando exato que o Apidog lhe deu. Para cada flag, veja a referência do comando apidog run.
Passo 3: Peça ao agente para executar o teste
Com o bloco no lugar, inicie uma tarefa no Antigravity. O agente carrega suas regras ao iniciar, então ele já sabe que a CLI está lá. Faça uma alteração que afete sua API, ou apenas peça para ele executar a verificação:
Execute o cenário de teste do Apidog e me diga o código de saída.
O agente emite o comando apidog run do seu arquivo de regras em seu próprio terminal. Se ele executa sem perguntar, depende de sua configuração de permissão. O Preset de Segurança do Antigravity determina se os comandos de terminal e os acessos a arquivos são revisados por você antes que o agente aja, conforme descrito no codelab de introdução ao Antigravity do Google. Se o preset solicitar revisão, aprove o comando apidog run quando for solicitado; um cenário de teste somente leitura contra um ambiente de homologação é exatamente o tipo de comando seguro e dentro do espaço de trabalho que é bom de aprovar. Se você configurou o agente para prosseguir por conta própria, ele executa o comando e reporta sem parar.
Você quer ver a execução acontecendo e o agente relatando tanto o resumo quanto o código de saída, não uma paráfrase.
Passo 4: Leia o relatório dentro do Antigravity
Quando uma execução falha (fica "vermelha"), o relatório tem a resposta. Com -r cli, o agente obtém um detalhamento legível em seu terminal: cada requisição, cada asserção e qual falhou com o valor esperado versus o valor real. A asserção falha nomeia o campo exato ou o código de status, o que geralmente é suficiente para o agente encontrar a correção.
Para um relatório que você pode abrir em um navegador ou entregar a um colega de equipe, adicione o reporter HTML:
apidog run -t 123456 -e 789012 -r cli,html
O reporter html escreve um arquivo auto-contido em ./apidog-reports. Mantenha cli na lista para que o agente ainda receba a saída inline que ele lê para decidir seu próximo passo. Para o conjunto completo de reporters, incluindo o formato JUnit que os painéis de CI analisam, veja o guia completo da CLI do Apidog e como ler os relatórios de teste da CLI do Apidog.
Antigravity testando dentro de seu próprio loop
O ponto é o que acontece quando você para de pedir e o agente executa o cenário por conta própria porque o arquivo de regras o instruiu.
Imagine o agente editando um handler que constrói uma resposta de checkout. Seu loop muda. Ele edita o código, então, em vez de declarar vitória, executa seu cenário Apidog contra o ambiente de homologação, lê o código de saída e age sobre ele. Verde, ele segue em frente. Vermelho, ele abre o relatório, lê qual asserção falhou (o código de status, o campo ausente, o valor errado), tenta uma correção e executa novamente. O teste de API se torna parte do mesmo loop de edição-teste-correção pelo qual o agente já executa seus testes de unidade. Você escreveu uma instrução e o agente incorporou o comando em como ele já funciona.
Este é o modelo de "delegar e depois verificar" que torna qualquer fluxo de trabalho de agente seguro. O Antigravity executa o comando e lê o resultado; você continua criando cenários visualmente no Apidog e verifica se o agente lê os códigos de saída honestamente. Para o padrão mais amplo, veja como usar agentes de IA para testes de API e o arnes de teste de IA do Apidog.
Verifique se o Antigravity está realmente executando a CLI
Agentes relatam sucesso que não conquistaram, e o Antigravity não é exceção. Três verificações, na ordem de quão frequentemente elas detectam problemas.
Primeiro, confirme se o comando foi executado. O Antigravity mostra os comandos que executou e suas saídas em seu terminal. Procure pela linha literal apidog run ... e um resultado abaixo dela. Se o agente disser que executou os testes, mas você não vir o comando, ele resumiu algo que nunca fez. Peça para ele executar novamente e mostrar a saída bruta.
Segundo, confirme o código de saída, aquele que importa. Pergunte diretamente:
Qual foi o código de saída do comando apidog run?
apidog run sai com 0 quando todas as asserções passam e não-zero quando algo falha. Esse comportamento único permite que o agente, ou um pipeline, trate a execução como um portão limpo. Quando o texto do agente diz "testes passaram" mas o código de saída é não-zero, o código de saída está correto.
Terceiro, confirme se ele usou o cenário real. Se uma execução falhar com "cenário não encontrado", o agente pode ter inventado ou se lembrado de um ID incorreto. Verifique novamente os valores de -t e -e em seu arquivo de regras e no comando que o Apidog gerou na aba CI/CD. Os IDs em seu arquivo de regras são a verdade.
Opcional: conecte o servidor MCP do Apidog
Executar apidog run a partir do seu arquivo de regras cobre a maior parte do que você precisa. Para ir além, conecte um servidor MCP.
O Antigravity suporta o Protocolo de Contexto de Modelo (MCP), e seus servidores MCP são configurados no arquivo $HOME/.gemini/config/mcp_config.json, conforme o codelab de introdução do Google ao Antigravity. Você adiciona um servidor como uma entrada no objeto mcpServers desse arquivo com seus command, args e env, e então atualiza o MCP nas configurações do Antigravity. O servidor MCP do Apidog expõe suas especificações de API via MCP, para que o agente possa ler seu esquema enquanto escreve código, não apenas depois. A CLI executa os testes; o MCP alimenta o agente com a especificação.
Quando o Antigravity erra
Algumas falhas aparecem frequentemente durante a configuração.
Ele ignora o arquivo de regras. Se o agente executa um comando genérico ou nenhum, as regras podem não estar sendo carregadas. Confirme se o arquivo está nomeado corretamente e se encontra onde o Antigravity espera para o seu espaço de trabalho, então inicie uma nova tarefa para que ele releia as regras.
Ele passa um token de acesso de qualquer forma. Se o agente tentar adicionar --access-token, ele está adivinhando a partir de exemplos públicos. Seu bloco de regras já o instrui a não fazer isso, já que a máquina está autenticada via apidog login. Reforce a linha e nunca coloque um token real no arquivo de regras. Para saber como a autenticação realmente funciona, veja autenticação da CLI do Apidog.
Ele inventa uma flag. Um erro de "opção desconhecida" significa que o agente adivinhou uma flag que sua versão não possui. Diga a ele para executar apidog run --help e copiar a flag exata de lá, que estará sempre correta para sua versão instalada.
Ele relata um sucesso em uma execução que falhou. Este é o mais caro, e a razão pela qual a regra do código de saída está em seu arquivo de regras e em sua etapa de verificação. Quando o resumo e o código de saída discordam, o código de saída prevalece.
De um agente diário a um loop testado
Essa é a configuração. Instale o apidog-cli uma vez seguindo o guia de instalação, adicione um pequeno bloco Apidog ao seu arquivo de regras do Antigravity, e o agente saberá como executar seus testes de API e ler o resultado dentro do mesmo loop que ele já usa para editar código. Um endpoint quebrado é detectado enquanto o agente ainda está trabalhando na mudança, não depois que ela é implementada.
Um teste atrás de uma GUI é executado quando um humano clica; um comando de uma linha é executado sempre que o Antigravity decide. Você continua construindo cenários visualmente no Apidog, e seu agente os executa onde você não está observando. Baixe o Apidog, construa um cenário, coloque seu comando apidog run em seu arquivo de regras, e observe o agente o pegar na próxima mudança. Quando estiver pronto para executar o mesmo comando em um pipeline sem o agente presente, A CLI do Apidog no GitHub Actions cobre os segredos, reporters e a validação do código de saída.