Skip to content

Commit cc675e1

Browse files
HarishShankerASquinntracyclaude
authored
Add import and export mappings to Maia Make supported document types (#12131)
* Add Maia Plan Mode documentation * Review * Add Maia General Capabilities * Adjust SP wording * Revise Remarks section to include Markdown support * Add support for Java Action generation * Add import and export mappings to Maia Make supported document types Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> * Update with screenshot * Remove Excel note * Add Permissions to Maia Settings * Add to Settings and update screenshot * Update in MCP Client * Update to MCP tools --------- Co-authored-by: Quinn Tracy <142489060+quinntracy@users.noreply.github.com> Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
1 parent 688ef57 commit cc675e1

7 files changed

Lines changed: 73 additions & 7 deletions

File tree

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

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -108,6 +108,7 @@ In Studio Pro 11.8 and above, [Maia Make](/refguide/maia-make/) replaces Maia Ch
108108
* **[Chat with Maia](/refguide/maia-chat/)** – Ask questions about app development in Mendix using Maia's chat feature, including how to apply concepts, best practices, and development patterns.
109109
* [Maia Learn](/refguide/maia-learn/) – Learn Mendix core concepts quickly to get started with Studio Pro.
110110
* [Maia Explain](/refguide/maia-explain/) – Maia Explain helps you understand existing documents, such as microflows and pages. It explains the general purpose of the document and highlights specific technical details.
111+
* [Maia Plan Mode](/refguide/maia-plan-mode/) – Maia Plan Mode allows you to create detailed implementation plans for whole apps or large application features.
111112

112113
### Context and Customization
113114

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

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -40,14 +40,16 @@ Maia Make can generate new documents, modify existing documents, and explain app
4040
| Enumerations | Studio Pro 11.9 | |
4141
| Constants | Studio Pro 11.9 | |
4242
| Modules | Studio Pro 11.9 | |
43-
| Java actions | Studio Pro 11.9 | Read-only; Java actions cannot be generated. |
43+
| Java actions | Studio Pro 11.9 | In Studio Pro 11.9 and above, Java actions are read-only and cannot be generated. In Studio Pro 11.16 and above, Java action documents and source code files can be generated and edited. |
4444
| JavaScript actions | Studio Pro 11.9 | Explain-only in Studio Pro 11.9. Generation, adding parameters, and updating the associated JavaScript file available from Studio Pro 11.10. |
4545
| Navigation | Studio Pro 11.11 | |
4646
| Menu | Studio Pro 11.11 | |
4747
| Data Transformers | Studio Pro 11.12 | |
4848
| JSON Structures | Studio Pro 11.13 | |
4949
| Change Data Capture | Studio Pro 11.14 | |
5050
| Task Queues | Studio Pro 11.15 | |
51+
| Import Mappings | Studio Pro 11.16 | Maia can create import mappings with a JSON structure as the source and map them automatically to new entities. Changing existing import mappings is not supported. |
52+
| Export Mappings | Studio Pro 11.16 | Maia can create export mappings with a JSON structure as the source and map them automatically to new entities. Changing existing export mappings is not supported. |
5153

5254
### Maia Make Standalone Capabilities
5355

@@ -62,6 +64,7 @@ The following table lists Maia Make Standalone Capabilities and the Studio Pro v
6264
| [Maia Web Fetch](/refguide/maia-web-fetch/) | Fetches and reads content from public websites and APIs. | Studio Pro 11.10 | |
6365
| [Maia Agent Skills (SKILLS.md)](/refguide/maia-agent-skills/) | Extends Maia with reusable knowledge. | Studio Pro 11.11 | Maia can create and edit skills directly in chat, for both project-level and module-level skills, from Studio Pro 11.15. |
6466
| [Maia Agent Instructions (AGENTS.md)](/refguide/maia-agent-instructions/) | Extends Maia with instructions to be followed with every prompt | Studio Pro 11.12 | |
67+
| [Maia Plan Mode](/refguide/maia-plan-mode/) | Allows Maia to maintain implementation plans. | Studio Pro 11.16 | |
6568

6669
### Maia Make General Capabilities
6770

@@ -70,16 +73,16 @@ The following table lists the general capabilities of Maia Make and the Studio P
7073
| Capability | Description | Available in Maia Make from | Remarks |
7174
| --- | --- | --- | --- |
7275
| Story-based development | Generates app artifacts based on existing user stories to support story-driven development workflows. | Studio Pro 11.8 | |
73-
| PDF/image support | Allows you to provide PDFs and images as input to help Maia better understand your requirements. | Studio Pro 11.8 | |
76+
| Attach files | Allows you to provide PDFs and images as input to help Maia better understand your requirements. | Studio Pro 11.8 | In Studio Pro 11.12 and above, you can attach Markdown files. In Studio Pro 11.16 and above, you can attach CSV, JSON, XML, YAML, and HTML files. Attached files are available to Maia for the rest of the session. |
7477
| Adding documents as context | Lets you add relevant documents to provide Maia with additional context. | Studio Pro 11.8 | |
7578
| Editing existing documents | Enables Maia to modify existing documents, including renaming elements. | Studio Pro 11.8 | |
7679
| Removing elements | Allows Maia to remove elements from documents to support more advanced refactoring tasks. | Studio Pro 11.9 | |
7780
| Undo support | Allows you to undo Maia-generated changes on a per-document basis. | Studio Pro 11.9 | |
7881
| Folder structure support | Organizes new documents into existing folders and follows your established folder hierarchy when generating content. | Studio Pro 11.10 | Not supported for pages. |
7982
| Themes and styling | Allows Maia to modify theme variables, create custom styling, and manage design properties. | Studio Pro 11.12 | |
80-
| Markdown attachment support | Allows you to provide Markdown documents as input to help Maia better understand your requirements. | Studio Pro 11.12 | |
8183
| Explain and solve consistency errors | Allows you to use Maia to explain or solve problems by right-clicking the item in the **Errors** pane. | Studio Pro 11.12.1 | |
8284
| Translations | Allows Maia to create and update translations in your app. | Studio Pro 11.15 | |
85+
| Delete documents | Allows Maia to delete documents in your app. | Studio Pro 11.16 | |
8386

8487
## Using Maia Make Capabilities
8588

@@ -109,7 +112,7 @@ Clicking **New Chat** allows you to clear the messages and start a new conversat
109112

110113
#### Settings
111114

112-
The Settings option ({{% icon name="cog" %}}) allows you to manage your MCP Servers, agent skills, and export your Maia agent session.
115+
The Settings option ({{% icon name="cog" %}}) allows you to manage your MCP Servers, agent skills, and export your Maia agent session. It also allows you to view and manage your tool permissions. You can configure permissions to **Always Allow** or allow only in the current session.
113116

114117
{{< figure src="/attachments/refguide/mendix-ai-assistance/maia-make/maia-make-capabilities/maia-settings.jpg" width="250px" alt="" >}}
115118

‎content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-mcp.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,8 @@ For details on the current limitations, see the [Limitations](#limitations) sect
2323

2424
There are two ways to open the MCP Client panel:
2525

26-
* Open the **Chat** tab in the **Maia** pane, then click **Configure MCP Connections** ({{% icon name="plug" %}}).
26+
* Open the **Chat** tab in the **Maia** pane, then click **Settings** ({{% icon name="cog" %}}) > **MCP Servers***.
27+
* For Studio Pro 11.14 and below, open the **Chat** tab in the **Maia** pane, then click **Configure MCP Connections** ({{% icon name="plug" %}}).
2728
* Go to the **View** menu and click **Maia Settings**.
2829

2930
### Preset Servers {#preset-servers}
Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
---
2+
title: "Maia Plan Mode"
3+
linktitle: "Plan Mode"
4+
url: /refguide/maia-plan-mode/
5+
weight: 95
6+
description: "Describes how to use the planning features in Maia agent."
7+
---
8+
9+
## Introduction
10+
11+
{{% alert color="info" %}}
12+
This feature is part of [Maia Make](/refguide/maia-make/) and was introduced in Studio Pro 11.16.
13+
14+
To use Plan Mode, you need an internet connection and must be signed in to Studio Pro. This feature is not available when using the Studio Pro MCP server mode. Instead, you should use the native planning features of the agent that connects to Studio Pro.
15+
{{% /alert %}}
16+
17+
Maia Plan Mode helps you plan the implementation of an entire app or a large feature before making changes. Maia creates a plan that you can review and edit before starting implementation.
18+
19+
You can also use the plan to track progress and continue implementation in a new chat session.
20+
21+
## Creating a Plan
22+
23+
When you ask Maia to implement an entire app or a large feature that spans several documents or modules, it asks whether you want to enter Plan Mode.
24+
25+
If you agree, Maia reads the open app, gathers the context needed for your request, and writes an implementation plan. In Plan Mode, Maia can only read the open app and write a plan document.
26+
27+
The plan is stored as a Markdown file in `maia/plans/<plan-name>/plan.md` in your application directory.
28+
29+
## Reviewing and Implementing a Plan
30+
31+
After creating a plan, Maia asks you to review it. To review the plan and start implementation, follow these steps:
32+
33+
1. In the **App Explorer**, expand **App** > **Maia** > **Plans** and select the plan.
34+
2. Review the plan and make any necessary changes, either manually or by asking Maia. Save any manual changes before proceeding.
35+
3. When you are satisfied with the plan, confirm Maia's request to exit Plan Mode and start implementation.
36+
37+
## Tracking Progress
38+
39+
The plan remains available in your application after Maia implements part or all of it. To pause implementation and continue in a new session, follow these steps:
40+
41+
1. Stop Maia during implementation.
42+
2. Ask Maia to record the progress made in the plan.
43+
3. Start a new chat session and ask Maia to continue implementing the plan.
44+
45+
## Manually Entering Plan Mode
46+
47+
Maia's chat interface now includes the **Plan Mode** button, which you can click to enter Plan Mode manually. This signals to Maia that you are planning to implement a larger feature. While in Plan Mode, Maia can read your app and create an implementation plan.
48+
49+
{{< figure src="/attachments/refguide/mendix-ai-assistance/maia-make/maia-plan-mode/maia-plan-mode.png" width="400" >}}
50+
51+
## Limitations
52+
53+
* Only Maia can create plans. You can edit a plan after Maia creates it.
54+
* Maia cannot delete plans, so plans must be deleted manually.
55+
56+
## Read More
57+
58+
* [Maia Make Capabilities](/refguide/maia-make/)
59+
* [Mendix AI Assistance (Maia)](/refguide/mendix-ai-assistance/)
60+
* [Maia Chat](/refguide/maia-chat/)
61+
* [AI-native SDLC Playbook](https://claude.com/resources/articles/the-ai-native-sdlc-playbook)

‎content/en/docs/refguide/modeling/menus/view-menu/_index.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -123,9 +123,9 @@ For details on using Mendix Marketplace components in your app modeling, see [Ho
123123
In Studio Pro 11.14 and below, this tab is called **MCP Settings**.
124124
{{% /alert %}}
125125

126-
The **Maia Settings** pane allows you to connect Maia to External Model Context Protocol (MCP) servers. For Studio Pro 11.15 and above, this pane also stores [Agent Skills (SKILLS.md)](/refguide/maia-agent-skills/).
126+
The **Maia Settings** pane allows you to connect Maia to External Model Context Protocol (MCP) servers. For more information, see [Maia MCP Client](/refguide/maia-mcp/).
127127

128-
For more information, see [Maia MCP Client](/refguide/maia-mcp/).
128+
For Studio Pro 11.15 and above, this pane also stores [Agent Skills (SKILLS.md)](/refguide/maia-agent-skills/). For Studio Pro 11.16 and above, you can view and manage all tool permissions, such as Web Fetch and MCP Tools.
129129

130130
### OpenAPI Documentation {#api-documentation}
131131

-33.5 KB
Loading
19.3 KB
Loading

0 commit comments

Comments
 (0)