UiPath Documentation
test-cloud
latest
false
Test Cloud admin guide

Configuring LLMs

LLM configuration options in the AI Trust Layer for connecting custom or subscription-based large language models to Test Cloud services.

The LLM configurations tab lets you integrate your existing AI subscriptions while maintaining the governance framework provided by UiPath. You can:

  • Replace UiPath LLM subscription: Replace UiPath-managed subscriptions with your own, provided they match the same model family and version already supported by the UiPath product. This allows for seamless swapping of UiPath-managed models with your subscribed models.
  • Add your own LLM: Use any LLM that meets the product's compatibility criteria. To ensure smooth integration, your chosen LLM must pass a series of tests initiated through a probe call before it can be used within the UiPath ecosystem.
Note:

Access to UiPath-managed models and/or LLM configurations depends on the cloud platform you use. For details, refer to Test Cloud feature availability.

Configuring LLMs preserves most of the governance benefits of the AI Trust Layer, including policy enforcement via Automation Ops and detailed audit logs. However, model governance policies are specifically designed for UiPath-managed LLMs.

This means that if you disable a particular model through an AI Trust Layer policy, the restriction only applies to the UiPath-managed version of that model. Your own configured models of the same type remain unaffected.

When leveraging the option to use your own LLM or subscription, keep the following points in mind:

  • Compatibility requirements: Your chosen LLM or subscription must align with the model family and version supported by the UiPath product.
  • Setup: Make sure you properly configure and maintain all required LLMs in the custom setup. If any component is missing, outdated, or incorrectly configured, your custom setup may cease to function. In such cases, the system will automatically revert to a UiPath-managed LLM to ensure continuity of service, unless UiPath LLMs are turned off through an Automation Ops policy.
  • Cost-saving: If your custom LLM setup is complete, correct, and meets all necessary requirements, you may be eligible for a Reduced Consumption Rate.

Licensing

LLM configurations is available on the following licensing plans:

  • Unified Pricing: Enterprise Platform, Standard Platform, Basic Platform, App Test Platform Enterprise, App Test Platform Standard.
  • Flex: Advanced Platform, Flex Standard Platform.

How LLM requests are routed

Every LLM call from a UiPath product passes through the AI Trust Layer LLM gateway before it reaches the model, whether the model is UiPath-managed or your own. The diagrams below show the connectivity patterns available for your own models: a direct connection to a publicly reachable provider, and a Relay-mediated connection to a model hosted in a private network.

Direct connectivity through Integration Service

With direct connectivity, the product sends the request to the LLM gateway, which routes it through the Integration Service connection you created for your provider. The connection carries the request across the boundary into your provider's domain, and the response travels back along the same path.

The gateway stays in the path in both directions, so policy enforcement and audit logging apply to every call even though the model is yours.

Private network connectivity through Relay

If your model is hosted on-premises or in a private network with no public endpoint, Relay provides the connection to it. The LLM gateway and Integration Service behave the same as in direct connectivity. The UiPath relay infrastructure then forwards the request through the outbound tunnel that a Relay client inside your network keeps open, and the client calls your model locally.

For this connectivity pattern, the model endpoint must be registered under a Relay Group with Private selected as the connection type when creating the Integration Service connection. For details, refer to Using Relay.

Setting up an LLM configuration

LLM configuration rely on Integration Service to establish the connection to your own models. You can create connections to the following providers:

  • Azure Open AI
  • Open AI
  • Amazon Web Services – Use this connector to configure Anthropic Claude models.
  • Google Vertex
  • Open AI V1 Compliant LLM – Use this option to connect to any LLM provider whose API follows the OpenAI V1 standard. For details, refer to the OpenAI V1 Compliant LLM connector documentation.
    Note:

    To use Integration Service connections, you must add the Integration Service outbound IP ranges to your allowlist.

To set up a new connection, follow these steps:

1. Create the Integration Service connection

  1. In Integration Service, create a connection to your LLM provider.
  2. Choose the folder where the connection will be stored.
  3. Complete the authentication as required by the selected connector.
    Note:

    The folder you choose controls both security and visibility. To prevent unauthorized access, create the Integration Service connection in a private, non-shared folder. However, note that model visibility is determined by access to this folder. If an admin does not have access to it, the associated model configuration will not appear in the list.

