Merge pull request mendix#11004 from pieroguerrero-mendix/development

Yiyun333 · web-flow · commit 52e21f35ee20 · 2026-04-22T16:28:33.000+02:00
Reflect SP 10.9 status in Maia for Workflows docs
diff --git a/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-workflows.md b/content/en/docs/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-workflows.md
@@ -12,109 +12,71 @@ 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 %}}
 
-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.
+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 more details, see the [Limitations](#limitation) section below.
 
 ## Using Maia for Workflows
 
-{{% alert color="info" %}}
-In Studio Pro 11.8, Maia for Workflows is not available.
-{{% /alert %}}
+Describe a business process you want to model. Maia uses this information to add relevant workflow activities, and tries to configure them where possible. For more information on how to communicate with Maia to achieve better results when configuring a workflow, see the [Best Practices for Text Input](#text-input-best-practice) section below.
 
-### In Studio Pro 11.9 and Above
+### Version Availability
 
-In Studio Pro 11.9 and above, Maia for Workflows is incorporated into the unified Maia Make capabilities, which are enabled by default. There is no dedicated interface only for Maia for Workflows. For more information, see [Maia Make Capabilities](/refguide/maia-make/).
+#### Studio Pro 11.9 and Above
 
-### In Studio Pro 11.7 and Below
+Maia for Workflows is incorporated into the unified [Maia Make Capabilities](/refguide/maia-make/), which are enabled by default.
 
-To enable Maia for Workflows in Studio Pro 11.7 and below, go to **Edit** > **Preferences** > the **Maia** tab and select **Enable Maia for Workflows**.
+#### Studio Pro 11.8
 
-Once enabled, you can find it in the the toolbar of a workflow:
+Maia for Workflows is not available.
 
-{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-workflows/maia-for-workflows.png" max-width=80% >}}
+#### Studio Pro 11.7 and Below
 
-After clicking **Maia for Workflow**, a dedicated chat interface appears at the right side of Studio Pro under the **Maia** tab:
+To enable Maia for Workflows, go to **Edit** > **Preferences** > the **Maia** tab and select **Enable Maia for Workflows**. Once enabled, you can find it in the toolbar of a workflow:
 
-{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-workflows/chat-interface.png" max-width=42% >}}
-
-Describe a business process which you want to model and Maia uses this information to add relevant workflow activities, and tries to configure them where possible. You can also supplement text input with a maximum of one image and one PDF file, which Maia uses to interpret your request more effectively. For more information, see the [Attachment Requirements](#attachment-requirements) section below. 
+{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-workflows/maia-for-workflows.png" max-width=80% >}}
 
-After a workflow is generated, you can continue asking Maia in the same session to further improve the workflow and provide explanations.
+After clicking **Maia for Workflow**, a chat interface appears at the right side of Studio Pro under the **Maia** tab:
 
-{{% alert color="info" %}}
-In this dedicated chat, only requests related to Workflows will be properly handled. If you have other questions, close this chat and go back to the general [Maia Chat](/refguide/maia-chat/) interface.
-{{% /alert %}}
+{{< figure src="/attachments/refguide/modeling/mendix-ai-assistance/maia-make/maia-for-workflows/chat-interface.png" max-width=42% >}}
 
-#### Best Practices for Text Input
+### Best Practices for Text Input {#text-input-best-practice}
 
 To achieve optimal results, provide context about your workflow by describing its main use cases, customer needs, or other relevant details. The more Maia knows about your workflow, the more tailored and accurate the generated workflow will be.
 
 Below are some examples of prompts you can use as a starting point:
 
-* The workflow will be used to ...
+* Please generate a workflow for a process that...
 * Create a workflow based on the image.
 * Base the workflow on the image, but change ... to ...
 
-Below are some examples of prompts you can use to ask Maia for further explanations or suggestions to improve the generated page:
-
-* Can you make the timer wait for 5 days?
-* I want the process to run in parallel.
-
-{{% alert color="warning" %}}
-Requests for improvements or explanations currently only work within the same session where the workflow is generated. If you close the session and start a new session on that workflow, any attempts to make changes to the workflow will result in the removal of existing elements.
-{{% /alert %}}
-
-#### Attachment Requirements {#attachment-requirements}
-
-Maia for Workflows supports adding a maximum of one image and one PDF as attachments. Support for adding a PDF file was introduced in Studio Pro 11.2.0.
-
-The attachments must meet the following requirements:
-
-* The image format must be PNG or JPG.
-* The image file size must not exceed 512 KB.
-* The image resolution must be no greater than 3840 × 2400 pixels.
-* The PDF file size must not exceed 1024 KB.
-
-For example, Maia for Workflows can analyze a BPMN image representing employee onboarding, rework it using Mendix Workflows terminology, and generate the corresponding activities for you. Alongside the image, you can also use text input to specify how the generated workflow should differ from the provided image. For example, you might write: *Generate a workflows based on this BPMN image, but make sure it waits before sending an email to the new employee.*
+Maia for Workflows can analyze a BPMN image representing employee onboarding, rework it using Mendix Workflows terminology, and generate the corresponding activities for you. Alongside the image, you can also use text input to specify how the generated workflow should differ from the provided image. For example, you might write: *Generate a workflow based on this BPMN image, but make sure it waits before sending an email to the new employee.*
 
 Make sure to select a clear image to help Maia better understand your request. For example, you can provide a screenshot, a photo, BPMN schema, or a close-up picture of a drawing. Avoid heavily compressed or low quality images, as these may result in the loss of important details.
 
-#### Limitations {#limitation}
+Below are some examples of prompts you can use to ask Maia for further explanations or suggestions to improve the generated workflow:
 
-Maia for Workflows has some limitations.
-
-##### Empty Workflows Only
-
-Maia for Workflows is currently intended only for use with empty Workflows. Using it on existing workflows can result in incorrectly modeled business processes.
+* Can you explain this workflow to me?
+* Can you give me suggestions to improve this workflow?
+* Can you make the timer wait for 5 days?
+* I want the process to run in parallel.
 
-Requests for improvements and explanations currently only work within the same session where a workflow has been generated. Once the session is closed, Maia for Workflows loses the context. Any attempts to make changes to that workflow in a new session will also result in the removal of all existing elements.
+## Limitations {#limitation}
 
-##### Supported Workflow Elements
+Maia for Workflows currently has some limitations.
 
-Currently, annotations are not supported. However, most of the other workflow elements are supported. See below a list of supported workflow elements:
+### Supported Workflow Elements
 
-* [User Task](/refguide/user-task/)
-* [Multi-user Task](/refguide/multi-user-task/)
-* [Decision](/refguide/decision-in-workflows/)
-* [Parallel Split](/refguide/parallel-split/)
-* [Jump](/refguide/jump-activity/)
-* [Wait for Notification](/refguide/wait-for-notification/)
-* [Timer](/refguide/timer/)
-* [Call Microflow](/refguide/call-microflow/)
-* [Call Workflow](/refguide/call-workflow/)
-* [Boundary Events](/refguide/workflow-boundary-events/)
+Currently, [Multi-user task](/refguide/multi-user-task/) is not supported. However, most of the other workflow elements are supported.
 
-##### Not All Properties Can Be Configured
+### Not All Properties Can Be Configured
 
 Due to the complex cross-document nature of a workflow, not all properties of the workflow elements can be generated yet. The following properties cannot be configured yet:
 
-* The following properties of [User Task](/refguide/user-task/):
-    * Task page
-    * Targeted users
-    * Due date
-* Any [properties](/refguide/workflow-properties/) of the workflow document itself
+* From the workflow document itself
+* [Admin Page](/refguide/workflow-properties/#admin-page)
 
 ## Read More
 
-* [Workflow](/refguide/workflows/)
+* [Maia Make Capabilities](/refguide/maia-make/)
 * [Mendix AI Assistance (Maia)](/refguide/mendix-ai-assistance/)
+* [Workflow](/refguide/workflows/)
 * [Maia Chat](/refguide/maia-chat/)
