Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion content/en/docs/genai/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,6 @@ For a list of all Bedrock Models, see [Models at a glance](https://docs.aws.amaz

In addition to the models listed above, you can also connect to other models by implementing one of the following options:

* To connect to other [foundation models](https://docs.aws.amazon.com/bedrock/latest/userguide/models-features.html) and implement them in your app, use the [Amazon Bedrock connector](/appstore/modules/aws/amazon-bedrock/).
* To connect to other [foundation models](https://docs.aws.amazon.com/bedrock/latest/userguide/models-features.html) and implement them in your app, use the [Amazon Bedrock connector](/agents/reference-guide/external-connectors/bedrock/).
* To connect to [Snowflake Cortex LLM](https://docs.snowflake.com/en/sql-reference/functions/complete-snowflake-cortex) functions, [configure the Snowflake AI Data Connector for Snowflake Cortex Analyst](/appstore/connectors/snowflake/snowflake-ai-data-connector/#cortex-analyst).
* To implement your own connector that is compatible with the other components, use the [GenAI Commons](/agents/agents-kit-2/reference-guide/genai-for-mx/commons/) interface and see [How to Build Your Own GenAI Connector](/agents/agents-kit-2/how-to/byo-connector/).
4 changes: 2 additions & 2 deletions content/en/docs/genai/concepts/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ For example, you can use an LLM to do:
* Translate languages
* Simulate characters for games

Some LLMs, such as [Anthropic Claude](/appstore/modules/aws/amazon-bedrock/) and [GPT-4o](/agents/agents-kit-2/reference-guide/external-connectors/openai/), can also use one or more images as input, allowing you to ask questions about images for use cases such as object recognition, image to text (OCR), and validating whether an image is as intended.
Some LLMs, such as [Anthropic Claude](/agents/reference-guide/external-connectors/bedrock/) and [GPT-4o](/agents/agents-kit-2/reference-guide/external-connectors/openai/), can also use one or more images as input, allowing you to ask questions about images for use cases such as object recognition, image to text (OCR), and validating whether an image is as intended.

#### Embeddings Generation

Expand Down Expand Up @@ -145,4 +145,4 @@ The agent concept combines prompts, RAG (Retrieval Augmented Generation), and Re

For an overview of the components that help you get started, refer to [Agents Kit Components](/agents/agents-kit-2/#components).

In addition, you can integrate agentic behavior in a Mendix app by leveraging external agents through cloud infrastructure providers. In this case, the Mendix app does not store the agent definition. Instead, it only calls the external agent. For example, [Agents for Amazon Bedrock](https://aws.amazon.com/bedrock/agents/) provides this functionality for Amazon Bedrock. You can find out how to use this in your Mendix application in [Invoking an Agent with the InvokeAgent Operation](/appstore/modules/aws/amazon-bedrock/#invokeagent) section of the *Amazon Bedrock* module documentation.
In addition, you can integrate agentic behavior in a Mendix app by leveraging external agents through cloud infrastructure providers. In this case, the Mendix app does not store the agent definition. Instead, it only calls the external agent. For example, [Agents for Amazon Bedrock](https://aws.amazon.com/bedrock/agents/) provides this functionality for Amazon Bedrock. You can find out how to use this in your Mendix application in [Invoking an Agent with the InvokeAgent Operation](/agents/reference-guide/external-connectors/bedrock/#invokeagent) section of the *Amazon Bedrock* module documentation.
2 changes: 1 addition & 1 deletion content/en/docs/genai/concepts/tool-calling.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ Sometimes, tool calls should not be executed immediately, and should first requi

## Tool Calling with the GenAI Commons Module and the LLM Connectors {#llm-connector}

All platform-supported connectors ([Mendix Cloud GenAI](/agents/agents-kit-2/mx-cloud-genai/mxgenai-connector/), [OpenAI](/agents/agents-kit-2/reference-guide/external-connectors/openai/), and [Amazon Bedrock Connector](/appstore/modules/aws/amazon-bedrock/)) support tool calling by leveraging the [GenAI Commons module](/agents/agents-kit-2/reference-guide/genai-for-mx/commons/). Tool calling is supported for all chat completions operations. All entity, attribute, and activity names in this section refer to the GenAI Commons module.
All platform-supported connectors ([Mendix Cloud GenAI](/agents/agents-kit-2/mx-cloud-genai/mxgenai-connector/), [OpenAI](/agents/agents-kit-2/reference-guide/external-connectors/openai/), and [Amazon Bedrock Connector](/agents/reference-guide/external-connectors/bedrock/)) support tool calling by leveraging the [GenAI Commons module](/agents/agents-kit-2/reference-guide/genai-for-mx/commons/). Tool calling is supported for all chat completions operations. All entity, attribute, and activity names in this section refer to the GenAI Commons module.

Functions in Mendix are essentially microflows that can be registered within the request to the LLM​. The LLM connector takes care of handling the tool call response as well as executing the function microflows until the LLM returns the final assistant's response. Function microflows can have none, a single, or multiple primitive input parameters such as Boolean, Datetime, Decimal, Enumeration, Integer or String. Additionally, they may accept the [Request](/agents/agents-kit-2/reference-guide/genai-for-mx/commons/#request) or [Tool](/agents/agents-kit-2/reference-guide/genai-for-mx/commons/#tool) objects as inputs. The microflow can only return a String value.

Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/genai/v1/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ All connectors depend on GenAI Commons and can be used with the other [core modu

| Asset | Description | Release Version |
| --- | --- | --- |
| [Amazon Bedrock Connector](/appstore/modules/aws/amazon-bedrock/) | Connect to Amazon Bedrock. | 9.0.0 |
| [Amazon Bedrock Connector](/agents/agents-kit-1/reference-guide/external-connectors/bedrock/) | Connect to Amazon Bedrock. | 9.0.0 |
| [Google Gemini Connector](/agents/agents-kit-1/reference-guide/external-connectors/gemini/) | Connect to Google Gemini. Available in Studio Pro 10.24.13 and above. | 1.0.0 |
| [Mendix Cloud GenAI Connector](/agents/agents-kit-1/mx-cloud-genai/mxgenai-connector/) | Connect to Mendix Cloud and use Mendix Cloud GenAI resource packs directly within your Mendix application. | 5.0.0 |
| [Mistral Connector](/agents/agents-kit-1/reference-guide/external-connectors/mistral/) | Connect to Mistral AI. | 1.0.0 |
Expand Down
2 changes: 1 addition & 1 deletion content/en/docs/genai/v1/how-to/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ Generative Artificial Intelligence (GenAI) transforms business applications, emp
* The [ConversationalUI](/agents/agents-kit-1/reference-guide/genai-for-mx/conversational-ui/) module that offers UI snippets for chat, token consumption monitoring and prompt management.
* The [Mendix Cloud GenAI Resource Packs](/agents/mx-cloud-genai/resource-packs/) to learn how to quickly access GenAI capabilities from a Mendix app.
* The [OpenAI](/agents/agents-kit-1/reference-guide/external-connectors/openai/) provides essential information about the OpenAI connector.
* The [Amazon Bedrock](/appstore/modules/aws/amazon-bedrock/) provides key information about the AWS Bedrock connector.
* The [Amazon Bedrock](/agents/agents-kit-1/reference-guide/external-connectors/bedrock/) provides key information about the AWS Bedrock connector.
* The [MCP Server Module](/agents/agents-kit-1/mcp-modules/mcp-server/) provides reusable operations to create and initialize an MCP server within a Mendix app to expose tools and prompts to external clients.
* The [PGVector Knowledge Base](/agents/agents-kit-1/reference-guide/external-connectors/pgvector/) offers the option for a private knowledge base outside of the LLM infrastructure.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ Before you build an agent in your app, make sure your scenario meets the followi
## Setting Up Your Application

{{% alert color="info" %}}
This guide uses the Mendix Cloud GenAI Connector for text generation. You can also use alternative [supported connectors](/agents/agents-kit-1/#connectors), such as [Amazon Bedrock](/appstore/modules/aws/amazon-bedrock/) or [OpenAI](/agents/agents-kit-1/reference-guide/external-connectors/openai/). For knowledge base operations, this guide uses the Mendix Cloud Knowledge Base, but the [pgVector Knowledge Base](/agents/agents-kit-1/reference-guide/external-connectors/pgvector/) is also supported. As long as you configure access to a provider and knowledge base according to the connector documentation, and the knowledge base supports inserting chunks from a microflow, the remaining steps in this guide apply.
This guide uses the Mendix Cloud GenAI Connector for text generation. You can also use alternative [supported connectors](/agents/agents-kit-1/#connectors), such as [Amazon Bedrock](/agents/agents-kit-1/reference-guide/external-connectors/bedrock/) or [OpenAI](/agents/agents-kit-1/reference-guide/external-connectors/openai/). For knowledge base operations, this guide uses the Mendix Cloud Knowledge Base, but the [pgVector Knowledge Base](/agents/agents-kit-1/reference-guide/external-connectors/pgvector/) is also supported. As long as you configure access to a provider and knowledge base according to the connector documentation, and the knowledge base supports inserting chunks from a microflow, the remaining steps in this guide apply.
{{% /alert %}}

If you are using a GenAI starter app such as the Blank GenAI Starter App, you can skip ahead to [Creating the Agent's Functional Prerequisites](#creating-functional-prerequisites) because the following setup steps are completed by default. Otherwise, follow these steps to add the required modules and configuration to your app:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ Selecting the infrastructure for integrating GenAI into your Mendix application

* [OpenAI](/agents/agents-kit-1/reference-guide/external-connectors/openai/): The [OpenAI Connector](https://marketplace.mendix.com/link/component/220472) supports both OpenAI's platform and Microsoft Foundry.

* [Amazon Bedrock](/appstore/modules/aws/amazon-bedrock/): The [Amazon Bedrock Connector](https://marketplace.mendix.com/link/component/215042) allows you to leverage Amazon Bedrock’s fully managed service to integrate foundation models from Amazon and leading AI providers.
* [Amazon Bedrock](/agents/agents-kit-1/reference-guide/external-connectors/bedrock/): The [Amazon Bedrock Connector](https://marketplace.mendix.com/link/component/215042) allows you to leverage Amazon Bedrock’s fully managed service to integrate foundation models from Amazon and leading AI providers.

* Your Own Connector: Optionally, if you prefer a custom connector, you can integrate your chosen infrastructure. However, this document focuses on the Mendix Cloud GenAI, OpenAI, and Amazon Bedrock connectors, as they offer comprehensive support and ease of use to get started.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ If you are using a GenAI starter app such as the Blank GenAI app, you can skip a
To enable generative AI capabilities, install and configure the [Mendix Cloud GenAI Connector](/agents/agents-kit-1/mx-cloud-genai/mxgenai-connector/) and its dependencies from Mendix Marketplace. If you are using a GenAI starter app such as the Blank GenAI app, you can skip the installation and just follow the [configuration instructions](/agents/agents-kit-1/mx-cloud-genai/mxgenai-connector/#configuration).

{{% alert color="info" %}}
This example uses the Mendix Cloud GenAI Connector. Alternatively, you can install and configure an [external connector](/agents/agents-kit-1/reference-guide/connectors/) for any provider with a connector that is compatible with [GenAICommons](/agents/agents-kit-1/reference-guide/genai-for-mx/commons/). This includes [OpenAI](/agents/agents-kit-1/reference-guide/external-connectors/openai/) and [Amazon Bedrock](/appstore/modules/aws/amazon-bedrock/).
This example uses the Mendix Cloud GenAI Connector. Alternatively, you can install and configure an [external connector](/agents/agents-kit-1/reference-guide/connectors/) for any provider with a connector that is compatible with [GenAICommons](/agents/agents-kit-1/reference-guide/genai-for-mx/commons/). This includes [OpenAI](/agents/agents-kit-1/reference-guide/external-connectors/openai/) and [Amazon Bedrock](/agents/agents-kit-1/reference-guide/external-connectors/bedrock/).
{{% /alert %}}

## Verifying Setup {#verification}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ Selecting the infrastructure for integrating GenAI into your Mendix application

* [OpenAI](/agents/agents-kit-1/reference-guide/external-connectors/openai/): The [OpenAI Connector](https://marketplace.mendix.com/link/component/220472) supports OpenAI's platform and Microsoft Foundry.

* [Amazon Bedrock](/appstore/modules/aws/amazon-bedrock/): The [Amazon Bedrock Connector](https://marketplace.mendix.com/link/component/215042) allows you to leverage Amazon Bedrock’s fully managed service to integrate foundation models from Amazon and leading AI providers.
* [Amazon Bedrock](/agents/agents-kit-1/reference-guide/external-connectors/bedrock/): The [Amazon Bedrock Connector](https://marketplace.mendix.com/link/component/215042) allows you to leverage Amazon Bedrock’s fully managed service to integrate foundation models from Amazon and leading AI providers.

* Your Own Connector: Optionally, if you prefer a custom connector, you can integrate your chosen infrastructure. However, this document focuses on the platform-supported connectors, as they offer comprehensive support and ease of use to get started.

Expand Down
4 changes: 2 additions & 2 deletions content/en/docs/genai/v1/how-to/start_from_blank_app.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ Selecting the infrastructure for integrating GenAI into your Mendix application
* [Mendix Cloud GenAI Resources Packs](/agents/mx-cloud-genai/resource-packs/): The [Mendix Cloud GenAI Connector](https://marketplace.mendix.com/link/component/239449) integrates LLMs by dragging and dropping common operations from its toolbox in Studio Pro.
* [OpenAI](/agents/agents-kit-1/reference-guide/external-connectors/openai/): The [OpenAI Connector](https://marketplace.mendix.com/link/component/220472) supports both OpenAI's platform and Microsoft Foundry.

* [Amazon Bedrock](/appstore/modules/aws/amazon-bedrock/): The [Amazon Bedrock Connector](https://marketplace.mendix.com/link/component/215042) allows you to leverage Amazon Bedrock’s fully managed service to integrate foundation models from Amazon and leading AI providers.
* [Amazon Bedrock](/agents/agents-kit-1/reference-guide/external-connectors/bedrock/): The [Amazon Bedrock Connector](https://marketplace.mendix.com/link/component/215042) allows you to leverage Amazon Bedrock’s fully managed service to integrate foundation models from Amazon and leading AI providers.

* Your Own Connector: Optionally, if you prefer a custom connector, you can integrate your chosen infrastructure. However, this document focuses on the OpenAI and Bedrock connectors, as they offer comprehensive support and ease of use to get started.

Expand Down Expand Up @@ -177,7 +177,7 @@ Follow the steps below to configure Amazon Bedrock for your application:
* Click **Save & Sync Data** to ensure your changes are applied.

{{% alert color="info" %}}
If you encounter any issues while using the Amazon Bedrock connector, see the [Troubleshooting](/appstore/modules/aws/amazon-bedrock/#troubleshooting) section of the *Amazon Bedrock*.
If you encounter any issues while using the Amazon Bedrock connector, see the [Troubleshooting](/agents/agents-kit-1/reference-guide/external-connectors/bedrock/#troubleshooting) section of the *Amazon Bedrock*.
{{% /alert %}}

## Testing and Troubleshooting
Expand Down
4 changes: 2 additions & 2 deletions content/en/docs/genai/v1/reference-guide/agent-commons.md
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@ For example, download and run the [Agent Builder Starter App](https://marketplac
To interact with LLMs using Agent Commons, you need at least one GenAI connector that adheres to the GenAI Commons principles. To test agent behavior, you must configure at least one [Deployed Model](/agents/agents-kit-1/reference-guide/genai-for-mx/commons/#deployed-model) for your chosen connector. Refer to the specific connector’s documentation for detailed instructions on setting up the Deployed Model.

* For [Mendix Cloud GenAI](https://marketplace.mendix.com/link/component/239449), importing the **Key** from the Mendix portal automatically creates a MxCloud Deployed Model. This is part of the [configuration](/agents/agents-kit-1/mx-cloud-genai/mxgenai-connector/#configuration).
* For [Amazon Bedrock](https://marketplace.mendix.com/link/component/215042), the creation of Bedrock Deployed Models is part of the [model synchronization mechanism](/appstore/modules/aws/amazon-bedrock/#sync-models).
* For [Amazon Bedrock](https://marketplace.mendix.com/link/component/215042), the creation of Bedrock Deployed Models is part of the [model synchronization mechanism](/agents/agents-kit-1/reference-guide/external-connectors/bedrock/#sync-models).
* For [OpenAI](https://marketplace.mendix.com/link/component/220472), the configuration of OpenAI Deployed Models is part of the [configuration](/agents/agents-kit-1/reference-guide/external-connectors/openai/#general-configuration).

### Defining the Agent {#define-agent}
Expand Down Expand Up @@ -149,7 +149,7 @@ Besides microflow tools, tools exposed by MCP servers are also supported. To add
For supported knowledge bases registered in your app, you can connect them to agents to enable autonomous retrievals. Refer to the documentation of the connector provided by your selected knowledge base provider. Follow the instructions to configure the knowledge bases in your app, so that they can be linked to your agents. Mendix provides the following platform-supported connectors that support knowledge base integrations with agents:

* [Mendix Cloud GenAI Connector](/agents/agents-kit-1/mx-cloud-genai/mxgenai-connector/#configuration)
* [Amazon Bedrock Connector](/appstore/modules/aws/amazon-bedrock/#sync-models)
* [Amazon Bedrock Connector](/agents/agents-kit-1/reference-guide/external-connectors/bedrock/#sync-models)
* [OpenAI Connector](/agents/agents-kit-1/reference-guide/external-connectors/openai/#azure-ai-search)
* [PgVector Knowledge Base](/agents/agents-kit-1/reference-guide/external-connectors/pgvector/#general-configuration)

Expand Down
Loading
Loading