구글 Antigravity SDK 알아보기 - 직접 만드는 나만의 AI Agent
요즘에는 단순히 질문에 답만 하는 챗봇을 넘어, 스스로 판단하고 행동하는 AI 에이전트를 구축하는 것이 트렌드다. 구글의 안티그래비티(Antigravity) SDK는 AI Agent를 내 프로젝트에 손쉽게 도입할 수 있도록 도와준다.
1. 안티그래비티 SDK란 무엇인가?
Antigravity SDK는 내 컴퓨터의 파일을 읽고, 프로그램을 실행하며, 스스로 생각해서 업무를 수행하는 AI Agent를 만들기 위한 도구 세트다.
단순히 OpenAI나 구글 Gemini API를 연결해 텍스트 답변만 받는 수준을 넘어선다. “내 프로젝트 폴더를 읽고 보안 취약점을 분석해 줘”라고 명령하면, AI가 알아서 코드를 훑어보고 보고서까지 작성하는 프로그램을 만들 때 이 SDK를 사용하면 된다.
설치는 위와같이 하면 된다.
pip3 install google-antigravity터미널에 위 명령어 입력해주고 설치.
이후 환경변수에 GEMINI_API_KEY를 추가해준다.
GEMINI_API_KEY는 Google AI Studio에서 받을 수 있다.
2. 핵심 기능 살펴보기
Readme에 등장하는 주요 기능과 특징을 요약하면 다음과 같다.
① 말 한마디로 시작하는 AI
복잡한 설정 필요 없이 몇 줄의 코드만으로 똑똑한 AI 에이전트를 만들 수 있다. system_instructions라는 옵션을 통해 “당신은 코드 탐색 전문가입니다”와 같이 AI에게 구체적인 역할(지침)을 부여하면 된다.
② 실시간 답변 및 생각 스트리밍
AI가 답변을 모두 작성할 때까지 기다릴 필요가 없다. 글자가 실시간으로 타닥타닥 출력되는 스트리밍 기능을 지원한다.
특히 고급 기능으로 AI가 속으로 무슨 생각을 하고 있는지, 어떤 도구를 쓸지 고민하는 과정까지 실시간으로 화면에 띄울 수 있다.
③ 이미지, 영상, PDF를 모두 다룰 수 있다 - 멀티모달
텍스트 프롬프트뿐만 아니라 이미지, 영상, 오디오, PDF 문서 등 다양한 미디어 파일을 AI에게 한 번에 던져줄 수 있다. 예를 들어 설계도 이미지 파일과 PDF를 같이 주면서 “두 파일을 비교해 줘”라고 명령해도 알아듣는다.
④ 나만의 커스텀 AI 만들기
개발자가 직접 만든 파이썬 함수나 외부 MCP(Model Context Protocol) 서버를 AI가 써먹을 도구로 등록 해둘 수 있다. 예를들어, 날씨를 조회하는 함수를 만들어 등록해 두면, AI가 대화 중 날씨 질문을 받았을 때 알아서 그 함수를 실행해 정답을 찾아낸다.
⑤ 철저한 통제 및 안전 시스템
AI가 내 컴퓨터의 파일을 마음대로 지우거나 위험한 명령어를 실행하면 안 되므로, 강력한 행동 지침을 내릴 수 있다.
-
allow("view_file"): 파일 읽기는 마음대로 허용한다. -
ask_user("run_command"): 명령어 실행 전에는 반드시 사용자에게 허락을 구한다. -
deny("*"): 기본적으로 지정되지 않은 모든 위험한 행동은 차단한다.
⑥ 알아서 일하는 스케줄러
내가 먼저 말을 걸지 않아도 백그라운드에서 스스로 작동하게 만들 수 있다. “60초마다 한 번씩 배포 상태를 확인해라”와 같은 트리거를 설정해 두면 혼자서 감시 업무를 수행한다.
3. 안티그래비티 SDK의 3단계 구조 (Architecture)
이 SDK는 개발자의 숙련도와 자유도에 따라 골라 쓸 수 있도록 3개의 계층으로 설계되어 있다.
| 단계 | 계층 이름 | 설명 |
|---|---|---|
| Layer 1 | Simplified | 종합 자동 조립 세트. Agent 클래스 하나로 내부적인 바이너리 검색, 도구 연결, 정책 설정을 알아서 처리해 준다. 초보자나 빠른 구현에 적합하다. |
| Layer 2 | Session | 정밀 수동 조립 세트. 대화 히스토리를 세부적으로 관리하고, AI의 행동을 한 단계씩 쪼개서 제어하고 싶을 때 Conversation 클래스를 사용하면 된다. |
| Layer 3 | Adapter | 부품 단위 조립. AI와 시스템이 어떻게 통신하고 연결되는지, 네트워크나 백엔드 추상화 자체를 뜯어고치고 싶은 전문가용 영역이다. |
요약
구글 안티그래비티 SDK는 파일, 이미지, 시스템 제어 권한을 AI에게 안전하게 부여하고, 강력한 보안 정책 안에서 똑똑하게 부려먹을 수 있는 ‘나만의 AI 에이전트 개발 세트’라고 보면 된다.
내가 원하는 기능을 가진 맞춤형 AI 비서를 빠르게 개발하고 싶다면 이 SDK를 적극 활용해 보길 권한다.