Merge pull request #10639 from mendix/kv-cc-resource-pack

Adjusting GenAI Resource Plan Size

Author: Karuna-Mendix

content/en/docs/control-center/genai-resources-self-service.md

@@ -11,9 +11,9 @@ The **GenAI Resources** section provides a detailed overview of all Mendix GenAI
 
 ## Prerequisites
 
-Self-service provisioning of GenAI resources using Mendix Cloud Tokens is available only if the users meets the following conditions:
+Self-service provisioning of GenAI resources using Mendix Cloud Tokens is available only if the users meet the following conditions:
 
-1. Sufficient token entitlements – The user should have an adequate number of available Mendix Cloud Token to allocate for GenAI resource provisioning.
+1. Sufficient token entitlements – The user should have an adequate number of available Mendix Cloud Tokens to allocate for GenAI resource provisioning.
 2. Valid subscription plan – The user's Mendix subscription must be based on the FY21 price list or newer. Older subscription plans are not eligible for provisioning.
 3. Single account ownership – The user should have a single account. Owning multiple accounts is not supported for self-service GenAI provisioning.
 4. Enterprise platform subscription – The user should have a single active enterprise platform subscription. If no active subscription is found, the system will display a warning message with this text: "We couldn't retrieve your correct platform account, which is required to access available tokens and create resources. Please contact Mendix Support for assistance."
@@ -50,13 +50,13 @@ When provisioning a new resource, enter the following information:
 * **User** – The name of the user for whom the provisioning was initially created.
 * **Email** – The user's email address.
 
-After filling in the required fields, you can review all entered details in the **Resource Specification**. To learn more, refer to [Mendix Cloud GenAI Resource Packs](/appstore/modules/genai/mx-cloud-genai/resource-packs/).
+After filling in the required fields, you can review all the entered details in the **Resource Specification**. To learn more, refer to [Mendix Cloud GenAI Resource Packs](/appstore/modules/genai/mx-cloud-genai/resource-packs/).
 
 Click **Provision Resource** to finalize the process. You are taken back to the **GenAI Resources** page, where the newly created resource is displayed in the list. Selecting the newly provisioned resource opens its details directly in the Mendix Cloud GenAI Portal in a new tab.
 
 ## Deprovisioning GenAI Resources
 
-If you want to deprovision the resource, click the three dots icon ({{% icon name="three-dots-menu-horizontal" %}}) next to the selected resource and select **Deprovision Resource**. 
+If you want to deprovision the resource, click the three-dot icon ({{% icon name="three-dots-menu-horizontal" %}}) next to the selected resource and select **Deprovision Resource**. 
 A confirmation pop-up appears, displaying a message and the details of the selected resource, as shown in the example below.
 
 {{< figure src="/attachments/control-center/genai-resources/deprovisioning.png" >}}
@@ -66,3 +66,29 @@ Click **Deprovision** to proceed. After confirmation, the resource status update
 {{% alert color="info" %}}
 Your subscription plan operates on a monthly bundle cycle. When you deprovision a resource, the actual deprovisioning will occur at the end of the current subscription month. Until that date, you can still use the resource, and the scheduled deprovisioning date will appear in the resource's **Status**. 
 {{% /alert %}}
+
+## Adjusting GenAI Resource Plan Size
+
+You can change the plan size of an already provisioned GenAI resource (text or embedding models) to better match your actual token demand. You can adjust the GenAI resource plan size through the self-service capability of the Control Center.
+
+To adjust a resource plan size, do the following:
+
+1. Log in to the Control Center as a Company Admin.
+2. On the **GenAI Resources** page, click the three-dot ({{% icon name="three-dots-menu-horizontal-filled" %}}) icon next to the selected resource and select **Adjust Plan Size**. 
+3. Choose the desired plan and review the **Resource Specification** on the **Adjust Plan Size GenAI Resource** page. Click **Adjust Plan** to submit the change. 
+
+{{< figure src="/attachments/control-center/genai-resources/adjust-plan-size.png" >}}
+
+### Upgrading GenAI Resource Plan Size
+
+To upgrade, select a larger plan that matches your expected demand. Upgrades take effect immediately. Your account must have sufficient unutilized cloud tokens to cover the additional tokens required by the new plan. For example, upgrading from a 30-token (Small) plan to a 60-token (Medium) plan requires at least 30 unutilized cloud tokens in your account. If your account lacks the required tokens, you will receive an error message and the upgrade will be prevented.
+
+### Downgrading GenAI Resource Plan Size 
+
+To downgrade, select a smaller plan. Downgrades are not immediate. The current plan remains active until the end of the current subscription month, and the downgrade takes effect at the start of the next subscription month. For example, if a Medium plan started on 12 February and you schedule a downgrade on 20 February to Small, the actual downgrade will occur on 12 March. The cloud tokens returned to your account as a result of the downgrade become available only after the scheduled downgrade takes effect. 
+
+#### Cancelling a Scheduled Downgrade
+
+You can cancel a scheduled downgrade at any time before it takes effect. When a downgrade is scheduled, the resource status changes to **PLAN DOWNGRADE SCHEDULED**. To cancel it, click the three-dot ({{% icon name="three-dots-menu-horizontal-filled" %}}) icon next to the selected resource and select **Cancel Plan Downgrade**. The action takes effect immediately and cancels the scheduled downgrade.
+
+{{< figure src="/attachments/control-center/genai-resources/cancel-plan-downgrade.png" >}}

content/en/docs/marketplace/genai/mendix-cloud-genai/navigate_mxgenai.md

@@ -52,6 +52,10 @@ While changing the model version, note the following:
 Ensure you are using Mendix Cloud GenAI Connector version 5.3.0 and above to support the latest Cohere Embed v4 model. To see the upgraded model version reflected in your GenAI Connector after upgrading, make sure you are using Mendix Cloud GenAI Connector version 5.4.0 and above.
 {{% /alert %}}
 
+#### Adjusting the Plan Size of GenAI Resources (Text and Embedding Models) 
+
+After a resource is provisioned, you can change its plan size, either upgrade or downgrade it to match your actual production token usage. Company admins can change the plan through the GenAI Resources self-service in the Control Center. For more information, see the [Adjusting GenAI Resource Plan Size](/control-center/genai-resources-self-service/#adjusting-genai-resource-plan-size) section of *GenAI Resources*.
+
 ### Team
 
 {{< figure src="/attachments/appstore/platform-supported-content/modules/genai/navigate_mxgenai/GenAIResource_Team.png" >}}