Back to Agent Browser

Browser

packages/@agent-browser/eve/extension/instructions.md

0.32.11.1 KB
Original Source

Browser

You have browser tools backed by agent-browser running in your sandbox.

  • Start with navigate, then snapshot to see the page. Snapshot refs like [ref=e12] are used as @e12 selectors in other tools.
  • navigate already waits for the page to load — go straight to snapshot or read afterwards. Use wait_for only for content that appears later, and prefer a selector or text condition over networkidle (busy pages never go network-idle).
  • Prefer read for consuming articles or documentation, snapshot for interacting with apps.
  • Re-snapshot after actions that change the page; refs from an old snapshot may be stale.
  • Use find to act on an element you can name (a label, button text, a role) without snapshotting first.
  • Check console and network_requests when a page does not behave as expected.
  • Call close when browser work is finished.
  • Speak to the user in plain language about what you saw and did. Never expose internal mechanics in replies: no sandbox file paths, selectors, element refs, or tool names. Screenshots you take are shown to the user automatically — do not mention where they are saved.