BrowserGym – 웹 에이전트 연구를 위한 프레임워크

무엇인가요

BrowserGym은 Playwright를 통해 웹 브라우저를 Gymnasium 환경으로 변환하는 오픈소스 파이썬 라이브러리입니다. 연구자는 어떤 LLM 기반 또는 규칙 기반 에이전트든 연결하여 실제 웹 페이지나 합성 웹 작업과 상호작용시킬 수 있습니다. 이 라이브러리는 잘 알려진 웹 자동화 벤치마크(예: MiniWoB, WebArena, WorkArena 등)의 컬렉션을 포함하며, 단일 AbstractBrowserTask 클래스를 상속하여 새로운 작업을 쉽게 추가할 수 있습니다.

왜 중요한가요

웹 에이전트 연구 — LLM이 웹 탐색, 폼 채우기, 버튼 클릭, 다단계 워크플로우 완료 등을 학습시키는 작업 — 는 표준화되고 재현 가능한 실험 환경이 필요합니다. BrowserGym은 다음과 같은 기능을 제공합니다:

일관된 API (gym.make(...))로 동일한 에이전트 코드가 여러 벤치마크에서 작동합니다.
합성, 시각적, 실제 웹 작업을 모두 커버하는 플러그 앤 플레이 벤치마크.
대규모 평가 및 추적 수집을 위한 보조 플랫폼인 AgentLab과의 통합.
사용자 정의 작업을 위한 확장성으로, 새로운 웹 상호작용 도전 과제를 빠르게 프로토타이핑할 수 있습니다.

누구를 위한 것인가요

LLM 기반 웹 에이전트를 개발하거나 평가하는 연구자.
새로운 프롬프팅 또는 파인튜닝 전략을 벤치마크하기 위해 재현 가능한 환경이 필요한 ML 엔지니어.
사용자 정의 웹 자동화 작업을 개발하면서 Gym 스타일 루프와 내장 메트릭을 재사용하고 싶은 개발자.

시작하기 (빠른 시작)

# 전체 패키지 설치 (모든 벤치마크 포함)
pip install browsergym
# Playwright의 Chromium 엔진 설치
playwright install chromium

그런 다음 간단한 오픈엔드 작업을 시작합니다:

import gymnasium as gym
import browsergym.core  # 환경 등록

env = gym.make(
    "browsergym/openended",
    task_kwargs={"start_url": "https://www.google.com/"},
    wait_for_user_message=True,
)
obs, info = env.reset()
while True:
    action = ...          # 당신의 에이전트의 다음 행동
    obs, reward, done, _, info = env.step(action)
    if done:
        break
env.close()

... 부분을 LLM 호출(예: OpenAI의 gpt-4o-mini) 또는 어떤 사용자 정의 정책으로 대체하세요.

주요 기능 (README에서)

기능	세부 사항
내장된 벤치마크	MiniWoB, WebArena, WebArenaVerified, VisualWebArena, WorkArena, AssistantBench, WebLINX, OpenApps, TimeWarp, Knows
확장 가능한 작업 클래스	새로운 벤치마크를 만들기 위해 `AbstractBrowserTask`를 상속
모듈형 설치	`browsergym-core`, `browsergym-miniwob` 등 별도의 pip 패키지로 필요한 것만 설치 가능
Playwright 백엔드	신뢰성 있는 헤드리스 브라우징을 위해 Playwright를 통해 Chromium 사용
Gymnasium API	`gym.make`, `env.step`, `env.reset` — RL/에이전트 개발자에게 익숙한 인터페이스
AgentLab 통합	대규모 실험 관리 및 추적 분석을 위한 보조 리포지토리
데모 에이전트	OpenAI 모델과 호환되는 즉시 실행 스크립트 (`demo_agent/run_demo.py`)
오픈소스 및 MIT 라이선스	자유롭게 사용, 수정, 확장 가능

생태계 및 관련 프로젝트

AgentLab – BrowserGym 벤치마크에서 에이전트를 실행하고 결과를 분석하는 프레임워크.
WorkArena – 기업형 작업을 위한 ServiceNow 전용 벤치마크.
WebArena / VisualWebArena – 자체 호스팅 도메인에서 실행되는 현실적인 웹 작업 세트.
MiniWoB – 전통적인 합성 웹 작업 컬렉션.
DoomArena – BrowserGym 페이지에 공격을 주입할 수 있는 보안 테스트 아레나.

대안과 비교

상황	BrowserGym이 적합한 경우
웹 작업용 표준화된 RL 스타일 인터페이스가 필요할 때	✅
여러 공개 벤치마크에서 에이전트를 평가하고 싶지만, 래퍼를 다시 작성하고 싶지 않을 때	✅
단일 간단한 웹 스크래핑 스크립트만 필요할 때	❌ (Selenium이나 Playwright만으로도 충분함)
관찰에 시각 인식(스크린샷)이 필요할 때	✅ (VisualWebArena 및 스크린샷 옵션이 내장됨)

인용

BrowserGym을 논문에서 사용할 경우, 제공된 두 개의 BibTeX 항목(2025 Transactions on Machine Learning Research 및 2024 ICML)을 인용하세요. 관련 연구의 추적 데이터는 Hugging Face에 호스팅되어 있습니다.

BrowserGym은 소비자 제품이 아니라 연구용 프레임워크입니다. 책임감 있게 사용하세요.

ServiceNow/BrowserGym