Skip to main content

Overview

The Browser Use Sandbox tool runs the open-source browser-use framework inside a secure E2B sandbox. Describe what you want the agent to do in plain language, and it will navigate the web, fill forms, extract data, and more — all powered by OpenAI models. For Human-in-the-Loop workflows, set keep_session: true to pause after the task and receive a sandbox_id. Pass that sandbox_id back to a subsequent BROWSER_USE_SANDBOX_RUN_TASK step to reconnect to the same browser session and continue.

Configuration

FieldDescription
openai_api_keyYour OpenAI API key. Leave blank to use Jinba Credit.
timeoutExecution timeout in milliseconds (default: 600000 = 10 min)

Inputs

FieldTypeDescription
taskstringNatural-language description of what to do in the browser
sandbox_idstringE2B sandbox ID from a previous run with keep_session: true. When provided, reconnects to that session and continues. Use {{steps.<step_id>.result.sandbox_id}}. Leave empty to start a new session.
llm_modelenumOpenAI model to use (gpt-4.1 / gpt-4.1-mini / gpt-5.1)
max_stepsnumberMaximum agent steps (default: 20)
capture_screenshotbooleanReturn a signed URL to the final browser screenshot
keep_sessionbooleanKeep the browser session alive after the task completes. Only used when starting a new session (no sandbox_id). Returns sandbox_id and current_url for use in a subsequent step.

Example — Simple task

- id: browse
  tool: BROWSER_USE_SANDBOX_RUN_TASK
  input:
    - name: task
      value: "Go to https://example.com and return the page title and main heading text."
    - name: llm_model
      value: gpt-4.1-mini
    - name: max_steps
      value: 10

Example — Human-in-the-Loop form submission

- id: fill_form
  tool: BROWSER_USE_SANDBOX_RUN_TASK
  input:
    - name: task
      value: "Go to https://example.com/contact, fill in the name and email fields, then stop before clicking submit."
    - name: llm_model
      value: gpt-4.1
    - name: keep_session
      value: "true"

- id: wait_for_approval
  tool: WAIT_FOR_APPROVAL
  input:
    - name: message
      value: "Please review the filled form and approve to submit."

- id: submit_form
  tool: BROWSER_USE_SANDBOX_RUN_TASK
  input:
    - name: sandbox_id
      value: "{{steps.fill_form.result.sandbox_id}}"
    - name: task
      value: "Click the submit button. Reviewer comment: {{steps.wait_for_approval.result.comment}}"
    - name: llm_model
      value: gpt-4.1
    - name: capture_screenshot
      value: "true"