본문 바로가기

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 설치가 필요합니다.

💡 이미 설치하셨나요?

Chapter 2 설치 가이드

에서 이미 설치했다면, Browser Subagent로 이동하세요.

2.1 설치 전 확인사항

  • Chrome 브라우저 설치 여부
  • 인터넷 연결 상태

2.2 자동 설치 (권장)

Anti-Gravity에서 처음 Browser 기능을 사용하면 자동으로 Chrome 웹 스토어로 안내됩니다.

  1. Anti-Gravity에서 Browser 작업 요청
  2. Chrome 웹 스토어 페이지가 자동으로 열림
  3. "Chrome에 추가" 버튼 클릭
  4. 권한 확인 후 설치 완료

2.3 수동 설치

자동 설치가 되지 않는 경우 아래 방법을 사용하세요.

Chrome 웹 스토어에서 설치

  1. Chrome 웹 스토어 접속
  2. "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에 접속할 때 다음 절차를 따릅니다.

  1. Anti-Gravity가 확인 메시지 표시
  2. "Always Allow" 버튼 클릭
  3. URL이 Allowlist에 추가됨
  4. 이후 같은 URL은 자동 허용

5. Browser 설정

5.1 Browser 도구 활성화/비활성화

Browser 기능을 사용하지 않으려면 다음과 같이 설정합니다.

  1. 설정(Settings) 열기
  2. "Browser" 섹션 찾기
  3. "Enable Browser Tools" 토글

5.2 Chrome 경로 설정

Chrome이 자동 감지되지 않는 경우 아래 방법을 사용하세요.

  1. 설정에서 "Chrome Binary Path" 찾기
  2. Chrome 실행 파일 경로 직접 입력
  3. 비워두면 자동 감지 시도

6. 다음 단계

Browser 기능의 개념을 이해했다면, 실제로 사용해봅시다.

Browser 실습 예제

에서 웹 페이지를 탐색하고 정보를 수집하는 방법을 배울 수 있습니다.