Merge pull request #2 from EmilyvonBergen/patch-3

SAS-896 Addition of MxCloud GenAI in how-to

Author: EmilyvonBergen

content/en/docs/appstore/use-content/platform-supported-content/modules/genai/using_genai/start_from_a_starter_app.md

@@ -40,6 +40,8 @@ To simplify your first use case, start building a chatbot using the [AI Bot Star
 
 Selecting the infrastructure for integrating GenAI into your Mendix application is the first step. Depending on your use case and preferences, you can choose from the following options:
 
+* [Mendix Cloud GenAI Resources Packs](/appstore/modules/genai/MxGenAI/): Part of the [Mendix Cloud GenAI Resources Packs](https://marketplace.mendix.com/link/component/229305), integrates LLMs by dragging and dropping common operations from its toolbox in Studio Pro.
+
 * [OpenAI](/appstore/modules/genai/openai/): The [OpenAI Connector](https://marketplace.mendix.com/link/component/220472?_gl=1*1gbywo4*_gcl_au*NjUwMzI0NzA0LjE3MzI2MjkxMTI.) supports OpenAI’s platform and Azure’s OpenAI service.
 
 {{% alert color="info" %}}
@@ -54,6 +56,20 @@ To start, you can sign up for a free trial with OpenAI and receive credits valid
 
 Download the [AI Bot Starter App](https://marketplace.mendix.com/link/component/227926) from the Marketplace and configure the **encryption key** in the **App Settings**. Follow the steps below based on the infrastructure you chose.
 
+#### Mendix Cloud GenAI Configuration
+
+Follow these steps to configure the Mendix Cloud GenAI Resources Packs for your application and for more background information, look at the [Mendix Cloud GenAI Configuration]() documentation:
+
+1. Run the application locally.
+
+2. Configure the Mendix Cloud GenAI Settings:
+   * In the chatbot-like application interface, go to **Administration** icon, and find the **Mendix Cloud GenAI Configuration**.
+   * Select **Import key** and paste the key from the Mendix Portal given to you.
+
+3. Test the Configuration:
+   * Find the configuration you created, and select **Test Key** on the right side of the row.
+   * If an error occurs, check the **Mendix Console** for more details on resolving the issue.
+
 #### OpenAI Configuration
 
 Follow the steps below to configure OpenAI for your application. For more information, see the [Configuration](/appstore/modules/genai/openai/#configuration) section of the *OpenAI*.
@@ -62,21 +78,30 @@ Follow the steps below to configure OpenAI for your application. For more inform
 
 2. Configure OpenAI Settings:
 
-   * In the chatbot-like application interface, go to the **Settings** ({{% icon name="cog" %}}) icon, and find the **OpenAI Configuration**.
+   * In the chatbot-like application interface, go to the **Administration** ({{% icon name="cog" %}}) icon, and find the **OpenAI Configuration**.
    * Click **New** and provide the following details:
      * **Display Name**: A reference name to identify this configuration (for example, "My OpenAI Configuration").
      * **API Type**: Choose between **OpenAI** or **Azure OpenAI**.
      * **Endpoint**: Enter the endpoint URL for your selected API type.
-     * **Token**: Provide the API key for authentication.
-     * If using Azure OpenAI, add:
-       * **Deployment Name**: Specify the deployed model (for example, *gpt-4o*, *gpt-3.5-turbo*, etc.)
-       * **API Version**: Provide the version of the API you are using (for example, *2024-06-01*, *2024-10-21*, etc.)
+     * **API key**: Provide the API key for authentication.
+         * If using Azure OpenAI, add the **Azure key type** by choosing between **OpenAI** or **Azure OpenAI**.
+
+     * After saving the changes, a new pop-up will appear to add the deployment models. Select **Add deployed model** and provide the following details (optional for the OpenAI API Type):
+         * **Display name**: A reference name for the deployed model (e.g., "GPT-4 Conversational").
+         * **Deployment Name**: Specify the deployed model (for example, *gpt-4o*, *gpt-3.5-turbo*, etc.)
+         * **Output modality**: Indicate the type of output (e.g., Text, Embeddings, Image).
+         * **Support system prompt**: Indicate whether the model supports system prompts.
+         * **Support conversations with history**: Indicate whether the model can remember and utilize previous interactions in a conversation by referring back to earlier messages in the chat.
+         * **Support function calling**: Indicate whether the model can invoke different functions during the conversation based on the user input.
+         * **Azure API Version**: Provide the version of the API you are using (for example, *2024-06-01*, *2024-10-21*, etc.)
+         * **Is active**: Indicate whether the deployment model should be active to be used in the app.
 
    * Click **Save** to store your configuration.
 
 3. Test the Configuration:
 
-   * Select the configuration you created, and click **Test Configuration**.
+   * Find the configuration you created, click the three dots on the right side, and select **Test**.
+   * In the **Test configuration**, select the deployed model and press **Test**.
    * If an error occurs, check the **Mendix Console** for more details on resolving the issue.
 
 #### Bedrock Configuration
@@ -105,16 +130,15 @@ Follow the steps below to configure Amazon Bedrock for your application:
 
 ### Bot Configuration
 
-Before starting the bot configuration, ensure that the OpenAI or Bedrock configuration is complete.
+Before starting the bot configuration, ensure that the Mendix Cloud GenAI, OpenAI or Bedrock configuration is complete.
 
 1. In the **Administration** menu, go to the **Bot Configuration**, and click **New**.
 2. Enter the following details:
 
-     * **Display Name**: A reference name for the bot configuration (for example, "Configuration Bot").
-     * **Architecture**: Select **OpenAI** or **Bedrock** based on your choice.
+     * **Display Name**: A reference name for the bot configuration (for example, "MxCloud GenAI Configuration Bot").
      * **Is Selectable in UI**: Enable this option to allow the end user to select this configuration.
-     * **Configuration**: Select the OpenAI or Bedrock configuration you just created.
-     * **Action Microflow**: Choose the provided microflow, `ChatContext_ChatWithHistory_ActionMicroflow`.
+     * **Model**: Select the  Mendix Cloud GenAI, OpenAI or Bedrock model you just created.
+     * **Action Microflow**: Choose the provided microflow (e.g.,  `ChatContext_ChatWithHistory_ActionMicroflow`).
 
 3. Save your changes, and optionally set it as the default bot configuration by selecting **Make Default** on the Bot Configuration page.