mirror of
https://github.com/Skyvern-AI/skyvern.git
synced 2026-04-28 19:50:42 +00:00
100 lines
4.3 KiB
Text
100 lines
4.3 KiB
Text
---
|
|
title: Watching Live Execution
|
|
subtitle: Monitor, interact with, and control running tasks
|
|
description: Monitor running tasks in real time in the Skyvern Cloud UI, view the live browser stream and agent reasoning logs, and take manual control of the browser mid-task.
|
|
slug: cloud/monitor-a-run
|
|
keywords:
|
|
- live viewer
|
|
- real-time
|
|
- agent reasoning
|
|
- take control
|
|
- manual control
|
|
- step timeline
|
|
---
|
|
|
|
When you run a task from the [Discover page](/cloud/getting-started/run-a-task), you're taken to the live execution screen where you can watch the browser in real time.
|
|
|
|
<img src="/images/cloud/live-execution-overview.png" alt="Live execution screen" />
|
|
|
|
---
|
|
|
|
## The execution screen
|
|
|
|
The execution view has three panels:
|
|
|
|
| Panel | What it shows |
|
|
|-------|---------------|
|
|
| **Left: Task configuration** | The block being executed, its URL, and prompt. A status badge shows the current state. |
|
|
| **Center: Live browser** | Real-time view of the browser. You see pages load, forms fill, and buttons click. |
|
|
| **Right: Agent logs** | Real-time LLM reasoning and action decisions. Shows why the AI made each choice. |
|
|
|
|
---
|
|
|
|
## When the live view is available
|
|
|
|
The live browser stream is active while the task is still in progress:
|
|
|
|
| Status | Live view |
|
|
|--------|-----------|
|
|
| `created` | Waiting to start |
|
|
| `queued` | Waiting for a browser |
|
|
| `running` | **Active**: the browser is navigating |
|
|
| `completed` | Stream closed. View the recording instead. |
|
|
| `failed` | Stream closed. View the recording instead. |
|
|
| `terminated` | Stream closed. View the recording instead. |
|
|
| `timed_out` | Stream closed. View the recording instead. |
|
|
| `canceled` | Stream closed. View the recording instead. |
|
|
|
|
Once a task reaches a final state, the live stream closes. Open the run from **Runs** in the sidebar to access the full recording, screenshots, and action history.
|
|
|
|
---
|
|
|
|
## Taking control of the browser
|
|
|
|
While a task is running, you can take over the browser and interact with the page directly, just like you would in your own Chrome window.
|
|
|
|
### How it works
|
|
|
|
1. Click the **Take Control** button in the live browser panel.
|
|
2. The AI agent pauses and you get full mouse and keyboard control of the browser.
|
|
3. Interact with the page: type into fields, click buttons, solve CAPTCHAs, dismiss popups.
|
|
4. Click **Release Control** to hand the browser back to the AI. It picks up from the current page state and continues the task.
|
|
|
|
### When to use it
|
|
|
|
- **CAPTCHAs**: solve a CAPTCHA the AI can't get past, then release control
|
|
- **Unusual login flows**: complete a multi-factor or SSO login that the agent doesn't handle
|
|
- **Unexpected popups or modals**: dismiss cookie banners, age gates, or promotional overlays
|
|
- **Mid-task corrections**: navigate to the right page or fix a form field before letting the agent continue
|
|
|
|
<Warning>
|
|
Taking control pauses the AI agent. The task timer keeps running, so release control promptly to avoid timeouts.
|
|
</Warning>
|
|
|
|
<Tip>
|
|
You can take and release control multiple times during a single run. Each time, the agent resumes from whatever state you left the browser in.
|
|
</Tip>
|
|
|
|
---
|
|
|
|
## Stopping a running task
|
|
|
|
You can cancel a task at any time while it's running or queued. Click the **Cancel** button in the task header. A confirmation dialog appears before the task is stopped. The task transitions to `canceled` and any configured webhook fires with the canceled status.
|
|
|
|
<Note>
|
|
Credits for actions already taken are still consumed. Canceling stops future actions but does not refund past ones.
|
|
</Note>
|
|
|
|
---
|
|
|
|
## Reviewing results
|
|
|
|
Once a task finishes, open it from **Runs** to see the full results. The run detail page has five tabs:
|
|
|
|
- **Overview**: The AI's reasoning timeline alongside browser screenshots. Each Thought, Block, and Action card shows what the agent saw and why it acted.
|
|
- **Output**: The complete JSON output and any downloaded files.
|
|
- **Parameters**: The configuration you submitted: URL, prompt, engine, proxy location, webhook URL, data schema, and other settings.
|
|
- **Recording**: Full video replay of the browser session. Every task is recorded automatically.
|
|
- **Code**: Auto-generated Python code to reproduce this task via the API or SDK (when code generation is enabled).
|
|
|
|
For a full walkthrough of each tab, see [Run Details](/cloud/viewing-results/run-details).
|