From 7428ee576f0cd7a325937cd26466f2ebbe5ff528 Mon Sep 17 00:00:00 2001 From: Dana Breseman Date: Wed, 17 Jun 2026 12:02:58 +0200 Subject: [PATCH 1/4] Add BYO LLM section --- .../mendix-ai-assistance/maia-make/_index.md | 47 +++++++++++++++++++ 1 file changed, 47 insertions(+) diff --git a/content/en/docs/refguide/mendix-ai-assistance/maia-make/_index.md b/content/en/docs/refguide/mendix-ai-assistance/maia-make/_index.md index 6827906df8b..5b20a402e49 100644 --- a/content/en/docs/refguide/mendix-ai-assistance/maia-make/_index.md +++ b/content/en/docs/refguide/mendix-ai-assistance/maia-make/_index.md @@ -97,6 +97,53 @@ The conversational interface includes the following options: * **{{% 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. +## Configuring a Custom AI Provider {#custom-provider} + +By default, Maia uses the Mendix platform's AI service. You can configure Maia to use your own LLM provider instead (also known as bring your own LLM or BYO LLM). + +{{% alert color="info" %}} +Configuring a custom AI provider is available in Studio Pro 11.12 and above. +{{% /alert %}} + +To enable custom LLM provider configuration, follow these steps: + +1. Open the Studio Pro settings. +2. In the **Preferences** dialog box that opens, go to the **New Features** tab. +3. Select the **Enable configuring a custom AI provider for Maia** checkbox, then click **OK**. + +After enabling this feature, a **Settings** ({{% icon name="cog" %}}) icon appears in the Maia pane. + +### Provider Configuration {#provider-configuration} + +Custom AI provider settings are per-project and local to your workstation. Each app can have its own configuration, and settings are not committed to version control. + +#### Mendix Platform {#mendix-platform} + +The Mendix platform AI service is the default, recommended option and requires no configuration. Some Mendix platform optimizations may not be available if you use a custom LLM provider instead. + +#### Amazon Bedrock {#amazon-bedrock} + +To configure Amazon Bedrock as your LLM provider, follow these steps: + +1. Click **Settings** ({{% icon name="cog" %}}) in the Maia pane. +2. Select **Amazon Bedrock** from the **LLM Provider** list. +3. Select an **Authentication Mode**: + * **API Key** – Create an API key in AWS, then enter the **Base URL** and your **API Key**. Studio Pro stores the API key securely across sessions. + * **AWS Signature Version 4** – Select the **Region** and enter your AWS **Access Key ID** and **Secret Access Key**. If available, credentials are taken from your AWS CLI configuration (environment variables). If you enter credentials manually, they are not saved and must be re-entered each session. +4. Enter the **Model ID**. You can find available model IDs in your AWS Bedrock console. Mendix recommends Claude Sonnet 4.6 for optimal Maia performance. +5. Click **Save Config**. + +#### OpenAI Compatible {#openai-compatible} + +To configure an OpenAI-compatible provider, follow these steps: + +1. Click **Settings** ({{% icon name="cog" %}}) in the Maia pane. +2. Select **OpenAI Compatible** from the **LLM Provider** list. +3. Enter the **Base URL** for your API endpoint. +4. Enter the **Model ID**. +5. Enter your **API Key**. Studio Pro stores this key securely across sessions. +6. Click **Save Config**. + ## Read More * [Mendix AI Assistance (Maia)](/refguide/mendix-ai-assistance/) From fe6bee6410c60570436dda528918f3a03a256c55 Mon Sep 17 00:00:00 2001 From: Dana Breseman Date: Wed, 17 Jun 2026 12:03:12 +0200 Subject: [PATCH 2/4] Add link from fair use policy --- content/en/docs/refguide/mendix-ai-assistance/_index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/en/docs/refguide/mendix-ai-assistance/_index.md b/content/en/docs/refguide/mendix-ai-assistance/_index.md index e0ae94fe1ed..c250bf171c2 100644 --- a/content/en/docs/refguide/mendix-ai-assistance/_index.md +++ b/content/en/docs/refguide/mendix-ai-assistance/_index.md @@ -29,6 +29,8 @@ For more information on how to ensure optimal performance of Maia, see the [Best Mendix applies fair use limits to maintain a reliable experience for all users. If usage exceeds these limits, your Maia access may be temporarily paused. Account access is reviewed on a weekly schedule. Your account will be automatically reactivated within seven days once the review period concludes. +If you need uninterrupted access to Maia capabilities, you can [configure a custom AI provider](/refguide/maia-make/#custom-provider) to use your own LLM provider. + ## Network Configuration Requirements {#maia-network-requirement} To ensure the smooth operation of Mendix AI Assistance (Maia), the following network requirements must be met: From a4362bf521a8fcd677382a57626bd6fac3bf3bcd Mon Sep 17 00:00:00 2001 From: Dana Breseman Date: Wed, 17 Jun 2026 12:03:20 +0200 Subject: [PATCH 3/4] Mention BYO Agent --- .../mendix-ai-assistance/maia-make/studio-pro-mcp-server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/refguide/mendix-ai-assistance/maia-make/studio-pro-mcp-server.md b/content/en/docs/refguide/mendix-ai-assistance/maia-make/studio-pro-mcp-server.md index 09861bfe770..ddc23af2d06 100644 --- a/content/en/docs/refguide/mendix-ai-assistance/maia-make/studio-pro-mcp-server.md +++ b/content/en/docs/refguide/mendix-ai-assistance/maia-make/studio-pro-mcp-server.md @@ -15,7 +15,7 @@ This feature was released in Studio Pro 11.10. To use Studio Pro MCP Server, an internet connection and signing in to Studio Pro are required. {{% /alert %}} -Studio Pro MCP Server enables you to leverage Maia's capabilities directly from external clients, including AI coding assistants, agents, and other MCP-based LLM tools. +Studio Pro MCP Server enables bring your own agent (BYO Agent) capabilities, allowing you to leverage Maia's capabilities directly from external clients, including AI coding assistants, agents, and other MCP-based LLM tools. It has the following key highlights: From 1f057f02166e1cb75cfff716db2303c0d5a49cc3 Mon Sep 17 00:00:00 2001 From: Dana Breseman <142491015+dbreseman@users.noreply.github.com> Date: Wed, 17 Jun 2026 17:11:23 +0200 Subject: [PATCH 4/4] Apply feedback --- .../en/docs/refguide/mendix-ai-assistance/maia-make/_index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/en/docs/refguide/mendix-ai-assistance/maia-make/_index.md b/content/en/docs/refguide/mendix-ai-assistance/maia-make/_index.md index 5b20a402e49..b41388ec1ff 100644 --- a/content/en/docs/refguide/mendix-ai-assistance/maia-make/_index.md +++ b/content/en/docs/refguide/mendix-ai-assistance/maia-make/_index.md @@ -102,7 +102,7 @@ The conversational interface includes the following options: By default, Maia uses the Mendix platform's AI service. You can configure Maia to use your own LLM provider instead (also known as bring your own LLM or BYO LLM). {{% alert color="info" %}} -Configuring a custom AI provider is available in Studio Pro 11.12 and above. +Configuring a custom AI provider is available in Studio Pro 11.12 and above as a beta feature. {{% /alert %}} To enable custom LLM provider configuration, follow these steps: @@ -111,7 +111,7 @@ To enable custom LLM provider configuration, follow these steps: 2. In the **Preferences** dialog box that opens, go to the **New Features** tab. 3. Select the **Enable configuring a custom AI provider for Maia** checkbox, then click **OK**. -After enabling this feature, a **Settings** ({{% icon name="cog" %}}) icon appears in the Maia pane. +After enabling this feature, a **Settings** ({{% icon name="cog" %}}) icon appears in the upper-right corner of the Maia pane. ### Provider Configuration {#provider-configuration}