Merge pull request mendix#10787 from mendix/yl-maia-make-documentation

Add Maia Make Documentation

Author: Yiyun333

content/en/docs/refguide/modeling/mendix-ai-assistance/_index.md

@@ -39,6 +39,16 @@ Mendix AI Assistance (Maia) in Studio Pro has the following capabilities:
 Starting point for app creation:
 
 * **Start with Maia** - a starting point in Studio Pro that helps you to start the app development process. Based on a required text description and an optional image or PDF, it generates an app that includes a domain model, data management overview pages, test data, and a tailored homepage. For more information, see [Start with Maia](/refguide/start-with-maia/).
+* **Maia Make** - a unified conversational interface in Studio Pro that groups all AI-assisted development capabilities into a single chat experience. With this interface, everything happens in one place. Start a conversation, describe what you need, and Maia generates the necessary app artifacts—a new domain model, overview pages, or microflows, or explaining your app logic and pages. Below is a list of Maia Make Capabilities:
+
+    * **Domain model creation** - Describe your data structure and Maia creates the entities and associations you need.
+    * **Page generation** - Generate overview pages.
+    * **Microflow generation** - Generate microflows, enumerations, XPath constraints, and expressions.
+    * **MCP client** - Connect to compatible MCP Servers to leverage tools such as Playwright or Figma to improve the capabilities of Maia.
+    * **Document upload** - Upload a PDF or an image and you can ask Maia to use it in your app creation. 
+    * **User story linking** - Select an existing story in Studio Pro and Maia can help you realize it. 
+
+    This unified conversational interface is released in Studio Pro 11.8. For more information, see [Maia Make](/refguide/maia-make/).
 
 Guidance:
 

content/en/docs/refguide/modeling/mendix-ai-assistance/maia-for-workflows.md

@@ -12,6 +12,10 @@ description: "Describes the features in Maia for Workflows."
 To use Maia for Workflows, an internet connection and signing in to Studio Pro are required.
 {{% /alert %}}
 
