You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/content/docs/browser-rendering/features/human-in-the-loop.mdx
+10-11Lines changed: 10 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,7 +14,7 @@ Some browser automation workflows require manual intervention. A login page may
14
14
Human in the Loop works with any [Browser Session](/browser-rendering/#integration-methods) and uses [Live View](/browser-rendering/features/live-view/) to give humans access:
15
15
16
16
1. Your automation script navigates to a page that needs human input.
17
-
2. The script retrieves the Live View URL via `Cloudflare.getLiveView`and shares it with a human operator (for example, by logging it, sending it via Slack, or displaying it in a UI).
17
+
2. The script retrieves the [Live View](/browser-rendering/features/live-view/) URL from the session's target list and shares it with a human operator (for example, by sending it via Slack, email, or displaying it in a UI).
18
18
3. The human operator opens the Live View URL and completes the required action (logging in, solving a CAPTCHA, entering sensitive data, etc.).
19
19
4. The automation script detects that the human is done (for example, by waiting for a navigation event or polling for a page element) and resumes.
-**Sensitive data entry**: Forms requiring credentials or personal information you do not want to pass to an automation script
78
73
-**Complex interactions**: One-off tasks that are too difficult or not worth fully automating, such as configuring a dashboard or approving a workflow
79
74
-**Verification steps**: Confirming an order, reviewing generated content, or approving an action before the script proceeds
75
+
76
+
:::note[Bot detection]
77
+
Browser Rendering requests are [always identified as bot traffic](/browser-rendering/faq/#will-browser-rendering-be-detected-by-bot-management). Even with a human controlling the session, some third-party services may still block the request.
Live View lets you see and interact with a remote Browser Run session in real time. This is useful for debugging automation scripts, monitoring what a browser is doing, or manually stepping in when a task requires human intervention (see [Human in the Loop](/browser-rendering/features/human-in-the-loop/)).
13
13
@@ -27,13 +27,12 @@ In the Cloudflare dashboard, go to the **Browser Run** page and select the **Liv
27
27
28
28
When you create a session or list targets through the [CDP](/browser-rendering/cdp/) endpoints, the API response includes a `devtoolsFrontendUrl` for each target (tab). Open this URL in any browser to load the DevTools UI hosted at `live.browser.run`, which streams the remote session to your browser.
29
29
30
-
The hosted UI supports three viewing modes, controlled by the `mode` parameter in the URL:
30
+
The hosted UI supports two viewing modes, controlled by the `mode` parameter in the URL:
Paste this URL into Chrome's address bar to open native DevTools connected to the remote browser session.
47
-
48
-
**Pros:**
49
-
- Familiar UI: the exact same DevTools you use daily for local development, rather than a hosted version wrapped inside a webpage
50
-
- Slightly faster to load: DevTools assets (HTML, JS, CSS) are already bundled locally in Chrome
51
-
52
-
**Cons:**
53
-
- Chrome only: the `devtools://` protocol URL only works in Chrome. The hosted `live.browser.run` version works in other browsers, though the DevTools UI has not been heavily tested outside Chrome.
54
-
- Inspector tab only: does not work for the full or tab viewing modes
45
+
Paste this URL into Chrome's address bar to open native DevTools connected to the remote browser session. This gives you the familiar local DevTools UI and loads slightly faster since the assets are already bundled in Chrome. However, the `devtools://` protocol only works in Chrome and only supports the inspector viewing mode.
55
46
56
47
:::caution[URL validity]
57
48
The `devtoolsFrontendUrl` is valid for five minutes from when it was generated. If you do not open the URL within this timeframe, list the targets again to get a fresh URL. Once the DevTools connection is established, it remains active as long as the browser session is alive.
@@ -132,29 +123,3 @@ If you have a running session and want to connect to it:
132
123
```
133
124
134
125
3. Copy the `devtoolsFrontendUrl` and open it in your browser.
135
-
136
-
## Get the Live View URL programmatically
137
-
138
-
You can retrieve the Live View URL from within a Puppeteer or Playwright script using a CDP command. This is useful when you need to share the URL with someone, for example sending it via email, Slack, or displaying it in a UI.
You can also get the Live View URL from the HTTP API by listing targets for a session, as shown in [View an existing session](#view-an-existing-session). Each target in the response includes a `devtoolsFrontendUrl`.
0 commit comments