agent-browser

선택자

참조 (권장)

참조는 스냅샷에서 요소를 결정적으로 선택할 수 있게 해줍니다. 인공지능 에이전트에 최적입니다.

# 1. 참조와 함께 스냅샷 가져오기
agent-browser snapshot
# 출력:
# - 제목 "예제 도메인" [ref=e1] [level=1]
# - 버튼 "제출" [ref=e2]
# - 텍스트박스 "이메일" [ref=e3]
# - 링크 "자세히 알아보기" [ref=e4]

# 2. 참조를 사용하여 상호작용하기
agent-browser click @e2                   # 버튼 클릭
agent-browser fill @e3 "[email protected]" # 텍스트박스 채우기
agent-browser get text @e1                # 제목 텍스트 가져오기
agent-browser hover @e4                   # 링크 호버

왜 참조인가요?

  • 결정적 - 스냅샷에서 정확한 요소를 가리킴
  • 빠름 - DOM 재검색이 필요 없음
  • 인공지능 친화적 - 언어 모델이 참조를 신뢰할 수 있게 파싱하고 사용 가능

CSS 선택자

agent-browser click "#id"
agent-browser click ".class"
agent-browser click "div > button"
agent-browser click "[data-testid='submit']"

텍스트 및 XPath

agent-browser click "text=제출"
agent-browser click "xpath=//button[@type='submit']"

의미론적 위치 지정자

역할, 레이블 또는 기타 의미론적 속성으로 요소를 찾습니다:

agent-browser find role button click --name "제출"
agent-browser find label "이메일" fill "[email protected]"
agent-browser find placeholder "검색..." fill "쿼리"
agent-browser find testid "제출-btn" click