+{{% alert color="info" %}}
+In Studio Pro 11.8, Maia for Workflows is not available.
+{{% /alert %}}
+
 Maia for Workflows helps you generate a [workflow](/refguide/workflows/). It can also provide explanations or further improvements based on the generated elements. The current version has some known limitations. For example, it is currently intended only for use with empty workflows. Generated elements are appended to the end of the workflow, which may result in incorrectly modeled workflows if the workflow is not empty. For more details, see the [Limitations](#limitation) section below.
 
 ## Using Maia for Workflows

content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/_index.md

@@ -0,0 +1,76 @@
+---
+title: "Maia Make Capabilities"
+url: /refguide/maia-make/
+weight: 4
+description: "Describes Maia Make capabilities in Mendix Studio Pro."
+description_list: true
+#If moving or renaming this doc file, implement a temporary redirect and let the respective team know they should update the URL in the product. See Mapping to Products for more details.
+---
+
+## Introduction 
+
+{{% alert color="info" %}}
+Maia Make capabilities are grouped into a conversational interface, which is available in Studio Pro 11.8 and above.
+
+To use this interface and Maia Make capabilities, an internet connection and signing in to Studio Pro are required.
+{{% /alert %}}
+
+Maia Make is a set of AI-assisted development capabilities in Studio Pro that are available through a unified conversational interface. Describe your requirements in natural language, and Maia generates development artifacts such as data structures, overview pages, and microflows. 
+
+You can also ask Maia to provide explanations of your existing logic and pages. Moreover, this interface allows you to integrate with external tools via MCP Servers (Playwright, Figma, and others) and it supports story-based development by generating app artifacts based on existing user stories.
+
+The key Maia Make capabilities are as follows:
+
+* Conversational assistance for general Mendix development queries
+* Logic and page explanations to clarify existing implementation details
+* Domain model generation from natural language descriptions
+* Overview page generation from natural language descriptions
+* Microflow generation including XPath constraints and expressions
+* External tool integration via compatible MCP Servers (such as Playwright, Figma)
+* Story-based development to help realize existing user stories
+* PDF and image support to help Maia understand your requirements better
+* Add relevant logic and pages to the interface to give Maia a more desired context
+
+## Using Maia Make Capabilities
+
+Maia Make capabilities are enabled by default. You can disable them in Studio Pro **Preferences**, via the **Maia** tab.
+
+To access the conversational interface and Maia Make capabilities, in the upper-right corner of Studio Pro, click the **Maia** pane. It appears under the **Chat** tab:
+
+{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-make-interface.png" max-width=40% alt="Maia Make interface" >}}
+
+Alternatively, you can also click **View** at the Studio Pro top bar and select **Maia** to open the interface.
+
+{{% alert color="info" %}}
+In Studio Pro 11.7 and below, the **Chat** tab is only used for [Maia Chat](/refguide/maia-chat/) where you can ask questions about all aspects of Mendix.
+
+There is also the **Learn** tab under the **Maia** pane. It is a separate Maia capability that is not part of Maia Make capabilities. For more information, see [Maia Learn](/refguide/maia-learn/).
+{{% /alert %}}
+
+{{% alert color="warning" %}}
+The Maia ({{% icon name="sparkles" %}} ) icon on the right side of the top bar does not work in Studio Pro 11.8.
+{{% /alert %}}
+
+### Maia Make Capabilities Interface Overview
+
+The conversational interface includes the following options:
+
+* **New chat** - It allows you to clear the messages and start a new conversation which does not reference your current chat.
+* **Configure MCP Connections** ({{% icon name="plug" %}} icon) - It allows you to connect external [MCP](https://modelcontextprotocol.io/introduction) servers to Maia, giving it access to third-party tools during chat. For more information on how to configure MCP connections, see [Maia MCP Client](/refguide/maia-mcp/).
+* **{{% icon name="paperclip" %}} Add** (Image, Story, PDF) - With this option, you can attach images, PDFs, or user stories to help Maia understand your requirements better.
+* **Add file to Maia Chat** (@ icon) - It allows you to add certain logic or pages to Maia as context. You can also access this option by right-clicking the documents (microflows or pages) in the **App Explorer** and it appears in the context menu.
+
+For more information on how each Maia Make capability work, refer to the following documents:
+
+* [Maia Chat](/refguide/maia-chat/)
+* [Maia Explain](/refguide/maia-explain/)
+* [Maia for Domain Model](/refguide/maia-for-domain-model/)
+* [Maia for Pages](/refguide/maia-for-pages/)
+* [Maia for Microflows](/refguide/maia-for-microflows/)
+* [Maia MCP Client](/refguide/maia-mcp/)
+
+In Studio Pro 11.8 and above, most of the features described in the documents above are available only through the chat interface. There are no separate entry points to these features in their respective editors. [Maia Explain](/refguide/maia-explain/) is an exception. You can still access this feature by right-clicking the documents (microflows or pages) in the **App Explorer** and the **Maia Explain** option is in the context menu.
+
+## Read More
+
+* [Mendix AI Assistance (Maia)](/refguide/mendix-ai-assistance/)

…deling/mendix-ai-assistance/maia-chat.md …dix-ai-assistance/maia-make/maia-chat.mdcontent/en/docs/refguide/modeling/mendix-ai-assistance/maia-chat.md renamed to content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-chat.md content/en/docs/refguide/modeling/mendix-ai-assistance/maia-chat.md renamed to content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-chat.md

@@ -36,20 +36,24 @@ See below a list of Maia Chat's data sources:
 
 ## Using Maia Chat in Studio Pro
 
-There are two ways to access Maia Chat in Studio Pro:
+{{% alert color="info" %}}
+In Studio Pro 11.8 and above, Maia Chat is incorporated into the unified Maia Make capabilities, which are enabled by default. There is no dedicated interface only for Maia Chat. For more information, see [Maia Make Capabilities](/refguide/maia-make/).
+{{% /alert %}}
+
+In Studio Pro 11.7 and below, there are two ways to access Maia Chat in Studio Pro:
 
 * Click the **Maia** ({{% icon name="sparkles" %}}) icon to the right of the top bar.
 * Go to the **View** menu and click **Maia**.
 
 The chat interface appears at the right side of Studio Pro under the **Maia** pane:
 
-{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-chat/maia-chat-interface.png" width="250px">}}
+{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-chat/maia-chat-interface.png" width="250px">}}
 
 You can start using Maia Chat by clicking one of the demo questions. Alternatively, you can ask your own question, and press <kbd>Enter</kbd> or click **Ask** to send the question. For information on the supported shortcut keys in Maia Chat, see the [Maia Chat Shortcut Keys](/refguide/keyboard-shortcuts/#maia-chat-shortcuts) section in *Keyboard Shortcuts*.
 
 For more information on Maia Chat features in Studio Pro, see the sub-sections below.
 
-If Maia is not giving you a good answer, check the [best practices](/portal/maia/#best-practices) in *Maia in Mendix Portal*. If you still can't get a good answer, please see [Giving Feedback](#feedback), below for information on how to let Mendix know.
+If Maia is not giving you a good answer, check the [best practices](/portal/maia/#best-practices) in *Maia in Mendix Portal*. If you still can not get a good answer, please see the [Giving Feedback](#feedback) section below for information on how to let Mendix know.
 
 ### Maia Chat Features in Studio Pro
 
@@ -72,7 +76,7 @@ There are several ways to give feedback on the generated answer:
 * Click the thumbs up icon ({{% icon name="thumbs-up" %}}) or the thumbs down icon ({{% icon name="thumbs-down" %}})
 * To provide more detailed feedback, click the add feedback icon ({{% icon name="notes-paper-edit" %}}). A detailed **Feedback** section shows below the answer:
 
-    {{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-chat/feedback-section.png" width="250px" >}}
+    {{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-chat/feedback-section.png" width="250px" >}}
 
     * You can rate the **correctness**, **completeness**, and **readability** of the provided answer.
     * You can also provide **Additional feedback** if you want to.

…ing/mendix-ai-assistance/maia-explain.md …-ai-assistance/maia-make/maia-explain.mdcontent/en/docs/refguide/modeling/mendix-ai-assistance/maia-explain.md renamed to content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-explain.md content/en/docs/refguide/modeling/mendix-ai-assistance/maia-explain.md renamed to content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-explain.md

@@ -12,20 +12,29 @@ description: "Describes the features in Maia Explain."
 To use Maia Explain, an internet connection and signing in to Studio Pro are required.
 {{% /alert %}}
 
-Maia Explain helps you easily understand a microflow or a nanoflow. It explains the general purpose of the logic and highlights specific technical details to help you understand the logic further.
+## Using Maia Explain in Studio Pro 11.8 and Above
 
-## Using Maia Explain
+In Studio Pro 11.8 and above, Maia Explain is incorporated into the unified Maia Make capabilities, which are enabled by default. There is no dedicated interface only for Maia Explain. For more information, see [Maia Make Capabilities](/refguide/maia-make/).
 
-Maia Explain is enabled by default. If you want to disable this feature, go to **Edit** > **Preferences** > the **Maia** tab and clear the **Enable Maia Explain** checkbox.
+There are two ways to use Maia Explain:
 
-There are two ways to launch Maia Explain:
+* Use the chat interface directly to get explanations of your microflows or pages.
+* In the App Explorer, right-click a microflow or a page to open its context menu, and click **Maia Explain**.
+
+Nanoflows are not supported by Maia Explain in Studio Pro 11.8.
+
+## Using Maia Explain in Studio Pro 11.7 and Below
+
+In Studio Pro 11.7 and below, Maia Explain is enabled by default. If you want to disable this feature, go to **Edit** > **Preferences** > the **Maia** tab and clear the **Enable Maia Explain** checkbox.
+
+There are two ways to use Maia Explain:
 
 * In the toolbar of the microflow or nanoflow editor, click **Explain**.
 * In the App Explorer, right-click a microflow or a nanoflow to open its context menu, and click **Explain**.
 
 A message is sent to Maia and a chat interface with an initial answer appears on the right side of Studio Pro under the **Maia** tab:
 
-{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-explain/maia-explain-interface.png" width="300px">}}
+{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-explain/maia-explain-interface.png" width="300px">}}
 
 The initial answer consists of two parts: 
 
@@ -44,4 +53,5 @@ In this dedicated chat, only requests related to Maia Explain will be properly h
 
 ## Read More
 
+* [Mendix AI Assistance (Maia)](/refguide/mendix-ai-assistance/)
 * [Maia Chat](/refguide/maia-chat/)

…x-ai-assistance/maia-for-domain-model.md …tance/maia-make/maia-for-domain-model.mdcontent/en/docs/refguide/modeling/mendix-ai-assistance/maia-for-domain-model.md renamed to content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-domain-model.md content/en/docs/refguide/modeling/mendix-ai-assistance/maia-for-domain-model.md renamed to content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-domain-model.md

@@ -18,17 +18,19 @@ Maia for Domain Model helps you generate new [domain model](/refguide/domain-mod
 
 ## Using Maia for Domain Model
 
-Maia for Domain Model is enabled by default.
+{{% alert color="info" %}}
+In Studio Pro 11.8 and above, Maia for Domain Model is incorporated into the unified Maia Make capabilities, which are enabled by default. There is no dedicated interface only for Maia for Domain Model. For more information, see [Maia Make Capabilities](/refguide/maia-make/).
+{{% /alert %}}
 
-You can find it in the the toolbar of a domain model:
+In Studio Pro 11.7 and below, Maia for Domain Model is enabled by default. You can find it in the the toolbar of a domain model:
 
-{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-for-domain-model/maia-for-domain-model.png" max-width=80% >}}
+{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-domain-model/maia-for-domain-model.png" max-width=80% >}}
 
 If you want to disable this feature, go to **Edit** > **Preferences** > the **Maia** tab and clear the **Enable Maia for Domain Model** checkbox.
 
 After clicking **Maia for Domain Model**, a dedicated chat interface will appear at the right side of Studio Pro under the **Maia** tab:
 
-{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-for-domain-model/chat-interface.png" max-width=42% >}}
+{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-domain-model/chat-interface.png" max-width=42% >}}
 
 Describe your application or its main goals in the chat. Maia will use this information to generate a relevant domain model for you. In Studio Pro 11.1 and above, you can also attach maximally one image and one PDF to help Maia better understand your request. For more information, see the [Attachment Requirements](#attachment-requirements) section below. 
 

content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-microflows.md

@@ -0,0 +1,47 @@
+---
+title: "Maia for Microflows"
+url: /refguide/maia-for-microflows/
+weight: 75
+description: "Describes the features in Maia for Microflows."
+---
+## Introduction
+
+{{% alert color="info" %}}
+This feature is released as part of [Make Make](/refguide/maia-make/) capabilities in Studio Pro 11.8. 
+{{% /alert %}}
+
+Maia for Microflows is an AI-powered capability that is available when using [Maia Make](/refguide/maia-make/) in Studio Pro. Maia Make is a unified conversational interface within Studio Pro that consolidates all AI-assisted development capabilities into a single chat experience. 
+
+With the microflow generation capability, you can leverage Maia to generate microflow logic efficiently from your text input. It is a powerful tool for quickly setting up both simple and complex microflows, with the goal of providing ready-to-use logic that minimizes the need for manual adjustments.
+
+## Using Maia for Microflows
+
+Open the Maia Make conversational interface in Studio Pro to access its microflow generation capability. Use natural language to describe your goal, Maia will generate the microflows for you, including XPath constraints and expressions. See the section below for text input best practices.
+
+### Best Practices for Text Input
+
+To achieve the best results when using Maia to generate microflows, consider the following guidelines for your text input:
+
+* Be specific: Clearly describe the desired outcome and the steps involved. For example, instead of using *Create a user*, use *Create a new user object, set its name attribute to 'John Doe', and commit it*.
+* Use keywords: Incorporate terms relevant to microflow activities, such as *create object*, *retrieve*, *change object*, *show message*, *loop*, or *decision*. This can help with correct microflow generation.
+* Provide context: If your microflow interacts with existing entities or attributes, mention them in your text input.
+
+## Limitations
+
+### Destructive Operations Are Not Supported
+
+Maia for Microflows can create objects and flows and change simple ("primitive") settings, but it cannot delete objects or replace complex configuration settings. For example, for existing objects, Maia can change variable names, move objects, or reconnect flows, but it cannot delete objects or flows, or change the activity types.
+
+### Variability in Results
+
+Due to the nature of AI generation, the exact microflow logic produced can vary between separate runs, even with identical input. It is recommended to review the generated output carefully.
+
+### Layout and Positioning
+
+While Maia aims to create functional logic, the visual layout and positioning of elements within the generated microflow may not always be optimally organized. You may need to adjust the arrangement of activities for better readability and structure.
+
+## Read More
+
+* [Microflows](/refguide/microflows/)
+* [Mendix AI Assistance (Maia)](/refguide/mendix-ai-assistance/)
+* [Maia Chat](/refguide/maia-chat/)

…g/mendix-ai-assistance/maia-for-pages.md …i-assistance/maia-make/maia-for-pages.mdcontent/en/docs/refguide/modeling/mendix-ai-assistance/maia-for-pages.md renamed to content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-pages.md content/en/docs/refguide/modeling/mendix-ai-assistance/maia-for-pages.md renamed to content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-pages.md

@@ -18,19 +18,23 @@ Maia for Pages helps you generate a [page](/refguide/page/) by adding and config
 
 ## Using Maia for Pages
 
-To enable Maia for Pages, go to **Edit** > **Preferences** > the **Maia** tab and select **Enable Maia for Pages**.
+{{% alert color="info" %}}
+In Studio Pro 11.8 and above, Maia for Pages is incorporated into the unified Maia Make capabilities, which are enabled by default. There is no dedicated interface only for Maia for Pages. For more information, see [Maia Make Capabilities](/refguide/maia-make/).
+{{% /alert %}}
+
+In Studio Pro 11.7 and below, to enable Maia for Pages, go to **Edit** > **Preferences** > the **Maia** tab and select **Enable Maia for Pages**.
 
 Once enabled, you can find it in the the toolbar of a page:
 
-{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-for-pages/maia-for-pages.png" max-width=80% >}}
+{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-pages/maia-for-pages.png" max-width=80% >}}
 
 {{% alert color="info" %}}
 Maia for Pages is available in both the **Structure mode** and **Design mode**.
 {{% /alert %}}
 
 After clicking **Maia for Pages**, a dedicated chat interface appears at the right side of Studio Pro under the **Maia** tab:
 
-{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-for-pages/chat-interface.png" max-width=42% >}}
+{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-pages/chat-interface.png" max-width=42% >}}
 
 Describe your page or its main goals in the chat. Maia uses this information to add relevant widgets to the page and configure them for you. When generating a page, Maia knows about the domain model of the module you are currently working on. For example, it might include a [Data View](/refguide/data-view/) with some [Text Box](/refguide/text-box/) widgets for an attribute of an entity.