Agents Page Shows Upgrade Wall on Professional License (Agents Plugin v2.1.0–v2.2.0)

Applies to: Mattermost Server v11.7.x · Agents Plugin v2.1.0–v2.2.0 · Professional license

Problem

On a Professional license, Agents Plugin v2.1.0–v2.2.0 incorrectly replaces the Agents management page with a "Self-Service Agents" upgrade wall. This is a confirmed frontend regression — existing agents are intact in the database and the backend API is unaffected. The fix is in v2.4.0+, which requires Mattermost Server v11.9.0 or later.

Solution

Option 1 — Upgrade server to v11.9.0+ and install Agents Plugin v2.4.1 (Recommended)

1. Upgrade Mattermost Server to v11.9.0 or later: server upgrade guide.
2. In System Console > Plugins > Plugin Management, upload and enable Agents Plugin v2.4.1.
3. Navigate to /plug/mattermost-ai/agents and confirm the agent list is accessible.

Option 2 — Downgrade Agents Plugin to v2.0.5 (if running on ESR v11.7.x or if a server upgrade is not immediately possible)

1. In System Console > Plugins > Plugin Management, disable the current Agents plugin.
2. Upload and enable Agents Plugin v2.0.5.
3. Navigate to /plug/mattermost-ai/agents and confirm the agent list is visible.

⚠️ Downgrading removes features added in v2.1.x–v2.2.x. Validate in staging and take a database backup before downgrading in production.