Antigravity Agent

Antigravity 에이전트는 Gemini API의 범용 관리형 에이전트입니다. 단일 API 호출을 통해 Google에서 호스팅하는 자체 보안 Linux 샌드박스 내에서 추론하고, 코드를 실행하고, 파일을 관리하고, 웹을 탐색하는 에이전트를 얻을 수 있습니다.

Gemini 3.6 Flash로 구동되며 Antigravity IDE와 동일한 하네스를 사용합니다. agent_config를 사용하여 기본 Gemini 모델을 구성할 수 있습니다. Interactions API 및 Google AI Studio를 통해 사용할 수 있습니다.

Python

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    agent="antigravity-preview-05-2026",
    input="Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
    environment="remote",
)

print(interaction.output_text)

자바스크립트

import { GoogleGenAI } from "@google/genai";

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
    agent: "antigravity-preview-05-2026",
    input: "Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
    environment: "remote",
}, { timeout: 300000 });

console.log(interaction.output_text);

REST

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-d '{
    "agent": "antigravity-preview-05-2026",
    "input": "Read Hacker News, summarize the top 10 stories, and save the results as a PDF.",
    "environment": "remote"
}'

기능

각 호출은 Linux 샌드박스를 프로비저닝하고 도구 사용 루프를 시작할 수 있습니다. 에이전트는 작업을 완료할 때까지 계획하고, 행동하고, 결과를 관찰하고, 이를 반복합니다.

코드 실행: Bash, Python, Node.js 명령어를 실행합니다. 패키지 설치, 테스트 실행, 앱 빌드
파일 관리: 샌드박스에서 파일을 읽고, 쓰고, 수정하고, 검색하고, 나열합니다. 파일은 상호작용 전반에 걸쳐 유지됩니다.
웹 액세스: 데이터에 대한 Google 검색 및 URL 가져오기
컨텍스트 압축: 컨텍스트를 손실하거나 토큰 한도에 도달하지 않고 장기 실행 멀티턴 세션을 지원하기 위해 자동 컨텍스트 압축이 트리거됩니다 (~135, 000개 토큰).

멀티턴 사용 및 스트리밍은 빠른 시작을 참고하세요.

지원되는 도구

기본적으로 에이전트는 code_execution, google_search, url_context에 액세스할 수 있습니다. environment 매개변수를 지정하면 파일 시스템 도구가 자동으로 사용 설정됩니다. 맞춤 함수를 정의하여 에이전트를 자체 API 및 도구에 연결할 수도 있습니다. 기본 세트를 맞춤설정하거나 제한할 때 또는 맞춤 함수를 추가할 때만 tools 매개변수를 지정하면 됩니다.

도구	유형 값	설명
코드 실행	`code_execution`	stdout/stderr 캡처를 사용하여 셸 명령어 (bash, Python, Node)를 실행합니다.
Google 검색	`google_search`	공개 웹을 검색합니다.
URL 컨텍스트	`url_context`	웹페이지를 가져오고 읽습니다.
파일 시스템	(`environment`을 통해 사용 설정됨)	샌드박스에서 파일을 읽고, 쓰고, 수정하고, 검색하고, 나열합니다. `environment`를 설정하면 시스템에서 이러한 도구를 자동으로 사용 설정합니다.
맞춤 함수	`function`	에이전트가 실행을 요청할 수 있는 맞춤 함수를 정의합니다. 함수 호출을 참조하세요.
원격 MCP 서버	`mcp_server`	외부 모델 컨텍스트 프로토콜 (MCP) 서버를 도구로 등록합니다.