2. Add a new LLM configuration

  1. Navigate to Admin > AI Trust Layer > LLM configurations.
  2. Select the Tenant.
  3. Select Add configuration.
  4. Choose the Product (for example, Agents) and Feature (for example, Design, Evaluate & Deploy).
  5. Select the Connections Folder.

3. Configure the model

In the Model Configuration section, fill in the following fields:

  • LLM Name – This field supports two configuration options, depending on your use case:
    • Select a model from the list – Choosing a model from the predefined list replaces the UiPath-managed LLM subscription with your own subscription for that same model. This scenario is referred to as Bring Your Own Subscription (BYOS).
    • Add custom alias – Entering a custom name lets you configure a model that is not included in the predefined list of recommended models for that product. This scenario is referred to as Bring Your Own Model (BYOM).
      Note:

      The Add a custom alias option is available only for products that support custom models. To learn which products support custom models, refer to the table below.

  • API Type – The API endpoint supported by the LLM (for example, Open AI Chat Completions). This must match the endpoint exposed by your provider.
  • Connector – The Integration Service connector (for example, Microsoft Azure OpenAI, Amazon Web Services).
  • Connection – The specific Integration Service connection created earlier. If no connection is available, create one in Integration Service.
  • LLM identifier – The model identifier exactly as it appears in your LLM subscription.
    • For Azure-hosted models: enter the model deployment name/identifier.
    • For AWS Bedrock cross-region inference: enter the inference profile ID. You must prepend the model ID with your region code, for example: eu.anthropic.claude-3-5-sonnet-20240620-v1:0.
    • For other providers: use the model name as defined in your subscription.
Note:

When configuring your own LLM, you can optionally restrict which large language models are available for use in your organization. If you want to ensure that only your custom models are used, you can disable UiPath-managed third-party models by applying an AI Trust Layer policy. Check the Models section in the AI Trust Layer policies documentation.

4. Validate and save

  1. Select Test configuration to verify that the endpoint is reachable.

    • The platform validates the connectivity.
    • Ensuring the correct model is configured remains your responsibility.
  2. If the validation is successful, select Save to activate the configuration.

Managing existing LLM connections

You can perform the following actions on your existing connections:

  • Check status – Verify the status of your Integration Service connection. This action ensures that the connection is active and functioning correctly.
  • Edit – Modify any parameters of your existing connection.
  • Disable – Temporarily suspend the connection. When disabled, the connection remains visible in your list but doesn't route any calls. You can re-enable the connection when needed.
  • Delete – Permanently remove the connection from your system. This action disables the connection and removes it from your list.

Configuring LLMs for your product

Each product supports specific large language models (LLMs) and versions. Use the table below to identify the supported models and versions for your product.

You can connect your own LLM using one of the following providers: Amazon Web Services, Google Vertex, Microsoft Azure OpenAI, or OpenAI V1 Compliant. Follow the steps outlined in the previous section to create a connection.

Note:

File support: Some product features rely on the configured LLM endpoint to process uploaded files. When using custom LLM configurations, support for file formats depends on the provider, model family, model version, and API Type. Verify that the selected model supports the required file formats before enabling file-based features. For product-specific requirements, refer to the relevant product documentation — for example, Analyze Files for Agents.

The number of models you must configure depends on the product and feature:

  • For features with a selectable model — where you choose which model to use — you can configure one or more models; unconfigured models continue to use UiPath-managed subscriptions.
  • For features with a fixed model set — where the feature uses a predetermined set of models — all models must be configured for the feature to work; partial configuration is not valid.
Product Supports custom models Feature LLM Version
Agents 1 Yes Design, Evaluate & Deploy OpenAI

Main models:

  • gpt-5.6-sol
  • gpt-5.6-terra
  • gpt-5.6-luna
  • gpt-5.5-2026-04-23
  • gpt-5.4-mini-2026-03-17
  • gpt-5.4
  • gpt-5.2-2025-12-11
  • gpt-5.1-2025-11-13
  • gpt-5-2025-08-07
  • gpt-5-mini-2025-08-07
  • gpt-4.1-2025-04-14
  • gpt-4.1-mini-2025-04-14
  • gpt-4o-2024-11-20
  • gpt-4o-2024-08-06
  • gpt-4o-mini-2024-07-18
  • gpt-4o-2024-05-13
