Skip to content

Revise Maia Make docs - #11822

Open
quinntracy wants to merge 27 commits into
developmentfrom
qt-mmrestructure
Open

quinntracy wants to merge 27 commits into
developmentfrom
qt-mmrestructure

Conversation

@quinntracy

Copy link
Copy Markdown
Collaborator

No description provided.

@quinntracy quinntracy self-assigned this Aug 27, 2026
@quinntracy
quinntracy marked this pull request as ready for review September 1, 2026 14:16
Comment thread content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-mcp.md Outdated
Comment thread content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-web-fetch.md Outdated
Comment thread content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-web-fetch.md Outdated
Comment thread content/en/docs/refguide/mendix-ai-assistance/maia-make/studio-pro-mcp-server.md Outdated
Comment thread content/en/docs/refguide/mendix-ai-assistance/maia-make/studio-pro-mcp-server.md Outdated
Comment thread content/en/docs/refguide/mendix-ai-assistance/maia-make/studio-pro-mcp-server.md Outdated
Comment thread content/en/docs/refguide/mendix-ai-assistance/maia-make/studio-pro-mcp-server.md Outdated
Maia Make capabilities are available in Studio Pro 11.8 and above.

To use Maia Make capabilities, an internet connection and signing in to Studio Pro are required.
To use Maia Make capabilities, you need an internet connection and must be signed in to Studio Pro.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not correct. you need internet but don't need to be signed in if using BYO LLM. suggest removing the must be signed in

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

But do you need to be signed in if you are using Maia within Studio Pro (instead of configuring your own LLM)?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yes.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

but maia can also leverage BYO LLM, which then doesn't require you to be logged in. it depends on how you use it

Comment thread content/en/docs/refguide/mendix-ai-assistance/maia-make/_index.md Outdated
Comment thread content/en/docs/refguide/mendix-ai-assistance/maia-make/_index.md Outdated
Below are examples of prompts you can use to ask Maia to make further edits or request explanations and suggestions for improving a document:

* Can you explain the function and purpose of this document?
* I want to add an attribute `ATTRIBUTE_NAME` to the entity `ENTITY_NAME`.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

these are typically not the way you would prompt for generating an application. suggest to use more business oriented questions.

This feature is part of [Maia Make](/refguide/maia-make/) and was introduced in Studio Pro 11.11.

To use Agent Skills, an internet connection and signing in to Studio Pro are required.
To use Maia Agent Skills, you need an internet connection and must be signed in to Studio Pro.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

again, applies to all agents, not just maia

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we also change the title to just be "Agent Skills"?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yes

Comment thread content/en/docs/refguide/mendix-ai-assistance/maia-make/maia-agent-skills.md Outdated
weight: 75
description: "Describes the features in Maia for Microflows."
---

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

do we even need this page? It's part of what maia make does, so not even a dedicated feature. can only cause confusion IMO

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agreed that the page is not necessary, but I suggest we keep the limitation that's specific to microflows. This information could be added to the Microflows line in Maia Make Capabilities Supported Document Types.

@@ -11,20 +11,26 @@ aliases:
## Introduction

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

similar to for microflows. since part of maia make, do we need this page?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we should keep Pages because it is accessed differently in versions 11.7 and below and has quite the list of limitations that would be difficult to relocate into another doc.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants