diff --git a/content/en/docs/apidocs-mxsdk/apidocs/deployment/backups-api-v2.md b/content/en/docs/apidocs-mxsdk/apidocs/deployment/backups-api-v2.md index 8ea4cc38fb9..fa478d6d9e6 100644 --- a/content/en/docs/apidocs-mxsdk/apidocs/deployment/backups-api-v2.md +++ b/content/en/docs/apidocs-mxsdk/apidocs/deployment/backups-api-v2.md @@ -68,7 +68,7 @@ To perform an action via the Backups API, you need **Backups Access** and **API To download a backup of your data, do as follows: -1. Make sure that you have an API key or a PAT, and the **API Access** and **Backups** permissions. +1. Make sure that you have an API key and the **API Access** and **Backups** permissions. 2. If the snapshot already exists, find the [snapshot ID](/developerportal/operate/backups/#backups-details). diff --git a/content/en/docs/community-tools/contribute-to-mendix-docs/style-guide/product-naming-guide.md b/content/en/docs/community-tools/contribute-to-mendix-docs/style-guide/product-naming-guide.md index 158196d396e..00b9599e7c4 100644 --- a/content/en/docs/community-tools/contribute-to-mendix-docs/style-guide/product-naming-guide.md +++ b/content/en/docs/community-tools/contribute-to-mendix-docs/style-guide/product-naming-guide.md @@ -246,7 +246,7 @@ For specific Maia features, use the feature name directly: Logic Recommender, Wo It is okay to include "Maia" as part of the feature name if it is introduced for the first time or if no near context about Maia is given: Maia Logic Recommender, Maia Workflow Recommender, Maia Translation Generator, for instance. -As of Studio Pro 11.8, Maia Make replaces Maia's individual features. Refer to "Maia" or "Maia Make" as a set of capabilities. Do not refer to older individual tools, such as "Maia Chat", "Maia for Domain Models", or "Maia for Pages" unless referring to Studio Pro 11.7 and below. +Maia Chat is an exception: use "Maia Chat" instead of "Chat". Only use "Chat" in very rare cases: as a page title in the left navigation menu under the [Mendix AI Assistance (Maia)](/refguide/mendix-ai-assistance/) category. Capitalize in all instances. diff --git a/content/en/docs/deployment/mendix-cloud-deploy/deploy-apis-with-ai-agents.md b/content/en/docs/deployment/mendix-cloud-deploy/deploy-apis-with-ai-agents.md index 3296e9145e0..5a487676294 100644 --- a/content/en/docs/deployment/mendix-cloud-deploy/deploy-apis-with-ai-agents.md +++ b/content/en/docs/deployment/mendix-cloud-deploy/deploy-apis-with-ai-agents.md @@ -13,7 +13,7 @@ description: "Describes how to connect AI coding assistants to Mendix Cloud usin For example, you can ask the AI assistant to list your apps, deploy the latest package to an acceptance environment, or stop a production environment, without writing `curl` commands or navigating the Mendix Portal. {{% alert color="warning" %}} -The use of AI tools is non-deterministic, outputs may vary between runs. AI Assistants/Agents will have permissions based on what the Personal Access Token (PAT) has access to. Through the [Backups API](/apidocs-mxsdk/apidocs/backups-api/) and [Logs](/developerportal/operate/logs/), they may have access to production environments and Personally Identifiable Information (PII) contained within your environments. Carefully review and limit the scope of credentials before use. +The use of AI tools is non-deterministic, outputs may vary between runs. AI Assistants/Agents will have permissions based on what the API Key and Personal Access Token (PAT) have access to. Through the [Backups API](/apidocs-mxsdk/apidocs/backups-api/) and [Logs](/developerportal/operate/logs/), they may have access to production environments and Personally Identifiable Information (PII) contained within your environments. Carefully review and limit the scope of credentials before use. {{% /alert %}} ## Prerequisites @@ -21,7 +21,9 @@ The use of AI tools is non-deterministic, outputs may vary between runs. AI Assi Before you start, make sure you have the following: * An MCP-compatible AI client that supports custom request headers, such as Claude Code or VS Code with GitHub Copilot +* A Mendix account with API access enabled * A [Personal Access Token (PAT)](/portal/user-settings/#pat) with the `mx:deployment:write` and `mx:deployment:read` scopes selected +* A [Mendix API key](/portal/user-settings/#profile-api-keys) ## Connecting Your AI Assistant {#connecting} @@ -32,10 +34,16 @@ To add the Mendix MCP server in Claude Code, run the following command in your t ```bash claude mcp add --scope user --transport http mendix-cloud-mcp \ https://mcp.home.mendix.com/ \ ---header "Authorization: MxToken {GENERATED_PAT}" +--header "Authorization: MxToken {GENERATED_PAT}" \ +--header "Mendix-Username: {Mendix-Username}" \ +--header "Mendix-ApiKey: {Mendix-ApiKey}" ``` -Replace `{GENERATED_PAT}` with your Mendix Personal Access Token (PAT). +Replace the following placeholders with your credentials: + +* `{GENERATED_PAT}` – the generated Mendix Personal Access Token (PAT) +* `{Mendix-Username}` – the login name of the user making the request, with the required privileges in the Mendix Platform +* `{Mendix-ApiKey}` – the API key associated with that user To verify the connection, run the following command: @@ -54,6 +62,8 @@ mendix-cloud-mcp: URL: https://mcp.home.mendix.com/ Headers: Authorization: MxToken {GENERATED_PAT} + Mendix-Username: {Mendix-Username} + Mendix-ApiKey: {Mendix-ApiKey} To remove this server, run: claude mcp remove mendix-cloud-mcp -s user ``` @@ -70,7 +80,9 @@ To add the Mendix MCP server in VS Code, add the following configuration to your "type":"http", "url":"https://mcp.home.mendix.com/", "headers":{ - "Authorization":"MxToken {GENERATED_PAT}" + "Authorization":"MxToken {GENERATED_PAT}", + "Mendix-Username":"{Mendix-Username}", + "Mendix-ApiKey":"{Mendix-ApiKey}" } } } @@ -78,7 +90,7 @@ To add the Mendix MCP server in VS Code, add the following configuration to your } ``` -Replace `{GENERATED_PAT}` with your Mendix Personal Access Token (PAT). +Replace the placeholder values with your credentials as described in the [Claude Code](#claude-code) section above. ## Available Capabilities {#capabilities} @@ -137,10 +149,15 @@ Once connected, your AI assistant has access to the following capabilities. Your credentials are passed directly to the Mendix APIs and are not stored or inspected by the MCP gateway. Each user authenticates using their own credentials. -All APIs, including the Deploy API, Build API, Backups API, and App Permissions, use the `Authorization: MxToken {GENERATED_PAT}` header. +Two authentication methods are used depending on the API: + +| API Version | Headers Required | +| --- | --- | +| Deploy API v4, App Permissions | `Authorization: MxToken {GENERATED_PAT}` | +| Deploy API v1/v2, Build API, Backups API | `Mendix-Username` and `Mendix-ApiKey` | {{% alert color="info" %}} -Include the `Authorization` header in your connection configuration to ensure all tools work correctly. +Include all three headers in your connection configuration to ensure all tools work correctly. {{% /alert %}} ## Client Compatibility {#compatibility} @@ -148,7 +165,7 @@ Include the `Authorization` header in your connection configuration to ensure al The Mendix MCP integration works with any MCP-compatible client that supports HTTP transport (streamable HTTP) and custom headers for authentication. {{% alert color="warning" %}} -Clients that only support OAuth 2.0 authentication without custom header support are not compatible with the Mendix Cloud MCP integration, as Mendix APIs use token-based authentication. +Clients that only support OAuth 2.0 authentication without custom header support are not compatible with the Mendix Cloud MCP integration, as Mendix APIs use token and API key-based authentication. {{% /alert %}} ## Known Limitations {#limitations} @@ -170,7 +187,7 @@ The following limitations apply: ### 401 Unauthorized -Your credentials are incorrect or have expired. Regenerate your PAT. +Your credentials are incorrect or have expired. Regenerate your PAT and verify that your API key is still active. ### 403 Forbidden @@ -184,7 +201,9 @@ Your MCP client is not sending the correct `Accept` header. This happens when yo claude mcp remove mendix-cloud-mcp claude mcp add --scope user --transport http mendix-cloud-mcp \ https://mcp.home.mendix.com/ \ ---header "Authorization: MxToken {GENERATED_PAT}" +--header "Authorization: MxToken {GENERATED_PAT}" \ +--header "Mendix-Username: {Mendix-Username}" \ +--header "Mendix-ApiKey: {Mendix-ApiKey}" ``` ### Tools Not Showing Up diff --git a/content/en/docs/deployment/mendix-cloud-deploy/maia-operate/_index.md b/content/en/docs/deployment/mendix-cloud-deploy/maia-operate/_index.md index fbed244431a..1d2e1eca318 100644 --- a/content/en/docs/deployment/mendix-cloud-deploy/maia-operate/_index.md +++ b/content/en/docs/deployment/mendix-cloud-deploy/maia-operate/_index.md @@ -9,8 +9,8 @@ description_list: true ## Introduction -Operating a production application requires continuous monitoring of its health and behavior, including reviewing logs, investigating errors, and understanding application activity over time. Maia Operate simplifies these tasks by using data already available in Mendix Cloud to provide AI-powered insights into your running application. It helps you resolve incidents faster and spend less time on investigation and routine operational work. +Operating a production application requires continuous monitoring of its health and behavior. This often involves reviewing logs, investigating errors, and understanding application activity over time. -Maia Operate covers the operation stage of the application lifecycle. Insights from operating your app can become input for the next iteration, which you can plan in Mendix Portal and build in Studio Pro with Maia. For an overview of how Maia supports each stage, see [Maia Across the Development Lifecycle](/refguide/maia-development-lifecycle/). +Maia Operate simplifies these operational tasks by using data already available in Mendix Cloud to provide AI-powered insights into your running application. It helps you resolve incidents more quickly, reduce investigation time, and spend less effort on routine operational work. ## Documents in This Category diff --git a/content/en/docs/developerportal/maia-plan/_index.md b/content/en/docs/developerportal/maia-plan/_index.md index fd8eee84f6f..002374fe8c4 100644 --- a/content/en/docs/developerportal/maia-plan/_index.md +++ b/content/en/docs/developerportal/maia-plan/_index.md @@ -13,6 +13,4 @@ Maia Plan helps you create a detailed project plan, based on which you can then {{< figure src="/attachments/developerportal/maia/maia-create-app.png" alt="Plan and build with Maia entry point" max-width=50% >}} -Maia Plan covers the planning stage of the application lifecycle. You can use the stories from the plan as input when building your app in Studio Pro with Maia Make, or have external AI agents read the plan through [Maia Plan as MCP Server](/developerportal/maia-plan-mcp/). For an overview of how Maia supports each stage, see [Maia Across the Development Lifecycle](/refguide/maia-development-lifecycle/). - ## Documents in This Category diff --git a/content/en/docs/marketplace/marketplace-home-page.md b/content/en/docs/marketplace/marketplace-home-page.md index fa40ecdaabc..3e96daffed6 100644 --- a/content/en/docs/marketplace/marketplace-home-page.md +++ b/content/en/docs/marketplace/marketplace-home-page.md @@ -145,6 +145,7 @@ This table breaks down the roles and permissions for content groups: | Group Admin | ✘ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | | Group Member | ✘ | ✘ | ✘ | ✔ | ✔ | ✔ | ✔ | | Organization member (not part of any group) | ✘ | ✘ | ✘ | ✘ | ✔ | ✔ | ✘ | +| Guest | ✘ | ✘ | ✘ | ✘ | ✔ | ✘ | ✘ | | Developer (not part of any group) | ✘ | ✘ | ✘ | ✔ | ✔ | ✔ | ✔ | ### Content Tab {#group-content} diff --git a/content/en/docs/mendix-portal/maia-portal.md b/content/en/docs/mendix-portal/maia-portal.md index dcfa0398f75..f40a437ff92 100644 --- a/content/en/docs/mendix-portal/maia-portal.md +++ b/content/en/docs/mendix-portal/maia-portal.md @@ -11,9 +11,7 @@ aliases: Mendix AI Assistance (Maia) refers to Mendix Platform capabilities that leverage [artificial intelligence (AI)](https://www.mendix.com/glossary/artificial-intelligence-ai/) and [machine learning (ML)](https://www.mendix.com/glossary/machine-learning/) to assist developers in application development. Maia is designed to help development teams in modeling and delivering Mendix applications faster, more consistently, and with higher quality. -{{< figure src="/attachments/developerportal/global-nav/maia-mendix-portal.jpg" alt="Maia in Mendix Portal" width="500" >}} - -Maia in Mendix Portal supports the planning, collaboration, and feedback stages of the application lifecycle. For example, you can use Maia Plan to define the scope of a new app, then continue in Studio Pro with Maia Make to build it. For an overview of how Maia supports each stage, see [Maia Across the Development Lifecycle](/refguide/maia-development-lifecycle/). +{{< figure src="/attachments/developerportal/global-nav/maia-mendix-portal.jpg" width="500" >}} ## Maia Capabilities in Mendix Portal @@ -51,7 +49,7 @@ Maia Chat does not use any project, customer, or company information. It only us Maia Chat is a built-in chat interface in the Mendix Platform powered by Generative AI. Developers can ask questions about all aspects of Mendix, including how to apply concepts, best practices, governance tools, and development patterns. -Maia Chat is also available in Studio Pro 10.12.0 to 11.7. In Studio Pro 11.8 and above, Maia Chat is part of Maia Make, where you can ask questions directly to Maia in the **Chat** tab. For more information, see [Chat with Maia](/refguide/maia-chat/). +Maia Chat is also available in Studio Pro 10.12.0 and above. See [Maia Chat](/refguide/maia-chat/) for more information. For information on Mendix data storage policies and practices for Maia, see [Maia Privacy Policy](https://www.mendix.com/legal/privacy/maia/). diff --git a/content/en/docs/private-platform/pmp-maia.md b/content/en/docs/private-platform/pmp-maia.md index d53f4351278..879259d290c 100644 --- a/content/en/docs/private-platform/pmp-maia.md +++ b/content/en/docs/private-platform/pmp-maia.md @@ -9,8 +9,6 @@ weight: 51 Mendix AI Assistance (Maia) refers to Mendix Platform capabilities that leverage [artificial intelligence (AI)](https://www.mendix.com/glossary/artificial-intelligence-ai/) and [machine learning (ML)](https://www.mendix.com/glossary/machine-learning/) to assist developers in application development. Maia is designed to help development teams in modeling and delivering Mendix applications faster, more consistently, and with higher quality. -For an overview of how Maia supports each stage of the application lifecycle, see [Maia Across the Development Lifecycle](/refguide/maia-development-lifecycle/). Not all capabilities on that page are available in Private Mendix Platform. The following section lists the capabilities that are supported. - ## Maia Capabilities in Private Mendix Platform Mendix AI Assistance (Maia) in Private Mendix Platform has the following capabilities: @@ -18,7 +16,7 @@ Mendix AI Assistance (Maia) in Private Mendix Platform has the following capabil 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 agentic 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, such as a new domain model, pages, and microflows. You can also ask it to explain documents for you, including your app logic and pages. For more information, see [Maia Make Capabilities](/refguide/maia-make/). +* **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, such as a new domain model, pages, and microflows. You can also ask it to explain documents for you, including your app logic and pages. For more information, see [Maia Make Capabilities](/refguide/maia-make/). Recommenders: @@ -28,15 +26,15 @@ Recommenders: Generators: -* **Domain Models in Maia Make** – helps you generate new [domain models](/refguide/domain-model/), and explain and provide suggestions for existing domain models. For more information, see [Domain Models in Maia Make](/refguide/maia-for-domain-model/). +* **Maia for Domain Model** – helps you generate new [domain models](/refguide/domain-model/), and explain and provide suggestions for existing domain models. For more information, see [Maia for Domain Model](/refguide/maia-for-domain-model/). For Private Mendix Platform, this feature is supported for version 11.6 and newer. -* **Pages in Maia Make** – helps you generate a [page](/refguide/page/). It helps you add and configure widgets based on a text input and an optional image. After a page is generated, you can continue in the same session to ask Maia for further improvements and explanations. For more information, see [Pages in Maia Make](/refguide/maia-for-pages/). +* **Maia for Pages** – helps you generate a [page](/refguide/page/). It helps you add and configure widgets based on a text input and an optional image. After a page is generated, you can continue in the same session to ask Maia for further improvements and explanations. For more information, see [Maia for Pages](/refguide/maia-for-pages/). For Private Mendix Platform, this feature is supported for version 11.6 and newer. -* **Workflows in Maia Make** – helps you generate a [Workflow](/refguide/workflows/). By providing a use case via text input or an image, Maia can help you start creating your workflows. For more information, see [Workflows in Maia Make](/refguide/maia-for-workflows/). +* **Maia for Workflows** – helps you generate a [Workflow](/refguide/workflows/). By providing a use case via text input or an image, Maia can help you start creating your workflows. For more information, see [Maia for Workflows](/refguide/maia-for-workflows/). * **Validation Assist** – helps you build validation microflows in a more automated way using pre-built expressions. For more information, see [Validation Assist](/refguide/validation-assist/). ## Changing the LLM Provider for Maia @@ -61,9 +59,9 @@ The following table shows which Maia capabilities are supported by various model | Maia Capability | AWS Bedrock | Anthropic | Azure | OpenAI | | --- | --- | --- | --- | --- | -| **Pages in Maia Make** | Full support | Full support | Simple requests only | Simple requests only | -| **Domain Models in Maia Make** | Full support | Full support | Full support | Full support | -| **Workflows in Maia Make** | Full support | Full support | Simple requests only | Does not support workflow creation | +| **Maia for Pages** | Full support | Full support | Simple requests only | Simple requests only | +| **Maia for Domain Model** | Full support | Full support | Full support | Full support | +| **Maia for Workflows** | Full support | Full support | Simple requests only | Does not support workflow creation | | **Start with Maia** | Full support | Full support | Full support | Full support | | **Best Practice Recommender** | Full support | Full support | Full support | Full support | | **UI Recommender** | Full support | Full support | Full support | Full support | diff --git a/content/en/docs/private-platform/quickstart/pmp-quickstart.md b/content/en/docs/private-platform/quickstart/pmp-quickstart.md index c21ed573bc5..106e2c63198 100644 --- a/content/en/docs/private-platform/quickstart/pmp-quickstart.md +++ b/content/en/docs/private-platform/quickstart/pmp-quickstart.md @@ -545,7 +545,7 @@ Install the Private Mendix Platform by doing the following steps: ## Installing Maia for the Private Mendix Platform {#maia} -[Mendix AI Assistance (Maia)](/refguide/mendix-ai-assistance/) refers to Mendix Platform capabilities that leverage [artificial intelligence (AI)](https://www.mendix.com/glossary/artificial-intelligence-ai/) and [machine learning (ML)](https://www.mendix.com/glossary/machine-learning/) to assist developers in application development. Private Mendix Platform currently offers support for Maia-assisted app creation. Other Maia capabilities will be made available in future releases. +[Mendix AI Assistance (Maia)](/refguide/mendix-ai-assistance/) refers to Mendix Platform capabilities that leverage [artificial intelligence (AI)](https://www.mendix.com/glossary/artificial-intelligence-ai/) and [machine learning (ML)](https://www.mendix.com/glossary/machine-learning/) to assist developers in application development. Private Mendix Platform currently offers support for Maia-assisted app creation. Other Maia capabilities, such as Maia Chat, will be made available in future releases. To enable [Maia for Private Mendix Platform](/private-mendix-platform/maia/), perform the following steps: diff --git a/content/en/docs/quickstarts/responsive-web-app.md b/content/en/docs/quickstarts/responsive-web-app.md index 0aeac9317b1..6be56b5e7d5 100644 --- a/content/en/docs/quickstarts/responsive-web-app.md +++ b/content/en/docs/quickstarts/responsive-web-app.md @@ -88,11 +88,11 @@ The top bar includes several key elements: **At the center of the screen** is the **working area**, where you'll see the currently open document tab. It's the main space within the IDE where you design, model, and configure application components visually. Think of it as the code editor in a text-based programming IDE. {{% alert type="info" %}} -When you launch **Studio Pro** for the first time, you’ll see the **Welcome** tab. From here, you can access: +When you launch **Studio Pro** for the first time, you’ll see the **Welcom** tab. From here, you can access: * [Maia Learn](/refguide/maia-learn/) – learning materials to help you get started -* [Maia Make](/refguide/maia-make/) – a group of agentic development capabilities in Studio Pro where you can describe your app requirements and get quick answers, support, and guidance in one conversation +* [Maia Chat](/refguide/maia-chat/) – an AI-powered assistant for quick support and guidance We recommend watching the introduction videos to get familiar with the basic concepts of Mendix development before you start building your app. {{% /alert %}} @@ -145,11 +145,11 @@ You have created a new persistable entity called **Employee**. This means the en {{< figure src="/attachments/quickstarts/part1/7.2 CreateAttributes.png" width="450px" alt="Create attributes on an entity">}} {{% alert type="info" %}} -You can also create a domain model by describing your application to Maia. Maia generates the domain model based on your input. For more information, see [Domain Models in Maia Make](/refguide/maia-for-domain-model/). +You can create a domain model by simply describing your application using [Maia for Domain Model](/refguide/maia-for-domain-model/) an AI-powered tool that generates domain models based on your input. -To use it in Studio Pro 11.8 and above, open the **View** menu and select the **Maia** pane, then describe your application in the chat. In Studio Pro 11.7 and below, click **Maia for Domain Model** in the **Working Area**, then describe your application in the chat box on the right. +To use it, **click Maia for Domain Model** in the **Working Area**, then describe your application in the chat box on the right. -In this case, you can ask Maia: “Create a domain model that stores employee information: first name, last name, job role, and employee ID.” +In our case, you can ask Maia: “Create a domain model that stores employee information: first name, last name, job role, and employee ID.” {{% /alert %}} ### Add an Association @@ -258,9 +258,9 @@ To deploy your app to the Mendix Cloud (Paid), there are multiple options for ho Throughout this guide, you built your **Employee** app by hand—dragging entities onto the canvas, wiring up buttons, and writing microflow logic step by step. That is a great way to learn how Studio Pro works under the hood. But once you are comfortable with the basics, you do not have to do everything manually. Maia, Mendix's built-in AI assistant, can take over much of this repetitive modeling work for you. -Unlike a traditional chatbot that only answers questions, Maia is agentic: it can use your app's existing domain model, pages, and logic as context to create or modify elements directly in Studio Pro. Through [Maia Make](/refguide/maia-make/), you can describe what you want in plain language, and Maia generates artifacts such as domain models, pages, microflows, workflows, and OQL queries. In the same conversation, you can ask development questions or use [Maia Explain](/refguide/maia-explain/) to understand existing functionality without changing your app. +Unlike a typical chatbot that only answers questions, Maia is agentic: it can read your app's current domain model, pages, and logic, understand the context you are working in, and then directly create or modify app elements on your behalf. Ask it to add an entity, generate a page, or build out a microflow, and it will produce real, editable Studio Pro artifacts—not just a suggestion or a code snippet for you to copy in. -Studio Pro also includes recommenders that the next best widget or microflow activity as you build. For more advanced use cases, [Maia Agent Skills](/refguide/maia-agent-skills/) and [Agent Instructions](/refguide/maia-agent-instructions/) let you tailor Maia to your team's conventions, helping it produce suggestions that align with how your organization builds apps. +Maia is not one single feature but a collection of capabilities woven into Studio Pro. [Maia Make](/refguide/mendix-ai-assistance/), is a conversational interface where you describe what you want in plain language and Maia generates the domain model changes, pages, or microflows to match. Within Maia Make are focused generators (for domain models, pages, workflows, and OQL queries), recommenders that suggest the next best widget or microflow activity as you build, and guidance tools like [Maia Chat](/refguide/maia-chat/) and [Maia Explain](/refguide/mendix-ai-assistance/) for when you want an explanation rather than a change to your app. As you grow more advanced, [Maia Agent Skills](/refguide/maia-agent-skills/) and Agent Instructions let you teach Maia your team's own conventions so Maia's suggestions stay consistent with how your organization builds apps. ### Try It Yourself: Extending the Employee App diff --git a/content/en/docs/refguide/general/studio-pro-overview/keyboard-shortcuts.md b/content/en/docs/refguide/general/studio-pro-overview/keyboard-shortcuts.md index 26830a4c3a3..2b6ae960d24 100644 --- a/content/en/docs/refguide/general/studio-pro-overview/keyboard-shortcuts.md +++ b/content/en/docs/refguide/general/studio-pro-overview/keyboard-shortcuts.md @@ -206,9 +206,9 @@ The following shortcut keys are assigned to menu actions that can be used in all | Ctrl + Shift + W | Command + Shift + W | Closes all document tabs. | | Delete | Delete | Deletes the selected element. | -## Maia Shortcut Keys {#maia-chat-shortcuts} +## Maia Chat Shortcut Keys {#maia-chat-shortcuts} -You can use the following shortcut keys in [Maia](/refguide/maia-make/) in the **Chat** tab. In Studio Pro 11.7 and below, these shortcuts work in [Maia Chat](/refguide/maia-chat/), including on the feedback page: +You can use the following shortcut keys in [Maia Chat](/refguide/maia-chat/), including on the feedback page: | Windows | Mac | Description | | --- | --- | --- | diff --git a/content/en/docs/refguide/mendix-ai-assistance/_index.md b/content/en/docs/refguide/mendix-ai-assistance/_index.md index 1870da51fbe..7fb3a0de091 100644 --- a/content/en/docs/refguide/mendix-ai-assistance/_index.md +++ b/content/en/docs/refguide/mendix-ai-assistance/_index.md @@ -2,25 +2,16 @@ title: "Mendix AI Assistance (Maia)" url: /refguide/mendix-ai-assistance/ weight: 17 -description: "Describes Mendix AI Assistance (Maia), the agentic development capability that supports you across the application lifecycle in Mendix Portal, Studio Pro, and Mendix Cloud." +description: "Describes Mendix AI Assistance (Maia) in Studio Pro." aliases: - /refguide/mx-assist-studio-pro/ --- ## Introduction -Mendix AI Assistance (Maia) is the agentic development capability of the Mendix Platform. With agentic development, you give an agent a development goal, and the agent carries out the work by determining which documents to create or change, using tools, and asking clarifying questions when it needs more information. You direct the work and review the result. Maia supports you in this way across the full application lifecycle, from learning and planning, through modeling and building, to quality improvement, operation, and the ongoing evolution of your app. +Mendix AI Assistance (Maia) refers to Mendix Platform capabilities that leverage [artificial intelligence (AI)](https://www.mendix.com/glossary/artificial-intelligence-ai/) and [machine learning (ML)](https://www.mendix.com/glossary/machine-learning/) to assist developers in application development. Maia is designed to help development teams in modeling and delivering Mendix applications faster, more consistently, and with higher quality. -Maia is not a single feature. It is a set of capabilities that share one foundation: the Mendix app model. A Mendix app consists of model documents, such as domain models, pages, microflows, and workflows. Maia reads and changes these same documents. For example, when Maia generates a microflow, the result is a regular microflow that you can open, inspect, and change in Studio Pro, just like a microflow that you model yourself. - -This foundation has the following practical results for you as a developer: - -* Maia works with your app as context when generating content. For example, when Maia generates a page, it knows the domain model of the module you are working in. You can also add specific documents to the conversation to give Maia more context. -* Maia creates and updates documents directly in the regular Studio Pro editors. Studio Pro checks these documents for consistency errors just as it does with documents you create yourself. -* You stay in control of the development process. You decide what Maia builds, review the changes, and undo them if needed. When you are satisfied with the result, you commit the changes to version control. -* You can extend Maia with your own conventions, connect external tools, use your own AI provider, or use your own agent with Studio Pro. Agent instructions and agent skills follow industry standards, so they work with any agentic tool. - -Maia works with professional developers; it does not replace them. Maia takes on tasks such as creating a first version of a document, applying conventions, explaining existing logic, and detecting anti-patterns. You keep ownership of the requirements, the architecture, and the quality of your app. For more information on this approach, see [Agentic and Model-Driven Development](/refguide/agentic-development/). +Mendix developers can use Maia to get guidance by asking questions, get recommendation and assistance for certain development tasks, and even generate part of their app. Maia does not use any project, customer, company, or user-entered data for model training. Maia operates on pre-trained, off-the-shelf large language models (LLMs). For more information on Mendix data storage policies and practices for Maia, see [Maia Privacy Policy](https://www.mendix.com/legal/privacy/maia/). @@ -34,144 +25,80 @@ For information on what third-party services Maia uses and what data are sent to For more information on how to ensure optimal performance of Maia, see the [Best Practice for Maia Performance](#maia-performance-best-practice) section below. -## Maia Across the Application Lifecycle {#lifecycle} - -Maia is available at each stage of the application lifecycle. In Studio Pro, Maia Make is the single chat interface for all build stages: in one conversation, you can create and change any part of your model, such as data, logic, UI, workflows, and translations, and ask for guidance. The table below gives an overview. For a detailed description of each stage, including example prompts, see [Maia Across the Development Lifecycle](/refguide/maia-development-lifecycle/). - -| Lifecycle Stage | How Maia Helps | Capabilities | -| --- | --- | --- | -| Discover and learn | Explains Mendix concepts and answers development questions. |