Release Guide for Agents Kit 2

Last modified: June 30, 2026

Introduction

This document covers the transition to Studio Pro agents, Studio Pro 11.12 requirements, and other key changes in the Agents Kit 2 release.

General Recommendations

Mendix recommends following these steps to ensure a smooth upgrade:

Upgrade your app to Studio Pro 11.12 or higher before migrating to Agents Kit 2.
Back up your database before starting.
Perform the upgrade in a non-production environment first.
For each module used in your app, upgrade to the release version specified in Agents Kit Components.

Do not skip major module versions while upgrading; they may contain deprecations or require migration. For example, if you are using V3.x.x and want to upgrade to V5.0.0, first upgrade to V4.0.0, deploy the app, and perform all required migration steps before proceeding to the next version. Skipping a major version may result in data loss, broken logic, or failed deployments.

If you need to upgrade through multiple major module versions, follow the steps in Agents Kit 1 Release and Migration Guide before continuing.
If migrating runtime agents to Studio Pro agents, plan time to recreate agent definitions and update your microflow logic, as described in Migrating from Runtime Agents to Studio Pro Agents.
Perform the migration in production only after successful testing.

Releases

Agents Kit 2.0

This section describes the major changes and migration steps for Agents Kit 2, released in June 2026 with Studio Pro 11.12.

Studio Pro 11.12 Requirement

Agents Kit 2 requires Studio Pro 11.12 or higher.

Agent Editor and Studio Pro Agents

Studio Pro agents, built using Agent Editor, are now the preferred way to build agents with Mendix Cloud GenAI resources. Agent Editor lets you define and develop agents locally in Studio Pro, then deploy them directly to cloud environments using the app model.

Migrating from Runtime Agents to Studio Pro Agents

If your app uses runtime agents (built with the Agent Commons module) and Mendix Cloud GenAI resources, you can migrate them to Studio Pro agents by following these steps:

Ensure your app uses Studio Pro 11.12 or higher.
Open Agent Editor in Studio Pro.
Create a new Studio Pro agent for each runtime agent you want to migrate.
Copy the agent definition from your runtime agent into the new Studio Pro agent.
Add any tools your runtime agent used to the new Studio Pro agent: In the Tools section of the Agent document, select any microflows used as tools. If your agent used knowledge bases or consumed MCP services, create a dedicated document for each and then select it as a tool.
In your microflows and other logic, replace any runtime toolbox actions with the corresponding Agent Editor toolbox actions.

Atlas UI 4 Compatibility

Agents Kit 2 modules are compatible with Atlas UI 4, Mendix's updated UI framework.

General Notes

Feature parity between Agent Builder in Runtime and Agent Editor in Studio Pro is still in progress, particularly for external provider support and human-in-the-loop capabilities.
The RFP Assistant Starter App now supports Studio Pro agents and requires Mendix Cloud GenAI.
The latest version of the AI Bot Starter App remains available in Studio Pro 10.24 and has not been upgraded for Agents Kit 2, as its use case does not rely on agents.