Agent Browser

• AI 에이전트가 여러 페이지에 걸쳐 탐색하고, 상태를 읽고, 상호작용해야 하는 다단계 브라우저 워크플로우를 자동화해야 합니다.
• 결정론적 요소 선택이 필요합니다 — ref 기반 타겟팅은 XPath 또는 픽셀 기반 클릭의 취약성을 제거합니다.
• DOM이 동적으로 변경되고 각 작업 후 스냅샷을 다시 찍어야 하는 **복잡한 단일 페이지 애플리케이션(SPA)**을 다루고 있습니다.
• 세션 격리가 필요합니다 — 간섭 없이 여러 브라우저 컨텍스트(예: 관리자 및 사용자)를 동시에 실행합니다.

• 시각적 분석을 위한 스크린샷이나 PDF가 필요한 경우 — 시각적 검사에 특화된 내장 브라우저 도구를 사용하세요.
• 브라우저 확장 프로그램 통합이 필요한 경우 — Agent Browser는 확장 프로그램 로드를 지원하지 않습니다.
• 작업이 순전히 시각적이며 페이지 요소와의 상호작용이 포함되지 않는 경우.

취약한 CSS 선택자나 좌표 대신, Agent Browser는 접근성 트리를 캡처하고 각 요소에 안정적인 @ref ID(예: @e2)를 할당합니다. AI 에이전트는 JSON 출력에서 이러한 참조를 파싱하고 이후의 모든 상호작용에 활용하여, 동적 페이지 업데이트가 발생하더라도 안정적인 요소 타겟팅을 보장합니다.

클릭, 채우기, 입력, 호버, 체크/체크 해제, 선택, 드래그, 스크롤, 누르기 등 모든 ref 기반 작업을 지원합니다. 또한 텍스트, HTML, 속성을 추출하고 가시성 또는 활성화 상태를 확인하는 get 및 is 명령도 제공합니다.

--session <name>을 사용하여 여러 개의 명명된 세션을 동시에 실행합니다. 각 세션은 자체 브라우저 컨텍스트를 유지하므로, 쿠키나 상태 혼용 없이 관리자 및 사용자 역할을 나란히 테스트하는 시나리오를 구현할 수 있습니다.

state save로 쿠키와 로컬 스토리지를 JSON 파일에 저장한 후, state load로 나중에 다시 불러와 로그인 과정을 완전히 건너뛸 수 있습니다 — 반복적인 자동화 실행에 이상적입니다.

원하지 않는 요청(예: 광고)을 차단하고, API 응답을 모킹하며, 네트워크 활동을 검사할 수 있습니다 — 모두 CLI에서 직접 수행 가능합니다. 외부 간섭 없이 테스트 및 스크래핑을 수행할 때 유용합니다.

요소, 텍스트 콘텐츠, URL 패턴, 네트워크 유휴 상태 또는 임의의 JavaScript 조건을 기다립니다. 에이전트가 다음 단계로 진행하기 전에 안정적인 스냅샷을 보장합니다.

AI 에이전트가 검색 엔진으로 이동하여 ref로 식별된 입력 필드에 쿼리를 입력하고, 결과를 기다린 후 결과 요소에서 텍스트와 링크를 추출합니다 — 스크린샷이나 수동 셀렉터 조정 없이 모든 작업이 이루어집니다.

두 개의 동시 세션 — 하나는 관리자로 인증되고 다른 하나는 일반 사용자로 인증됨 — 이 동일한 앱과 동시에 상호작용합니다. 각 세션은 자체적으로 저장된 인증 상태를 로드하여 병렬 워크플로우 유효성 검사를 가능하게 합니다.

에이전트가 한 번 로그인하고 세션 상태를 auth.json에 저장한 후, 이후 실행 시 해당 상태를 불러와 로그인 과정을 건너뜁니다 — 그런 다음 곧바로 양식 작성 및 제출 작업을 진행합니다.

복잡한 React 또는 Vue 앱의 경우, Agent Browser는 매번 네비게이션이나 상태 변경 후 스냅샷을 다시 캡처하여, 상호작용 전에 항상 최신 접근성 트리를 기반으로 작업하며 참조가 최신 상태임을 보장합니다.