Antigravity는 루프입니다. 에이전트가 파일을 편집하고, 터미널 명령을 실행하고, 출력을 읽고, 다음 작업을 결정합니다. 그렇다면 왜 API 테스트는 이 루프에 포함되지 않을까요? API 테스트는 GUI 뒤 Apidog에 있으며 누군가 클릭해야 실행됩니다. 에이전트는 결코 이들을 건드리지 않습니다.
해결책은 하나의 구성 블록입니다. Apidog CLI는 Apidog에서 구축한 테스트 시나리오를 터미널에서 직접 실행하는 npm 패키지인 apidog-cli입니다. CLI가 설치되고 Antigravity가 그 존재를 알면, 에이전트는 유닛 테스트를 실행하는 것과 동일한 방식으로 Apidog 시나리오를 실행합니다: 명령을 실행하고, 종료 코드를 읽고, 빨간색이면 코드를 수정합니다.
아직 CLI를 설치하지 않았다면 먼저 설치하십시오. AI 코딩 에이전트로 Apidog CLI를 설치하는 방법은 에이전트가 직접 입력하는 npm 설치, 인증 및 첫 실행 과정을 안내합니다. 이 문서는 apidog --version이 숫자를 출력하고 Apidog 계정이 인증된 상태라고 가정합니다.
여기서 말하는 Antigravity는 무엇인가
Antigravity는 2025년 말에 출시된 Gemini 3 기반의 Google의 에이전트 개발 플랫폼입니다. 이는 작업을 계획하고, 리포지토리 전체의 파일을 편집하고, 자체 터미널과 브라우저에서 셸 명령을 실행하는 Agent Manager를 통해 에이전트를 실행합니다. 에이전트가 주요 인터페이스이며, 로컬 머신에서 직접 작동합니다. Antigravity를 열고 작업을 시작했으며 에이전트가 명령을 실행하고 보고하는 것을 지켜보셨다면, 제대로 찾아오셨습니다. 더 넓은 범위의 둘러보기는 Google Antigravity가 무엇이며 어떻게 사용하는지를 참조하십시오.
Antigravity는 프로젝트 규칙을 학습하는 자체적인 방식이 있으며, 이 메커니즘이 일회성 "내 테스트 실행"을 에이전트가 스스로 수행하는 작업으로 전환시키기 때문에 이러한 구분이 중요합니다.
1단계: Antigravity에 규칙 파일 제공
Antigravity는 작업 공간 루트에 특수 .agents/ 디렉토리를 인식합니다. Antigravity에서 자율 개발자 파이프라인 구축에 대한 Google의 자체 코드랩은 에이전트가 해당 위치에 배치한 파일을 기본적으로 가져오는 것을 보여주며, 작업 공간 규칙은 .agents/rules/에 있습니다. 프로젝트 규칙을 .agents/rules/apidog.md와 같은 파일에 넣으십시오. Antigravity는 또한 작업 공간 루트에 있는 일반 AGENTS.md를 크로스 도구 기반으로 읽는데, 이는 Codex가 Apidog CLI를 위해 읽는 것과 동일한 파일입니다. 이미 가지고 있다면, 두 개를 유지하는 대신 Apidog 블록을 그곳에 추가하십시오.
해당 규칙 파일에 짧은 Apidog 블록을 넣으십시오. 다음과 같습니다:
## Apidog CLI를 사용한 API 테스트
- API를 테스트하려면 GUI를 클릭하지 말고 Apidog 시나리오를 실행하십시오.
- 명령어: apidog run -t <scenario_id> -e <env_id> -r cli
- 종료 코드 0은 모든 어설션이 통과했음을 의미합니다. 0이 아닌 값은 실패를 의미합니다. 보고서를 열고 코드를 수정하십시오.
- 머신은 이미 `apidog login`을 통해 인증되었습니다. 절대로 --access-token 플래그를 추가하거나 이 파일에 토큰을 넣지 마십시오.
이것이 CLI를 채팅에서 언급하는 대신 규칙 파일에 작성하는 이유입니다. Antigravity는 세션 간에 가르친 것을 기억하지 못합니다. 창을 닫고 다시 열면 코칭은 사라집니다. 채팅에 입력된 시나리오 ID는 세션이 끝나면 사라집니다. 규칙 파일에 작성된 내용은 이제부터 모든 팀원과 모든 Antigravity 실행에서 사용할 수 있습니다.
2단계: Apidog에서 명령 가져오기
시나리오 및 환경 ID를 추측할 필요가 없습니다. Apidog에서 테스트 시나리오를 열고 CI/CD 탭으로 이동하여 생성된 명령을 복사하십시오. 다음과 같습니다:
apidog run -t 123456 -e 789012 -r cli
-t 플래그는 테스트 시나리오 ID이고, -e는 환경 ID이며, -r cli는 결과를 인라인으로 출력하는 리포터를 선택합니다. Apidog가 제공한 정확한 명령을 에이전트가 실행하도록 해당 실제 ID를 .agents/rules/apidog.md 블록에 붙여넣으십시오. 각 플래그에 대해서는 apidog run 명령 참조를 참조하십시오.
3단계: 에이전트에게 테스트 실행 요청
블록이 준비되면 Antigravity에서 작업을 시작합니다. 에이전트는 시작할 때 규칙을 로드하므로 CLI가 있음을 이미 알고 있습니다. API에 영향을 미치는 변경 사항을 만들거나 단순히 검사를 실행하도록 요청하십시오:
Apidog 테스트 시나리오를 실행하고 종료 코드를 알려주세요.
에이전트는 자체 터미널에서 규칙 파일에 있는 apidog run 명령을 실행합니다. 요청 없이 실행될지 여부는 권한 설정에 따라 달라집니다. Antigravity의 보안 프리셋은 Google의 Antigravity 시작 코드랩에 설명된 대로 에이전트가 행동하기 전에 터미널 명령 및 파일 액세스가 사용자에게 검토될지 여부를 결정합니다. 프리셋이 검토를 요청하면, 프롬프트가 표시될 때 apidog run 명령을 승인하십시오. 스테이징에 대한 읽기 전용 테스트 시나리오는 승인해도 괜찮은 안전한 작업 공간 내 명령 유형입니다. 에이전트가 스스로 진행하도록 설정했다면, 멈추지 않고 명령을 실행하고 보고합니다.
실행이 진행되고 에이전트가 요약과 종료 코드를 모두 보고하는 것을 보고 싶을 것입니다. 패러프레이징된 보고가 아닙니다.
4단계: Antigravity 내에서 보고서 읽기
실행이 실패하면 보고서에 답이 있습니다. -r cli를 사용하면 에이전트가 터미널에서 읽기 쉬운 분석을 얻습니다. 각 요청, 각 어설션, 그리고 예상 값과 실제 값 중 어떤 것이 실패했는지 명확하게 알 수 있습니다. 실패한 어설션은 정확한 필드나 상태 코드를 명시하며, 이는 일반적으로 에이전트가 수정 사항을 찾는 데 충분합니다.
브라우저에서 열거나 팀원에게 전달할 수 있는 보고서의 경우 HTML 리포터를 추가하십시오:
apidog run -t 123456 -e 789012 -r cli,html
html 리포터는 ./apidog-reports에 자체 포함된 파일을 작성합니다. 에이전트가 다음 단계를 결정하기 위해 읽는 인라인 출력을 계속 받도록 목록에 cli를 유지하십시오. JUnit 형식 CI 대시보드 구문 분석을 포함한 전체 리포터 세트는 전체 Apidog CLI 가이드 및 Apidog CLI 테스트 보고서 읽는 방법을 참조하십시오.
Antigravity 자체 루프 내에서 테스트하기
핵심은 당신이 요청을 중단하고 규칙 파일이 시나리오를 실행하도록 지시하여 에이전트가 스스로 시나리오를 실행할 때 발생하는 일입니다.
체크아웃 응답을 구축하는 핸들러를 편집하는 에이전트를 상상해 보세요. 에이전트의 루프가 바뀝니다. 코드를 편집한 다음, 성공을 선언하는 대신 스테이징에 대해 Apidog 시나리오를 실행하고, 종료 코드를 읽고, 그에 따라 행동합니다. 녹색이면 다음으로 넘어갑니다. 빨간색이면 보고서를 열고 어떤 어설션이 실패했는지(상태 코드, 누락된 필드, 잘못된 값) 읽고, 수정하려고 시도한 후 다시 실행합니다. API 테스트는 에이전트가 이미 유닛 테스트를 실행하는 것과 동일한 편집-테스트-수정 루프의 일부가 됩니다. 당신은 하나의 지침을 작성했고 에이전트는 그 명령을 기존 작업 방식에 통합했습니다.
이것이 모든 에이전트 워크플로우를 안전하게 만드는 위임-검증 모델입니다. Antigravity는 명령을 실행하고 결과를 읽습니다. 당신은 Apidog에서 시나리오를 시각적으로 계속 작성하고 에이전트가 종료 코드를 정직하게 읽는지 스팟-체크합니다. 더 넓은 패턴에 대해서는 AI 에이전트를 사용하여 API 테스트를 수행하는 방법 및 Apidog AI 테스트 하니스를 참조하십시오.
Antigravity가 실제로 CLI를 실행하는지 확인
에이전트는 얻지 못한 성공을 보고하며, Antigravity도 예외는 아닙니다. 문제점을 잡아내는 빈도 순으로 세 가지 확인 사항입니다.
첫째, 명령이 실제로 실행되었는지 확인하십시오. Antigravity는 실행된 명령과 해당 출력을 터미널에 표시합니다. 문자 그대로 apidog run ... 줄과 그 아래의 결과를 찾으십시오. 에이전트가 테스트를 실행했다고 말했지만 명령이 보이지 않는다면, 에이전트가 수행하지 않은 작업을 요약한 것입니다. 다시 실행하고 원시 출력을 보여달라고 요청하십시오.
둘째, 중요한 종료 코드를 확인하십시오. 직접 물어보십시오:
그 apidog run 명령의 종료 코드는 무엇이었습니까?
apidog run은 모든 어설션이 통과하면 0으로 종료하고, 무언가 실패하면 0이 아닌 값으로 종료합니다. 이 단일 동작을 통해 에이전트 또는 파이프라인은 실행을 깨끗한 게이트로 처리할 수 있습니다. 에이전트의 설명이 "테스트 통과"라고 말하지만 종료 코드가 0이 아닌 경우, 종료 코드가 맞습니다.
셋째, 실제 시나리오를 사용했는지 확인하십시오. "시나리오를 찾을 수 없음"으로 실행이 실패하면 에이전트가 ID를 발명했거나 잘못 기억했을 수 있습니다. 규칙 파일과 CI/CD 탭에서 Apidog가 생성한 명령에 대해 -t 및 -e 값을 다시 확인하십시오. 규칙 파일의 ID가 진실입니다.
선택 사항: Apidog MCP 서버 연결
규칙 파일에서 apidog run을 실행하는 것으로 필요한 대부분을 처리할 수 있습니다. 더 나아가려면 MCP 서버를 연결하십시오.
Antigravity는 모델 컨텍스트 프로토콜(MCP)을 지원하며, 해당 MCP 서버는 Google의 시작 코드랩에 따라 $HOME/.gemini/config/mcp_config.json 파일에 구성됩니다. 해당 파일의 mcpServers 객체에 command, args, env를 사용하여 서버를 항목으로 추가한 다음 Antigravity 설정에서 MCP를 새로 고칩니다. Apidog MCP 서버는 MCP를 통해 API 사양을 노출하므로, 에이전트는 코드를 작성하는 동안 스키마를 읽을 수 있으며, 나중에 읽는 것이 아닙니다. CLI는 테스트를 실행하고, MCP는 에이전트에게 사양을 제공합니다.
Antigravity가 잘못되었을 때
설정 중에 몇 가지 오류가 자주 나타납니다.
규칙 파일을 무시합니다. 에이전트가 일반 명령을 실행하거나 전혀 실행하지 않는 경우, 규칙이 로드되지 않을 수 있습니다. 파일 이름이 올바르고 Antigravity가 작업 공간에 대해 예상하는 위치에 있는지 확인한 다음, 규칙을 다시 읽도록 새 작업을 시작하십시오.
어쨌든 액세스 토큰을 전달합니다. 에이전트가 --access-token을 추가하려고 시도하면, 공개 예제에서 추측하는 것입니다. 머신이 apidog login을 통해 인증되었으므로 규칙 블록은 이미 그렇게 하지 말라고 지시하고 있습니다. 해당 지시를 강화하고, 규칙 파일에 실제 토큰을 절대 넣지 마십시오. 인증이 실제로 어떻게 작동하는지는 Apidog CLI 인증을 참조하십시오.
플래그를 발명합니다. "알 수 없는 옵션" 오류는 에이전트가 사용 중인 버전에는 없는 플래그를 추측했음을 의미합니다. apidog run --help를 실행하도록 지시하고, 거기에 있는 정확한 플래그를 복사하십시오. 이는 설치된 버전에 항상 올바릅니다.
실패한 실행에 대해 통과를 보고합니다. 가장 비용이 많이 드는 것이며, 종료 코드 규칙이 규칙 파일 및 검증 단계에 있는 이유입니다. 요약과 종료 코드가 일치하지 않으면 종료 코드가 우선합니다.
일상적인 에이전트에서 테스트 루프까지
이것이 설정입니다. 설치 가이드에 따라 apidog-cli를 한 번 설치하고, Antigravity 규칙 파일에 짧은 Apidog 블록을 추가하면, 에이전트는 코드를 편집하는 데 이미 사용하는 동일한 루프 내에서 API 테스트를 실행하고 결과를 읽는 방법을 알게 됩니다. 깨진 엔드포인트는 변경 사항이 배포된 후가 아니라 에이전트가 변경 작업을 하는 동안 발견됩니다.
GUI 뒤의 테스트는 사람이 클릭할 때 실행됩니다. 한 줄짜리 명령은 Antigravity가 결정할 때마다 실행됩니다. 당신은 Apidog에서 시나리오를 시각적으로 계속 구축하고, 에이전트는 당신이 보지 않는 곳에서 시나리오를 실행합니다. Apidog를 다운로드하고, 하나의 시나리오를 구축하고, 그 apidog run 명령을 규칙 파일에 넣으면, 다음 변경 시 에이전트가 이를 가져가는 것을 볼 수 있습니다. 에이전트 없이 파이프라인에서 동일한 명령을 실행할 준비가 되면 GitHub Actions의 Apidog CLI에서 비밀, 리포터 및 종료 코드 게이팅을 다룹니다.