Browser Tool

Browser Tool는 AI 기반 브라우저 상호작용을 지원합니다. 자연어 명령으로 브라우저 세션을 실행하고, 요소를 선택하고, 텍스트를 입력하고, 페이지를 스크롤하고, 스크린샷을 캡처할 수 있습니다.

배우는 내용

세션 수명 주기: 실행 → 상호작용 → 닫기
브라우저 동작: 선택, 입력, 스크롤
사용 사례: UI 테스트, 스크린샷, 탐색

세션 수명 주기

모든 브라우저 자동화 워크플로는 엄격한 순서를 따릅니다.

실행 - 대상 URL에서 브라우저 세션을 시작합니다
상호작용 - 동작을 수행합니다(선택, 입력, 스크롤)
닫기 - 세션을 종료해 리소스를 해제합니다

브라우저 상태는 세션 내 동작 사이에 유지됩니다. 다른 Verdent 도구를 사용하기 전에 반드시 브라우저를 닫아야 합니다.

각 동작은 현재 브라우저 상태를 보여 주는 스크린샷을 반환합니다. 다음 단계로 진행하기 전에 동작 사이의 스크린샷을 확인해 성공 여부를 검증합니다.

브라우저 동작

새 브라우저 세션 시작

필수: 대상 URL
1920x1080 해상도로 브라우저를 엽니다
모든 워크플로에서 항상 첫 번째 동작입니다

Launch browser at https://example.com

특정 좌표 선택

필수: x,y 좌표
좌표는 뷰포트를 기준으로 합니다
안정성을 위해 대상 요소의 중앙을 지정합니다

Click coordinates 450,300

키보드로 텍스트 입력

필수: 입력할 텍스트
현재 포커스된 요소에 입력합니다
보통 입력 필드를 선택한 뒤 이어서 사용합니다

Type "user@example.com"

페이지 스크롤

scroll_down - 한 페이지 높이만큼 아래로 스크롤합니다
scroll_up - 한 페이지 높이만큼 위로 스크롤합니다
화면 밖 콘텐츠를 표시합니다

Scroll down to load more content

브라우저 세션 종료

모든 워크플로에서 항상 마지막 동작입니다
다른 도구를 사용하기 전에 필요합니다
브라우저 리소스를 해제합니다

Close browser

좌표는 1920x1080 뷰포트를 기준으로 합니다. 중앙은 대략 (960, 540)입니다. 스크린샷을 사용해 요소 위치를 추정합니다.

일반적인 사용 사례

폼 제출과 탐색 흐름 테스트

로그인 페이지에서 시작해 입력 필드를 선택하고, 인증 정보를 입력하고, 폼을 제출한 뒤 스크린샷으로 결과를 확인합니다.

Launch browser at https://app.example.com/login
Click coordinates 450,280
Type "testuser@example.com"
Click coordinates 450,340
Type "password123"
Click coordinates 500,420
Close browser

문서화를 위한 페이지 캡처

스크린샷은 각 동작 후 자동으로 캡처됩니다. 대상 페이지와 섹션으로 이동해 시각적 문서를 만듭니다.

Launch browser at https://docs.example.com
Scroll down to API section
Close browser

대상 콘텐츠로 이동

추출 전에 브라우저 자동화를 사용해 상호작용이 필요한 콘텐츠로 이동합니다(메뉴 선택, 지연 로드 콘텐츠 불러오기 등).

Launch browser at https://store.example.com
Scroll down three times
Click "Next Page" at 960,800
Close browser

제한 사항

도구 단독 사용 - 활성 세션 중에는 browser_action만 사용할 수 있습니다
좌표 기반 - CSS 선택자가 아니라 x,y 좌표가 필요합니다
고정 해상도 - 브라우저 뷰포트는 1920x1080으로 고정됩니다
Chrome 전용 - Puppeteer는 Chrome/Chromium 브라우저를 지원합니다
지속성 없음 - 세션은 Verdent 재시작 후 유지되지 않습니다
WSL 지원 없음 - Browser Tool는 WSL 환경에서 작동하지 않습니다
저장된 상태 없음 - 각 세션은 쿠키나 인증 없이 새로 시작합니다
단일 세션 - 한 번에 하나의 브라우저 세션만 활성화할 수 있습니다

파일 작업, 검색 도구, bash 명령을 사용하기 전에 항상 브라우저 세션을 닫습니다. 활성 세션 중에는 브라우저가 다른 도구를 잠급니다.

함께 보기

Code Diff

코드 변경 사항을 검토하고 승인합니다

View as Markdown