Anthropic

Main models:

  • anthropic.claude-sonnet-5
  • anthropic.claude-opus-4-8
  • anthropic.claude-opus-4-7
  • anthropic.claude-sonnet-4-6
  • anthropic.claude-opus-4-6-v1
  • anthropic.claude-haiku-4-5-20251001-v1:0
  • anthropic.claude-sonnet-4-5-20250929-v1:0
  • anthropic.claude-sonnet-4-20250514-v1:0
Google

Main models:

  • gemini-3.6-flash
  • gemini-3.5-flash-lite
  • gemini-2.5-pro
  • gemini-2.5-flash
Autopilot Yes Chat Anthropic

Main models:

  • anthropic.claude-opus-4-8
  • anthropic.claude-opus-4-7
  • anthropic.claude-sonnet-4-6
  • anthropic.claude-opus-4-6-v1
  • anthropic.claude-haiku-4-5-20251001-v1:0
OpenAI

Main models:

  • gpt-5.5-2026-04-23
  • gpt-5.4-mini-2026-03-17
  • gpt-5.4-2026-03-05
  • fw-kimi-k2.7-code
  • fw-kimi-k2.6
Google

Main models:

  • gemini-3.1-pro-preview
  • gemini-3-flash-preview
  • gemini-2.5-pro
  • gemini-2.5-flash
Generation Google

Main models:

  • gemini-2.5-pro
  • gemini-2.5-flash
  • gemini-2.5-flash-lite
  • gemini-embedding-001
Autopilot for everyone Yes Chat Anthropic

Main models:

  • anthropic.claude-sonnet-4-5-20250929-v1:0
    Alternatives:
    • Google: gemini-2.5-flash
    • OpenAI: gpt-4o-2024-11-20
OpenAI

Main models:

  • gpt-4.1-mini-2025-04-14
    Alternatives:
    • Google: gemini-2.5-flash
    • OpenAI: gpt-4o-mini-2024-07-18
Coded agents Yes Call LLMs OpenAI

Main models:

  • gpt-5.6-sol
  • gpt-5.6-terra
  • gpt-5.6-luna
  • gpt-5.1-2025-11-13
  • gpt-5-2025-08-07
  • gpt-5-mini-2025-08-07
  • gpt-4.1-2025-04-14
  • gpt-4.1-mini-2025-04-14
Anthropic

Main models:

  • anthropic.claude-sonnet-5
  • anthropic.claude-sonnet-4-6
  • anthropic.claude-haiku-4-5-20251001-v1:0
  • anthropic.claude-sonnet-4-5-20250929-v1:0
  • anthropic.claude-sonnet-4-20250514-v1:0 — Upcoming removal: 2026-10-14
Google

Main models:

  • gemini-3.6-flash
  • gemini-3.5-flash-lite
  • gemini-2.5-pro
  • gemini-2.5-flash
Context Grounding Yes Advanced ingestion Google

Main models:

  • gemini-2.5-flash
Batch Transform Google

Main models:

  • gemini-2.5-flash
  • gemini-2.5-flash-lite
Batch Transform with Web Search Google

Main models:

  • gemini-2.5-flash
  • gemini-2.5-flash-lite
Deep RAG Google

Main models:

  • gemini-2.5-flash
Embeddings Google

Main models:

  • gemini-embedding-001
GenAI Activities Yes Build, Test & Deploy Anthropic

Main models:

  • anthropic.claude-sonnet-4-6
  • anthropic.claude-haiku-4-5-20251001-v1:0
  • anthropic.claude-sonnet-4-5-20250929-v1:0
  • anthropic.claude-sonnet-4-20250514-v1:0
OpenAI

Main models:

  • gpt-5.2-2025-12-11
  • gpt-5.1-2025-11-13
  • gpt-5-2025-08-07
  • gpt-5-mini-2025-08-07
  • gpt-5-nano-2025-08-07
  • gpt-4o-2024-11-20
  • gpt-4o-mini-2024-07-18
Google

Main models:

  • gemini-2.5-pro
  • gemini-2.5-flash
Healing Agent Yes Workflow recovery Google

Main models:

  • gemini-2.5-flash
OpenAI

