Skip to content

Browser context

Agentic WorkFlow runs in the browser, so many workflows interact with a real page instead of a static data file. That gives workflows useful context, but it also means timing, permissions, and page state matter.

Browser context can include:

  • The active tab URL.
  • The current DOM.
  • Selected text or selected HTML.
  • Page metadata, links, images, forms, and accessibility information.
  • User-visible state after clicks, form fills, navigation, and scrolling.
flowchart LR
  Page["Active browser tab"] --> Nodes["In Page Action nodes"]
  Nodes --> Data["Workflow data"]
  Data --> AI["AI or integration nodes"]
  Nodes --> Page

  style Page fill:#e8f5e9,stroke:#2e7d32
  style Nodes fill:#e1f5fe,stroke:#0277bd

Some nodes read the page. Others change it.

Action typeExamplesRisk
ReadGet All Text, Get All Links, Screenshot PageData may be missing if the page has not finished loading
DisplayDisplay Markdown, Show NotificationCan add UI elements to the page
ManipulateUI Automation, Form Fill, Delete UI ElementsCan change page state or trigger navigation

After any write action, assume the page may need time before the next read.

Modern pages often update after the initial load. Content can appear after a network request, scroll, animation, or user interaction.

sequenceDiagram
  participant Node as Workflow node
  participant Page as Page
  Node->>Page: Click "Load more"
  Page-->>Page: Starts async request
  Node->>Page: Get All Text
  Page-->>Node: Text before new content appears
  Node->>Page: Wait For Element
  Page-->>Node: New content exists
  Node->>Page: Get All Text again

Use Wait For Element when you know what should appear. Use Wait only when a fixed delay is good enough.

Browser automation depends on extension permissions and page restrictions. Some pages block scripts, isolate frames, or change markup often. Treat those as workflow constraints, not just errors.

  • Confirm the workflow is running on the intended tab.
  • Use selectors that target stable elements, not generated class names.
  • Add waits after clicks, submissions, and navigation.
  • Capture page text or HTML before passing it to AI.
  • Avoid destructive UI manipulation unless the workflow purpose requires it.