Merge pull request mendix#10422 from mendix/kv-genai-self-service

GenAI Resources Self-service

Author: Karuna-Mendix

content/en/docs/control-center/company/_index.md

@@ -2,7 +2,7 @@
 title: "Company"
 url: /control-center/company/
 description: "Describes the Company category in the Mendix Control Center."
-weight: 40
+weight: 60
 no_list: false
 ---
 ## Introduction 

content/en/docs/control-center/content-curation/_index.md

@@ -2,7 +2,7 @@
 title: "Content Curation"
 url: /control-center/content-curation/
 description: "Describes the Content Curation category in the Mendix Control Center."
-weight: 60
+weight: 80
 no_list: false
 ---
 ## Introduction 

content/en/docs/control-center/entitlements/_index.md

@@ -2,7 +2,7 @@
 title: "Entitlements"
 url: /control-center/entitlements/
 description: "Describes the Entitlements category in the Mendix Control Center."
-weight: 10
+weight: 30
 no_list: false 
 ---
 

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

@@ -0,0 +1,68 @@
+---
+title: "GenAI Resources"
+url: /control-center/genai-resources-self-service
+description: "Describes how to provision and deprovision GenAI Resources using self-service."
+weight: 20
+---
+
+## Introduction
+
+The **GenAI Resources** section provides a detailed overview of all Mendix GenAI resources available within your company, allowing Mendix Admins to seamlessly provision and deprovision GenAI resources as needed. With this feature, Mendix Admins can efficiently manage all GenAI resources directly within the [Control Center](https://controlcenter.mendix.com/index.html) through a self-service capability, ensuring streamlined operations and improved governance. For more information, refer to [Accessing GenAI Resources](/appstore/modules/genai/mx-cloud-genai/resource-packs/#accessing-genai-resources).
+
+## Prerequisites
+
+Self-service provisioning of GenAI resources using Mendix Cloud Tokens is available only if the users meets 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.
+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."
+
+## Overview of Deployed Resources
+
+The overview page provides a centralized view of all deployed GenAI resources, including text generation resources, embeddings generation resources, and knowledge base resources. From this page, you can easily review the status, basic information, and usage details of each deployed resource. The following list shows detailed information about your GenAI resource.
+
+* **Status** – The current status of the resource.
+* **Name** – The name of the resource.
+* **Model** – The model that is used, for example, Anthropic Claude Sonnet 4.0.
+* **Plan** – The subscription plan used for resources, for example, small, medium, or large.
+* **Created For** – For whom it is created.
+
+{{< figure src="/attachments/control-center/genai-resources/overview-genai-resources.png" >}}
+
+## Provisioning GenAI Resources
+
+You can provision any GenAI resources directly within the Control Center using the self-service capability. 
+To do so, select the appropriate resource type and click **Provision Resource**. 
+
+{{% alert color="info" %}}
+Ensure that you are on the correct resource tab before provisioning. For example, to create a new text generation resource, first select the **Text Generation Resources** tab.
+{{% /alert %}}
+
+When provisioning a new resource, enter the following information:
+
+* **Display Name** – The name of the resource.
+* **Environment** – The environment for which the resource is created, such as Test, Acceptance, or Production.
+* **Mendix Cloud Region** – The cloud region where the resource will be hosted.
+* **Cross-region inference** – Specifies whether the selected model supports cross-region inference. For more information, refer to the [Settings](/appstore/modules/genai/mx-cloud-genai/Navigate-MxGenAI/#settings) section of *Navigate through the Mendix Cloud GenAI Portal*.
+* **Available Text Generation Models** – A list of the supported models you can choose from, for example, Anthropic Claude Sonnet V4.
+* **Size** – The subscription plan with the tokens used for resources. 
+* **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/).
+
+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**. 
+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" >}}
+
+Click **Deprovision** to proceed. After confirmation, the resource status updates on the **GenAI Resource** page to reflect that deprovisioning is scheduled. 
+
+{{% 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 %}}

content/en/docs/control-center/marketplace/_index.md

@@ -2,7 +2,7 @@
 title: "Marketplace"
 url: /control-center/marketplace/
 description: "Describes the Marketplace category in the Mendix Control Center."
-weight: 50
+weight: 70
 no_list: false
 ---
 ## Introduction 

content/en/docs/control-center/people/_index.md

@@ -2,7 +2,7 @@
 title: "People"
 url: /control-center/people/
 description: "Describes the People category in the Mendix Control Center."
-weight: 30
+weight: 50
 no_list: false
 ---
 

content/en/docs/control-center/resolve-shared-ownership-apps.md

@@ -2,7 +2,7 @@
 title: "Resolving Shared Ownership of Apps"
 url: /control-center/resolve-shared-ownership-of-apps
 description: "Describe how to address the issue that you own an app together with another company."
-weight: 90
+weight: 80
 no_list: true
 ---
 

content/en/docs/control-center/security/_index.md

@@ -2,7 +2,7 @@
 title: "Security"
 url: /control-center/security/
 description: "Describes the Security category in the Mendix Control Center."
-weight: 20
+weight: 30
 no_list: false
 ---
 

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

@@ -45,6 +45,28 @@ Customers looking to leverage other models in addition to the above can also tak
 | Anthropic Claude (any version) (Tokens out/month)   | 1.25 million   | 2.5 million       | 5 million         |
 | Cohere Embed V3 (Tokens in/month)                   | 5 million      | 10 million        | 20 million        |
 
+## Accessing GenAI Resources
+
+Developers can easily obtain access to GenAI resources through a self-service capability, enabling them to access and manage GenAI resources independently. 
+Developers with the required prerequisites can use the self-service capability to provision, deprovision, and manage GenAI resources directly from the Control Center. This enables faster provisioning and reduces manual dependency. 
+For developers who do not have self-service capabilities, GenAI resources can still be provisioned or deprovisioned by contacting sales representatives or customer success manager (CSM) to order an existing stock keeping unit (SKU). 
+Both approaches allow users to scale GenAI resources efficiently and explore more generative AI solutions with Mendix.
+
+### Provisioning GenAI Resources Using the Self-Service Capability
+
+When using the self-service capability, Mendix Admins can manage the provisioning and deprovisioning of GenAI resources directly through the [Control Center](https://controlcenter.mendix.com/index.html). They can provision the new resource, review it, and open it in a new tab of the [Mendix Cloud GenAI portal](https://genai.home.mendix.com/p/homepage). For more information, refer to [GenAI Resources](/control-center/genai-resources-self-service/). 
+
+To provision GenAI resources successfully using self-service, ensure that you meet the requirements below:
+
+1. Mendix Admins can access the Control Center to provision or deprovision the GenAI resources. 
+2. You have sufficient free Mendix Cloud Tokens. These tokens are required to allocate GenAI capacity. For more information, refer to [Cloud Tokens](/control-center/cloud-tokens/).
+
+For further details, refer to the [Prerequisites](/control-center/genai-resources-self-service/#prerequisites) section of *GenAI Resources*.
+
+### Provisioning GenAI Resources Without Using the Self-Service Capability
+
+If the self-service capability is not available in your environment, you can still provision your GenAI resources by ordering the existing SKU associated to your Mendix subscription. To do so, you can contact your sales representative or CSM.
+
 ## Knowledge Bases
 
 Mendix Cloud Knowledge Base Resource Packs provide customers with an elastic, logically isolated vector database, to use for standard Generative AI architectural patterns such as Retrieval-Augmented Generation (RAG), semantic similarity search, and other Generative AI use cases. The Knowledge Bases on Mendix Cloud are based on AWS's highly secure Amazon Bedrock Knowledge Bases capability, combined with AWS' OpenSearch Serverless database— a widely adopted standard infrastructure for Generative AI Knowledge Bases on AWS, ensuring fast & accurate information retrieval.

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

@@ -23,14 +23,14 @@ The **Settings** tab contains the details of a GenAI resource. It shows the foll
 * **Display Name**: indicates the name of the resource.
 * **ID**: indicates the resource ID.
 * **Region(s)**: the region where the resource is hosted.
-* **Cross Region Inference (CRI)**: shows if the model supports cross-region inference*.
+* **Cross Region Inference (CRI)**: shows if the model supports cross-region inference ¹.
 * **Cloud Provider**: indicates the cloud provider, for example, AWS.
 * **Type**: this is the type of resource, for example, Text Generation, Embedding, Knowledge Base, etc.
 * **Model**: indicates which model is used, for example, Anthropic Claude Sonnet 3.5.
 * **Plan**: indicates the subscription plan used for compute resources (for example, embedding or text generation resources).
 * **Environment**: shows which environment is used, for example, test, acceptance, or production.
 
-\* Cross-region inference (CRI) allows a model to redirect requests to another region, helping to distribute the load across multiple regions within the same area. So, EU requests always stay within EU regions. Connecting to a cross-region inference profile does not change how the request is sent; the redirection happens on the server side, determining the region to handle the request to get the fastest response. For more information, see [Increase throughput with cross-Region inference](https://docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference.html). If applicable, CRI profiles are selected during provisioning of a model resource. 
+¹ Cross-region inference (CRI) allows a model to redirect requests to another region, helping to distribute the load across multiple regions within the same area. So, EU requests always stay within EU regions. Connecting to a cross-region inference profile does not change how the request is sent; the redirection happens on the server side, determining the region to handle the request to get the fastest response. For more information, see [Increase throughput with cross-Region inference](https://docs.aws.amazon.com/bedrock/latest/userguide/cross-region-inference.html). If applicable, CRI profiles are selected during provisioning of a model resource. New models are available under the CRI inferencing type by default. 
 
 #### Additional Details for Knowledge Base Resources