> For the complete documentation index, see [llms.txt](https://docs.qyrus.com/device-farm/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qyrus.com/device-farm/ai-session/run-a-session-with-web.md).

# Run a Web Session

Web sessions let the AI agent interact with a live browser using instructions similar to those used for device sessions.

## Start a Web Session

1. Open **AI Session**.
2. Select the **Web** tab.
3. Enter the website address in **Start URL**.
4. Optionally provide a session name.
5. In **Goal**, describe what the agent should verify.
6. Select **Start AI Session**.

For example, use `https://qbank.qyrus.com` as the Start URL and ask the agent to verify that the site loads successfully.

<div align="center"><img src="https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-98b99f69594e36c62d8098ad883474d5309b635b%2Fweb-setup.png?alt=media" alt="Web session setup"></div>

## Give Instructions to the Agent

After the browser session launches, enter instructions in the chat field and select **Send message**. The instruction pattern is the same as for a device session: describe the journey the agent should perform and the results it should verify.

The Web workspace can show the agent’s actions and manual user actions, such as clicks and sign-in interactions, as recorded steps.

## Take Control of the Browser

The live browser is initially shown as **Browser locked**. To interact with it yourself, select **Take control**. After taking control, perform the required browser actions directly. User interactions are recorded as manual steps that can be reviewed with the rest of the session activity.

When manual interaction is complete, select **Lock** to lock the browser again and return control to the agent.

![Take control in a web session](https://2346916530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkSZu8cT8D2Zwayrr4I91%2Fuploads%2Fgit-blob-5924dd7f0fc136963c6703fa150ae2c6dd0cfc6b%2Ftake-control.png?alt=media)

> **Note:** Web sessions are experimental. Review recorded actions and results carefully, especially when switching between agent control and user control.
