agents
latest
false
- Getting started
- Installation
- Installing UI Agent
- Best practices
PREVIEW
UI Agent user guide
Last updated Jul 16, 2025
Installing UI Agent
Note:
The UI Agent installation procedure is available in public preview to Enterprise customers, and only supports a bring-your-own-model deployment due to the substantial costs of running this installation at scale.
Private preview customers can perform the Studio – UI Agent setup directly.
To perform this installation, you need to have your own subscription for one of the following services:
- Open AI - Operator
- Anthropic - Computer Use
- GPT 4.1
- Gemini Flash 2.0
Note: The GA version of UI Agent will not require a separate subscription, all models will be available by default, covered by some form of payment, either
AI, Agentic, or Platform Units.
To configure your own subscriptions, take the following steps:
- In Automation Cloud™, navigate to Admin.
- Select AI Trust Layer, then select the LLM configurations tab.
- Select a tenant from the Tenant drop-down, and then select Add configuration.
- In the Add configuration panel, take the following steps:
- Select UI Agent from the Product drop-down.
- Select Replace UiPath LLM subscription from the Configuration mode drop-down.
- Select the subscription you have and want to use from the LLM drop-down.
- In the Configure customer managed connection section, select a folder from the Folder drop-down, and then select a connector from the Connector drop-down.
- Select Add new connection. A new tab opens, prompting you to provide information to connect UiPath to your selected connector. Populate the necessary fields, then select Test in the Add configuration panel.
- Select Save.
To configure UI Agent via Studio, take the following steps:
- Ensure that, in UiPath Studio, you are logged in with your Automation Cloud™ production account.
- Add this feed by navigating to Manage packages > Settings > User defined package sources.
- Download and install the latest UIAutomation package from 2025.10.5, or higher.
- Search and add the UI Agent activity in the Studio canvas.
- The UI Agent activity has a field for adding your prompt, as well as a drop-down, in case you want to change the default LAM, a string output, and several self-explanatory properties you can discover independently.
For a safe use of UI Agent, you must take the following important precautions:
- Current state-of-the-art LAMs are quite limited, therefore it is better to use multiple granular UI Agent activities, each handling one or two actions with a few target UI elements, rather than a single end-to-end automation instance attempting a complex task.
- Data collection — for the duration of the private preview, we may collect data such as prompts, screenshots, the automated
applications, etc.
Important: Try UI Agent on non-sensitive information.
- UI Agent is a beta product, with a fair amount of agency and unpredictability.
Important: Use UI Agent on test environments only, with mock data. In case this scenario is not possible for you, ensure that the agent cannot do any real permanent damage in the sandboxed application where it runs.
