> For the complete documentation index, see [llms.txt](https://docs.uptiq.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.uptiq.ai/ai-workbench-qore/console/agent-builder/build/runtime-and-versioning.md).

# Runtime & Versioning

Select, validate, and upgrade the Agent Executor version that runs your agent.

**Runtime & Versioning** controls the Agent Executor version that runs your agent. Executor releases add capabilities, address issues, and can deprecate earlier behavior. Pinning a version keeps runtime behavior predictable while you validate upgrades.

Set the version on the **Agent Behaviour** page: open **Agent Config → Agent Behaviour** and use the **Runtime & Versioning** dropdown at the foot of **Advanced Controls**. The Agent Config sidebar has no separate Runtime & Versioning item.

### Executor Version <a href="#executor-version" id="executor-version"></a>

Use the **Runtime & Versioning** dropdown, called **Executor Version** in the My Agents menu, to select the runtime for this agent. On the **Agent Behaviour** page its hint reads *"Runtime version for this agent. Different versions may change behavior and available features."* Open the dropdown to see the list. The selected version is ticked, and versions that are no longer supported are greyed out and marked **Deprecated**.

![](https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-3b1060fa4e67d87ce0dffbaae53984a5e0cb7447%2Fqore_agent-builder_agent-behaviour-runtime-and-versioning_rounded_shadow.png?alt=media)

| Field            | Obligation | Default                                                    | Notes                                                                |
| ---------------- | ---------- | ---------------------------------------------------------- | -------------------------------------------------------------------- |
| Executor Version | Mandatory  | The latest version available to your tenant, such as `1.4` | Switching versions can change agent behavior and available features. |

The dropdown lists versions available to your tenant. New agents use the latest available version by default. Existing agents remain on their current version until you migrate them.

You can also change it from the agent list: in **My Agents**, select **•••** on the agent's row, then **Executor Version**. The current version is ticked, and **1.0** is marked **Deprecated**.

<figure><img src="https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-de412ee9f6524c9b4a4d38c8bf15a997a18adfd4%2Fqore_agent-builder_how-to-my-agents-menu_rounded_shadow.png?alt=media" alt="My Agents with the ••• menu open on an agent: Export Agent, Executor Version and Delete Agent, with the Executor Version submenu listing 1.4 (ticked), 1.3, 1.2, 1.1 and 1.0 Deprecated"><figcaption><p>Executor Version, from My Agents.</p></figcaption></figure>

{% hint style="info" %}
Agent Executor v1.4 is available. Migrate agents on earlier versions after validation.
{% endhint %}

### Migrate to v1.4 <a href="#migrate-to-v14" id="migrate-to-v14"></a>

Agent Executor v1.4 is the current documented upgrade target. Migrate when you need its runtime capabilities or support for the current release.

1. In **Executor Version**, select `1.4`.
2. Select **Save**.
3. Test representative conversations, skills, and integrations.

Check expected outputs and execution behavior before you rely on the upgraded agent in production.

{% hint style="warning" %}
An executor upgrade can change agent behavior. Validate the agent before migrating production workloads.
{% endhint %}

See [September 12 release notes](https://docs.uptiq.ai/ai-workbench-qore/release-notes/2026/september-12.md) for the v1.4 announcement.

### When the executor version matters <a href="#when-the-executor-version-matters" id="when-the-executor-version-matters"></a>

Most agent configuration works across versions. Some capabilities require a newer executor version. For example, PII tokenization can be unavailable when an agent uses an older unsupported version.

If a builder section is unavailable, check the executor version. Upgrade and validate the agent when the feature requires a newer runtime.

### Draft versions and executor versions <a href="#draft-versions-and-executor-versions" id="draft-versions-and-executor-versions"></a>

**Executor Version** selects the platform runtime. **Draft Version** saves a snapshot of the agent configuration.

| Version type         | Scope                    | Use it for                                        |
| -------------------- | ------------------------ | ------------------------------------------------- |
| **Executor Version** | One runtime per agent    | Control runtime behavior and feature availability |
| **Draft Version**    | Many snapshots per agent | Compare or restore agent configuration            |

The settings are independent. Saving a draft doesn't change the executor version. Changing the executor version doesn't save a draft.

### Which agent version runs <a href="#which-agent-version-runs" id="which-agent-version-runs"></a>

An agent has a **draft** (version 0), the numbered versions you save, and one **live** version: the version that was last published and approved. See [Publish an agent](https://docs.uptiq.ai/ai-workbench-qore/task-guides/create-an-agent.md#publish-an-agent).

When someone starts a conversation, the platform picks the version like this:

| Situation                                                      | Version that runs                                                                                         |
| -------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| The request names a version                                    | That version. Through the API this is the `version` field; `0` is the draft.                              |
| The request names no version                                   | The live version. If nothing has been published yet, the draft.                                           |
| The person was given one saved version of the agent (a Viewer) | That version. A request for the draft or for no version resolves to it, and any other version is refused. |
| The conversation already started                               | The version it started on. A follow-up message can't switch it.                                           |

Saving a newer version doesn't change what an existing integration runs if it names a version. To move it forward, change the number it sends.

A flow or another agent that you add as a skill has its own version choice. A flow runs **Current Published** or a pinned **Version N**, and an agent runs **Draft** or a saved version. See [Add a flow as a skill](https://docs.uptiq.ai/ai-workbench-qore/console/agent-builder/build/adding-a-skill-to-the-agent.md#add-a-flow-as-a-skill).

In the agent playground, the chat widget has a version picker, but only in developer mode, and developer mode is available only in local, development, and release-candidate environments, not in production. In a running conversation the picker is read-only: `Start a new chat to switch versions`.

### Why this matters <a href="#why-this-matters" id="why-this-matters"></a>

Version pinning makes agent behavior reproducible. Your agent remains on its tested runtime until you choose an upgrade. Use the latest supported version for new agents, then validate it before production use.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.uptiq.ai/ai-workbench-qore/console/agent-builder/build/runtime-and-versioning.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
