- Overview
- Quickstart
- Trust and compliance
- Governance
- Features
- Cartographer
- Delegate for Testing
- Reference
- Troubleshooting
Run a manual test case end-to-end with Delegate, from discovery and desktop or browser execution to publishing results in Test Manager and an emailed report.
Delegate acts as an AI-powered testing companion that interprets natural language instructions from a tester and translates them into actionable test steps. Instead of manually reading test case descriptions and switching between applications, the tester simply describes what they want to accomplish, and Delegate orchestrates the entire workflow.
During manual test execution, Delegate leverages UiPath's UI automation engine to interact with applications on the desktop and in the browser on behalf of the tester: opening applications or browsers, navigating to URLs or screens, clicking buttons, filling forms, and verifying on-screen content. The full range of actions includes:
- Navigation — open a URL or launch an application, go back/forward in the browser, switch between tabs, windows, or open applications.
- Interaction — click buttons, links, checkboxes, radio buttons; fill in text fields; select from dropdowns; upload files; drag and drop.
- Verification — check that text, elements, or values are visible on screen; confirm page or window titles, URLs, or headings match expected values; read values from the UI to verify against expected results.
- Utility — scroll; take screenshots (captured automatically per step); wait for elements, pages, or application screens to load; copy text from the clipboard.
What it cannot do: handle OS-level security dialogs (for example, HTTP Basic Auth popups), or automate mobile browsers. The practical scope: if a human tester can do it on the desktop or in Chrome, Delegate can do it too.
Upon completion, Delegate can generate and send a summary email via Microsoft Outlook, including the test case name, execution status, step-level results, and screenshots.
Prerequisites
- Complete the one-time setup in Setting up and running your first test case first (select the QA/Testing persona, install the UiPath Command Line Interface (CLI), run
uip login, know your project key). - Configure Microsoft Outlook for email delivery.
- Make sure the target application is accessible from your machine.
How to
Step 1 — Describe your intent
Enter a natural language request describing the test you want to execute, for example: "Run test case Login – valid credentials from project MYAPP."
Step 2 — Discover
Delegate confirms the project, finds the test case by name or ObjKey, and lists its steps. If anything is ambiguous, such as two matching test cases or no steps defined, it stops and asks you to clarify before proceeding — nothing is executed or published until it has a clean, unambiguous set of steps.
Step 3 — Execute
Delegate opens Chrome and works through each step in order, setting a trace checkpoint before each one, performing the UI automation, and recording pass/fail plus observations. If it gets stuck (element not found, unexpected popup), it pauses and asks how to proceed:
| You say | What happens |
|---|---|
| "It is the blue button labelled Sign In" | Delegate retries with your guidance |
| "Scroll down, it is below the fold" | Delegate scrolls and retries |
| "Skip this step and mark it failed" | Delegate records the step as Failed and moves on |
| "Stop the execution" | Delegate aborts, then publishes whatever steps completed so far — nothing is lost |
If you abort mid-execution, completed steps still publish with their correct pass/fail status; unexecuted steps default to None in Test Manager.
Step 4 — Publish and report
Delegate automatically creates a manual execution (named Delegate-<test case name>), starts a test case log, uploads each step's result, finalizes the trace, publishes the overall result and attachments, and adds the AutonomousExecution label so anyone in Test Manager can filter AI-run tests. It then shows a step-by-step results table plus a link to the execution in Test Manager, and asks whether you would like the report emailed.
| Automatic | You decide |
|---|---|
| Finding the test case in Test Manager | Which test case to run |
| Performing each UI step | What to do if a step is stuck |
| Recording traces per step | Whether to email the report |
| Publishing to Test Manager | Who gets the email |
| Labelling as AutonomousExecution | — |
The key difference from a recording or script: Delegate reasons through each step. If the UI has changed slightly, it adapts rather than failing rigidly on a moved pixel — more like a junior tester who understands the intent of the step.
Expected Outcomes
- Test case status in Test Manager is updated to Passed/Failed with full step-level detail.
- An email summary is received within minutes of execution completion.
- Screenshots are attached to the Test Manager execution log for audit purposes.
- Tester effort is reduced from 10–15 minutes of manual navigation to a single natural language prompt.
Postrequisites
Ask Delegate to turn the sequence of steps into a routine. Save the routine and schedule it to run on specific dates or within an interval.