Management of the personal agent

A personal agent is a local agent that provides a dedicated, isolated runtime environment to run and diagnose Web UI tests and suites directly on your local machine.

A personal agent is a localized DevOps test runtime instance that is linked to your user account. The personal agent is designed for your individual use and remains invisible and inaccessible to other users. For clear identification, each agent is named using a unique personal:username format based on your profile credentials. There can be only one active personal agent per user across all machines. When the agent is ready, you can select the Run on personal agent option from the test editor to run the tests locally through that agent instead of a remote container. You can also choose the personal agent as a targeted location to run tests through the Execute test asset dialog on the Execution page.

The personal agent simplifies and improves the local debugging experience for Web UI tests and suites. As the agent allows you to bypass remote test containers and route tests directly to your local machine, you can visually observe browser behavior in real time and identify the exact point of test failure. This visibility helps you quickly resolve playback errors.

You can use the Personal Agent button located on the test editor page to download, start, or stop the agent. Once you stop the agent, the agent's state changes to inactive in the editor. When the agent is in the inactive state, the Run on personal agent option is automatically disabled in the editor interface, and it cannot be used for test runs. As the agent automatically associates with every project you belong to, you can switch between different project workspaces without the need to manually re-associate the agent. You can view the agent listed on the Agents & Intercepts page both inside a project and in the initial team space. To ensure privacy and prevent shared access, a different user in the same project can neither view the agent on the Agents & Intercepts page nor select it as a target location to run tests.