Stagehand 빠른 시작 — act, extract, observe
Stagehand 빠른 시작
SDK 를 설치하고 브라우저에 연결한 뒤 스크립트를 쓰면 됩니다. 빈 디렉토리에서 동작하는 자동화까지 세 단계로 갑니다.
예시 흐름 (Python)
import asyncio, os
from pydantic import BaseModel
from stagehand import Stagehand, browserbase
class ValueProposition(BaseModel):
value_proposition: str
async def main() -> None:
browser = await browserbase.launch(api_key=os.environ["BROWSERBASE_API_KEY"])
try:
stagehand = await Stagehand.create(browser=browser)
page = (await browser.context.pages())[0]
await page.goto("https://stagehand.dev")
# extract: 정의한 스키마로 구조화 데이터 추출
extract_result = await stagehand.extract(
"Extract the value proposition from the page.", ValueProposition)
print("Extract result:
", extract_result.data)
# act: 자연어 동작 실행
await stagehand.act("Click the 'Evals' button.")
# observe: 페이지에서 가능한 동작 발견
observe_result = await stagehand.observe("What can I click on this page?")
print("Observe result:
", observe_result.data)
finally:
await browser.close()
asyncio.run(main())
실행
Browserbase API 키를 설정한 뒤 스크립트를 실행합니다. Model Gateway 가 모델을 자동 선택·인증하므로 별도 모델 제공자 키는 필요 없습니다.
export BROWSERBASE_API_KEY="bb_live_..."
# 스크립트 실행
다음 단계
act(자연어로 페이지 동작), extract(타입 있는 구조화 데이터), observe(요소·동작 발견) 세 프리미티브를 익히세요.