> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cassidyai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Browser use

> Enable Agents to browse websites and interact with web pages to complete tasks.

The Browser Use capability lets your [Agent](/agents/overview) automate interactive web tasks in a live browser — navigating pages, clicking buttons, filling out forms, and extracting data. Use it for tasks that require interacting with websites that don't have APIs, like government portals, vendor platforms, or dynamic search interfaces.

Browser Use works within Agents and can also be called by [Workflows](/workflows/overview) for more complex multi-step automations.

<iframe className="w-full aspect-video rounded-xl" src="https://www.loom.com/embed/a72bc8df8095434aa162de88efb279ce" title="Browser Use demo showing an Agent navigating SAM.gov to find cybersecurity contract opportunities" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

## Enable Browser Use

<Steps>
  <Step title="Select your Agent">
    Go to **Agents**, find the Agent you want to configure, click the **⋯** menu, and select **Edit**.

    <Frame>
      <img src="https://mintcdn.com/cassidy/B5ZY6MBk69zUNvGV/images/agents/browser-use-setup.png?fit=max&auto=format&n=B5ZY6MBk69zUNvGV&q=85&s=1d9cb0773018d1507c6b0549e08e83ad" alt="Agent card context menu showing Edit option" width="602" height="500" data-path="images/agents/browser-use-setup.png" />
    </Frame>
  </Step>

  <Step title="Add the capability">
    In the **Setup** tab, scroll to **Capabilities**, click **+ Add**, and select **Browser Use**.

    <Frame>
      <img src="https://mintcdn.com/cassidy/B5ZY6MBk69zUNvGV/images/agents/browser-use-live.png?fit=max&auto=format&n=B5ZY6MBk69zUNvGV&q=85&s=0342f74a3fc9d2787de7f51538fe38fe" alt="Capabilities section showing Browser Use added to an Agent" width="2286" height="392" data-path="images/agents/browser-use-live.png" />
    </Frame>
  </Step>

  <Step title="Publish your Agent">
    Click **Publish** to make the capability available.
  </Step>
</Steps>

## How to use it

<Steps>
  <Step title="Start a chat">
    Open a chat and select an Agent that has Browser Use enabled.
  </Step>

  <Step title="Send your request">
    Type a message that requires interactive web browsing — for example, "Search SAM.gov for active contract opportunities related to cybersecurity."

    <Frame>
      <img src="https://mintcdn.com/cassidy/5YHx_-kdBDoXQv1s/images/agents/browser-use-request.png?fit=max&auto=format&n=5YHx_-kdBDoXQv1s&q=85&s=67777c03f4a61746f99288cbd4e243bb" alt="Chat message requesting the Agent to search SAM.gov for cybersecurity contract opportunities" width="1906" height="752" data-path="images/agents/browser-use-request.png" />
    </Frame>
  </Step>

  <Step title="Watch the Agent work">
    The Agent opens a live browser session and shows real-time status updates as it navigates, clicks, and extracts data. Click the status dropdown to expand the list of steps, then click the latest step to open a side-by-side browser preview.

    <Frame>
      <img src="https://mintcdn.com/cassidy/5YHx_-kdBDoXQv1s/images/agents/browser-use-steps.png?fit=max&auto=format&n=5YHx_-kdBDoXQv1s&q=85&s=1d985d0b0218d31b7dd7aa4d92a625bf" alt="Real-time status updates showing each browser action like navigating and clicking" width="2864" height="1366" data-path="images/agents/browser-use-steps.png" />
    </Frame>

    If you need to manually guide the session — for example, to solve a CAPTCHA — click **Click to take control** to interact with the browser directly.

    <Frame>
      <img src="https://mintcdn.com/cassidy/5YHx_-kdBDoXQv1s/images/agents/browser-use-take-control.png?fit=max&auto=format&n=5YHx_-kdBDoXQv1s&q=85&s=f6b733d70a7bbb90ccb70aa1909b39f8" alt="Side-by-side browser preview with Click to take control option" width="1246" height="1362" data-path="images/agents/browser-use-take-control.png" />
    </Frame>
  </Step>

  <Step title="Review browser steps">
    When the Agent finishes, click the **Finished analyzing** dropdown to see the full sequence of actions it performed.

    <Frame>
      <img src="https://mintcdn.com/cassidy/5YHx_-kdBDoXQv1s/images/agents/browser-use-screenshots.png?fit=max&auto=format&n=5YHx_-kdBDoXQv1s&q=85&s=87891402fbeb07dac71935f706335d24" alt="Finished analyzing dropdown showing the full list of browser actions taken" width="1500" height="908" data-path="images/agents/browser-use-screenshots.png" />
    </Frame>
  </Step>

  <Step title="Browse screenshots">
    Click any individual step to see a screenshot of what the browser looked like at that point. Use the **Previous** and **Next** buttons to navigate between steps, with a step counter (e.g. "1 / 14") showing your position.

    <Frame>
      <img src="https://mintcdn.com/cassidy/5YHx_-kdBDoXQv1s/images/agents/browser-use-finished.png?fit=max&auto=format&n=5YHx_-kdBDoXQv1s&q=85&s=b870f47fdfe7f584d132bd16aff27471" alt="Screenshot browser showing a SAM.gov page with Previous and Next navigation and step counter" width="1252" height="1374" data-path="images/agents/browser-use-finished.png" />
    </Frame>
  </Step>
</Steps>

## Use cases

* **Government portals** — Search SAM.gov, SEC filings, or other public databases.
* **Vendor and supplier platforms** — Look up pricing, availability, or order status on supplier websites.
* **Dynamic search interfaces** — Navigate search UIs that require filling in forms and clicking through results.
* **Form submission** — Fill out and submit web forms on behalf of your team.
* **Competitive intelligence** — Browse competitor websites to gather pricing, feature, or positioning data.

## Browser Use vs. Web Search

| Feature          | [Web Search](/agents/capabilities/web-search)      | Browser Use                                               |
| ---------------- | -------------------------------------------------- | --------------------------------------------------------- |
| **Best for**     | Quick lookups and reading publicly available pages | Interactive tasks requiring clicks, forms, and navigation |
| **How it works** | Searches and reads web pages                       | Opens a live browser and interacts with pages             |
| **Speed**        | Fast                                               | Slower (requires browser rendering and interaction)       |
| **When to use**  | Simple page reading and information lookup         | Dynamic websites that require interaction to access data  |

<Tip>Use [Web Search](/agents/capabilities/web-search) for simple page reading and Browser Use for interactive tasks. If you just need to read content from a URL, Web Search is faster.</Tip>

## Next steps

<CardGroup cols={2}>
  <Card title="Web Search" icon="globe" href="/agents/capabilities/web-search">
    Search the internet for real-time information without a full browser.
  </Card>

  <Card title="Deep Research" icon="magnifying-glass" href="/agents/deep-research">
    Run multi-step research combining web search and Knowledge Base.
  </Card>
</CardGroup>
