Agent Commons
Overview
Integrate the possibility to visually define agents with this module. Combined with other assets like GenAI Commons, Conversational UI and the connectors for models of OpenAI, Amazon Bedrock and Mendix Cloud, you have all the things you need to build smart, agentic AI apps with Mendix.
This module contains a domain model, pages and toolbox operations to define and call agents. It allows developers and prompt engineers to collaborate and build agentic systems.
See the Agent Builder Starter App for a full app with a template support agent for an example of how to use this module.
Create agents grounded in private knowledge like static reference guides and that can take action with tools, to call APIs or to retrieve live data in the app, like tickets.
- Use any of the supported connectors to leverage a variety of large language models in your agent from OpenAI, Amazon Bedrock, Mendix Cloud or Bring Your Own.
- Take advantage of all the capabilities of Conversational UI, Prompt Management and the GenAI Commons modules. Agents created with Agent Commons are fully integrated & compatible with these components.
Explore the full potential of generative and agentic AI in your Mendix applications with this starter app template and start building today!
Contact Us
For support and questions, feel free to reach out via email genai-components-feedback@mendix.com or Community Slack.
Documentation
This module contains a domain model, pages and toolbox operations to define and call agents. It allows developers and prompt engineers to collaborate and build agentic systems.
General Setup
- Download the latest versions of the following modules from the Marketplace and follow the setup instructions: GenAICommons, ConversationalUI. A connector that is compatible with GenAI Commons is required for the interactions with your LLMs of choice.
- In the project security of your app, add the module role 'AgentCommons.AgentAdmin' to the user roles that are intended to define and refine Agents.
- Add the 'Agent_Overview' page (USE_ME > Agent Builder) to your Navigation or add the 'Snippet_Agent_Overview' to a page that is already part of your Navigation. Now the Agents can be defined at runtime.
Define Agents
- Run the app (locally or in the cloud).
- Create and edit agents at runtime. Write the prompts, use variable placeholders, add microflows as tools and connect knowledge bases to define the tasks and cabapilities of the agents.
- Configure the deployed model (LLM) that the agent should use, and connect the agent to it.
- Create various versions of the agents and test in an isolated setup to rapidly iterate, compare and evaluate the agentic behavior
- Set a version as "in use" to allow it to be called from the actual logic in the app.
Call an Agent from App Logic
Use toolbox operations "Call Agent" and "Create Chat for Agent" to use an agent in a microflow and make it part of your app logic. Download the Agent Builder Starter App from the Marketplace for a detailed example of how to use the "Call Agent" activity in an action microflow of a chat interface.