Browser 기능 이해하기
학습 목표
- Browser 기능이 무엇인지 이해할 수 있다
- Chrome Extension 설치 방법을 익힐 수 있다
- Browser Subagent의 작동 방식을 이해할 수 있다
1. Browser란?
Anti-Gravity의 Browser 기능은 AI가 Chrome 브라우저를 직접 제어할 수 있게 해주는 강력한 도구입니다.
1.1 Browser로 할 수 있는 것
| 기능 | 설명 | 예시 |
|---|---|---|
| 웹사이트 테스트 | 개발 중인 웹사이트 확인 | localhost:3000 테스트 |
| 정보 수집 | 웹에서 데이터 가져오기 | API 문서 참조 |
| 자동화 | 반복 작업 자동 수행 | 폼 작성, 스크린샷 |
1.2 작동 방식
사용자 요청 → Agent → Browser Subagent → Chrome 브라우저
↓
작업 수행 (클릭, 스크롤, 타이핑 등)
↓
결과 반환
💡 알아두세요
Browser는 일반 Chrome과 별도의 프로필로 실행됩니다. 개인 브라우저의 로그인 정보나 쿠키와 완전히 분리되어 안전합니다.
2. Chrome Extension 설치
Browser 기능을 사용하려면 Chrome Extension 설치가 필요합니다.
2.1 설치 전 확인사항
- Chrome 브라우저 설치 여부
- 인터넷 연결 상태
2.2 자동 설치 (권장)
Anti-Gravity에서 처음 Browser 기능을 사용하면 자동으로 Chrome 웹 스토어로 안내됩니다.
- Anti-Gravity에서 Browser 작업 요청
- Chrome 웹 스토어 페이지가 자동으로 열림
- "Chrome에 추가" 버튼 클릭
- 권한 확인 후 설치 완료
2.3 수동 설치
자동 설치가 되지 않는 경우 아래 방법을 사용하세요.
Chrome 웹 스토어에서 설치
- Chrome 웹 스토어 접속
- "Chrome에 추가" 버튼 클릭

3. Browser Subagent 이해하기
Browser를 제어하는 것은 Browser Subagent라는 전문 AI입니다.
3.1 Browser Subagent란?
Agent가 브라우저 작업을 요청하면, Browser Subagent가 자동으로 호출되어 작업을 수행합니다. Browser Subagent는 웹 페이지 조작에 특화된 별도의 AI 모델을 사용하므로, 메인 Agent와는 다른 모델이 동작합니다.
3.2 Subagent가 할 수 있는 것
| 도구 | 설명 |
|---|---|
| 클릭 | 버튼, 링크 클릭 |
| 스크롤 | 페이지 위/아래 이동 |
| 타이핑 | 입력 필드에 텍스트 입력 |
| 읽기 | 페이지 내용 읽기 (DOM, 스크린샷, 마크다운) |
| 녹화 | 작업 과정 비디오 녹화 |
| 콘솔 로그 | 브라우저 콘솔 로그 읽기 |
3.3 별도 Chrome 프로필
Anti-Gravity의 Browser는 일반 브라우징과 격리하기 위해 별도의 Chrome 프로필에서 실행됩니다. 따라서:
- 작업 표시줄/독에 별도 애플리케이션으로 표시됨
- 기존 Chrome 로그인 정보와 분리되어 아무것도 로그인되어 있지 않음
- 브라우저 도구를 비활성화하려면 Settings > Browser 에서 설정 가능
💡 Chrome 감지 실패 시
Anti-Gravity가 Chrome을 감지하지 못하면 Settings에서 Chrome 바이너리 경로를 직접 지정할 수 있습니다.
3.4 작업 중 화면 표시
Browser Subagent가 작업 중일 때 다음과 같은 표시가 나타납니다.
- 페이지에 파란색 테두리 표시
- 작은 패널에 현재 수행 중인 작업 설명
- 사용자는 해당 페이지 조작 불가 (충돌 방지)
💡 동시 작업 가능
Browser Subagent는 포커스되지 않은 탭에서도 작업합니다. 다른 탭에서 자유롭게 작업할 수 있습니다.
4. URL 보안 설정
Anti-Gravity는 보안을 위해 접속 가능한 URL을 관리합니다.
4.1 Allowlist (허용 목록)
신뢰할 수 있는 URL을 명시적으로 허용합니다.
- 기본값:
localhost만 허용 - 새 URL 접속 시 "Always Allow" 버튼으로 추가 가능
4.2 Denylist (차단 목록)
위험하거나 악성 URL은 자동으로 차단됩니다.
- Google 서버에서 관리
- 사용자가 수정 불가
- Denylist가 Allowlist보다 우선
4.3 새 URL 허용하기
처음 방문하는 URL에 접속할 때 다음 절차를 따릅니다.
- Anti-Gravity가 확인 메시지 표시
- "Always Allow" 버튼 클릭
- URL이 Allowlist에 추가됨
- 이후 같은 URL은 자동 허용
5. Browser 설정
5.1 Browser 도구 활성화/비활성화
Browser 기능을 사용하지 않으려면 다음과 같이 설정합니다.
- 설정(Settings) 열기
- "Browser" 섹션 찾기
- "Enable Browser Tools" 토글
5.2 Chrome 경로 설정
Chrome이 자동 감지되지 않는 경우 아래 방법을 사용하세요.
- 설정에서 "Chrome Binary Path" 찾기
- Chrome 실행 파일 경로 직접 입력
- 비워두면 자동 감지 시도
6. 다음 단계
Browser 기능의 개념을 이해했다면, 실제로 사용해봅시다.
Browser 실습 예제에서 웹 페이지를 탐색하고 정보를 수집하는 방법을 배울 수 있습니다.