All Parameters - Browser Use

Reference

Parameter	Type	Description	Default
`BROWSER_USE_API_KEY`	`str`	API key (or env var)	Required
`cloud_profile_id`	`str`	Browser profile UUID	`None`
`cloud_proxy_country_code`	`str`	Supported proxy country code	`None`
`cloud_timeout`	`int`	Requested session timeout in minutes (1–240; service default 60 when omitted)	`None`
`on_browser_created`	`Callable`	Live URL callback	`None`
`on_log`	`Callable`	Log event callback	`None`
`on_result`	`Callable`	Success callback	`None`
`on_error`	`Callable`	Error callback	`None`

Example

@sandbox(
    cloud_profile_id='550e8400-e29b-41d4-a716-446655440000',
    cloud_proxy_country_code='us',
    cloud_timeout=60,
    on_browser_created=lambda data: print(f'Live: {data.live_url}'),
)
async def task(browser: Browser):
    agent = Agent(task="your task", browser=browser, llm=ChatBrowserUse())
    await agent.run()

See the Browser Infrastructure reference for maintained browser settings and pricing for current commercial terms.