Main models:

  • gpt-4o-2024-08-06
UI Automation No ScreenPlay Anthropic anthropic.claude-sonnet-4-5-20250929-v1:0
Google gemini-2.5-flash
OpenAI

gpt-4.1-mini-2025-04-14

gpt-4.1-2025-04-14

gpt-5-2025-08-07

gpt-5-mini-2025-08-07

computer-use-preview-2025-03-11

Semantic selectors Google gemini-2.5-flash
Semantic Activities Google

gemini-2.5-flash

gemini-3-flash-preview

OpenAI

gpt-4.1-2025-04-14

gpt-4.1-mini-2025-04-14

gpt-5-mini-2025-08-07

Test Manager Yes Autopilot Search Anthropic

Main models:

  • anthropic.claude-sonnet-4-5-20250929-v1:0
OpenAI

Main models:

  • gpt-5.1-2025-11-13
  • gpt-4o-2024-11-20
Google

Main models:

  • gemini-2.5-pro
  • gemini-2.5-flash
Find Obsolete Tests Anthropic

Main models:

  • anthropic.claude-sonnet-4-5-20250929-v1:0
OpenAI

Main models:

  • gpt-5.1-2025-11-13
  • gpt-4o-2024-11-20
Google

Main models:

  • gemini-2.5-pro
  • gemini-2.5-flash
Generate Test Cases Anthropic

Main models:

  • anthropic.claude-sonnet-4-5-20250929-v1:0
OpenAI

Main models:

  • gpt-5.1-2025-11-13
  • gpt-4o-2024-11-20
Google

Main models:

  • gemini-2.5-pro
  • gemini-2.5-flash
Import Test Cases Anthropic

Main models:

  • anthropic.claude-sonnet-4-5-20250929-v1:0
OpenAI

Main models:

  • gpt-5.1-2025-11-13
  • gpt-4o-2024-11-20
Google

Main models:

  • gemini-2.5-pro
  • gemini-2.5-flash
Generate Reports Anthropic

Main models:

  • anthropic.claude-sonnet-4-5-20250929-v1:0
OpenAI

Main models:

  • gpt-5.1-2025-11-13
  • gpt-4o-2024-11-20
Google

Main models:

  • gemini-2.5-pro
  • gemini-2.5-flash
Requirement Evaluation Anthropic

Main models:

  • anthropic.claude-sonnet-4-5-20250929-v1:0
OpenAI

Main models:

  • gpt-5.1-2025-11-13
  • gpt-4o-2024-11-20
Google

Main models:

  • gemini-2.5-pro
  • gemini-2.5-flash
IXP Yes Unstructured and complex documents OpenAI

Main models:

  • gpt-5.4-2026-03-05
  • gpt-5.1-2025-11-13
  • gpt-4o-2024-08-06
Google

Main models:

  • gemini-3.1-pro-preview
  • gemini-3.1-flash-lite-preview
  • gemini-2.5-pro
  • gemini-2.5-flash
ScreenPlay Yes Screen Play OpenAI

Main models:

  • gpt-5.5-2026-04-23
  • gpt-5.4-mini-2026-03-17
  • gpt-5.4-2026-03-05
  • gpt-5-2025-08-07
  • gpt-5-mini-2025-08-07
  • computer-use-preview-2025-03-11
  • gpt-4.1-2025-04-14
  • gpt-4.1-mini-2025-04-14
Anthropic

Main models:

  • anthropic.claude-sonnet-4-5-20250929-v1:0
Google

Main models:

  • gemini-2.5-flash
Semantic Activities Google

Main models:

  • gemini-3-flash-preview
  • gemini-2.5-flash
OpenAI

Main models:

  • gpt-5-mini-2025-08-07
  • gpt-4.1-2025-04-14
  • gpt-4.1-mini-2025-04-14
Semantic Selectors Google

Main models:

  • gemini-2.5-flash

1 Agents requirements:

  • Ensure your LLM supports:
    • Tool (function) calling – The model must be able to call tools or functions during execution.
    • Disabling parallel tool calls – If supported by your provider, the model should offer the option to disable parallel tool calls.
  • When using custom models, Agents default to a 4096 token limit regardless of the model’s true capacity, since UiPath cannot infer token limits for customer-defined deployments.

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated