Version Agents Kit by dbreseman · Pull Request #11320 · mendix/docs

dbreseman · 2026-06-08T15:09:18Z

Implement versioning for Agents Kit documentation (to be released the day after the SP 11.12 release)

Structural updates:
- Create v1/ and v2/ directories for versioned how-to guides, reference guides, and component overviews
- Add unversioned aliases to v2 pages for backwards compatibility, and update all internal cross-references to use versioned URLs
- Add version badges to the v1/ and v2/ directories
- Add alert to v1 docs with a single-click path to the corresponding v2 doc
- Move the Bedrock connector into the Agents Kit docs
- General language edit in v2 docs
- Adjust content/framing in all index pages
Agents Kit 2 product updates:
- List compatible release versions for Agents Kit components in each version
- AWS Bedrock update for Credentials usage
- Emphasize Agent Editor as the recommended approach in v2, and update the MxGenAI connector config instructions to reflect Agent Editor
- Remove "Build a Chatbot Using the AI Bot Starter App" and "Build a Chatbot from Scratch Using the Blank GenAI App" how-to guides from v2 and update references to them
- Migrate changes related to the MxGenAI connector for both versions
- Add release guide for Agents Kit 2
To do:
- Mention Studio Pro 11.12 as a prereq in all relevant docs
- Integrate any docs changes related to updated apps and modules, once dev is finished for them: https://github.com/liamsommer-mx/development/tree/connector-updates

dbreseman · 2026-06-19T10:33:37Z

+
+For any additional feedback, send a message in the [#genai-connectors](https://mendixcommunity.slack.com/archives/C07P8NRBLN9) channel on the Mendix Community Slack. You can sign up for the Mendix Community using [this invitation link](https://mendixcommunity.slack.com/join/shared_invite/zt-270ys3pwi-kgWhJUwWrKMEMuQln4bqrQ#/shared-invite/email).
+
+### Featured Blogposts


Rather than trying to keep this list updated with the latest relevant blog posts, is there a single tag or search string we can point to? I know there's https://www.mendix.com/tag/ai/, but that's probably a bit too broad to be useful.

@EmilyvonBergen

Working with Matt Bailey to create a relevant tag. May or may not be ready in time to go out with this PR.

… starter apps

…on Connector Doc (#11365) * Revise AWS Authentication documentation for Credentials usage Updated documentation to reflect the use of a Credentials object for various operations instead of static credentials. * Improve description of creating Credentials object * Update amazon-bedrock.md * Move Bedrock doc into Agents Kit versioning * Update cross-links --------- Co-authored-by: MarkvanMents <mark.van.ments@mendix.com> Co-authored-by: katarzyna-koltun-mx <108737161+katarzyna-koltun-mx@users.noreply.github.com> Co-authored-by: Dana Breseman <dana.breseman@mendix.com>

* Add migration guide for AK2 * Apply feedback from review * Move release guide up a level * Clarify that SP agents need MxCloud resources

dbreseman added 4 commits June 8, 2026 16:51

Create v1 and v2 folders

2a0b60c

Preface descriptions with version number

79e2ebb

Preface v2 descriptions

af050e5

Add version badges and banner

35e0cc0

dbreseman self-assigned this Jun 8, 2026

dbreseman added the 11.12 LTS label Jun 8, 2026

dbreseman added 10 commits June 8, 2026 17:32

Fix banner link

34ec6cf

Merge branch 'development' into db-agents-kit-versioning

093ef5c

Version the URLs

ebb8ec2

Update internal xrefs

a2db2c0

Update xrefs in concepts, mxgenai, mcp-modules, and index

f7ac3e1

Version genai-for-mx internal xrefs

d8a4d6e

Add unversioned aliases for v2

3ae318c

Add index pages and version components table

ce05ac7

Update external xrefs

23ccc17

Fix Agents Kit 1 references

6c7d6f6

dbreseman commented Jun 16, 2026

View reviewed changes

Comment thread content/en/docs/genai/v1/_index.md Outdated

Add Agents Kit 1 release versions

bc04eb9

dbreseman commented Jun 17, 2026

View reviewed changes

Comment thread content/en/docs/genai/v2/_index.md

dbreseman added 6 commits June 17, 2026 16:37

Add Agents Kit 2 versions

fcbdac6

Add reference-guide to genai-for-mx and snowflake-connector URLs

08dac10

Proofread

efd4ee0

Assume user is on SP 11.12+

00bee27

Assume Studio Pro 11.12

938ce53

Edit language and simplify

d43e697

dbreseman commented Jun 19, 2026

View reviewed changes

Comment thread content/en/docs/genai/v2/how-to/_index.md Outdated

dbreseman added 3 commits June 19, 2026 14:13

Simplify index pages for how-to and reference guide

f2f2928

Standardize descriptions

a797290

Add BYO Connector link

6899cf7

dbreseman added 7 commits June 19, 2026 14:44

Delete "Build a Chatbot from Scratch Using the Blank GenAI App"

cf1ded0

Delete "Build a Chatbot from Scratch Using the Blank GenAI App"

5848c3e

Fix typo

a666411

Minor tweaks and broken links

dfa5c03

Adapt mxgenai-connector for Agent Editor + specify relevant steps for…

a025b9f

… starter apps

Merge branch 'development' into db-agents-kit-versioning

540311c

Fix link error

c2fe0b7

piyaviraj-ranasinghe reviewed Jun 22, 2026

View reviewed changes

Comment thread content/en/docs/genai/v2/reference-guide/external-platforms/mx-genai-connector.md

piyaviraj-ranasinghe approved these changes Jun 22, 2026

View reviewed changes

dbreseman and others added 9 commits June 22, 2026 11:37

Restructure MxGenAI connector config steps

107eff9

Mention Agent Editor and HITL more

f1e38af

Language edit: BYO Connecotr

5141d08

Add glossary links

0af2b57

Fix xrefs

5538fcc

Assume Studio Pro 11.12 and recent module version

4ba0992

Adjust index pages

67a9f94

Update index descriptions

51e1532

dbreseman commented Jun 24, 2026

View reviewed changes

Comment thread content/en/docs/genai/v2/_index.md Outdated

dbreseman removed the 11.12 LTS label Jun 25, 2026

dbreseman and others added 10 commits June 25, 2026 13:52

Update Getting Started, Slack Channel, and Blog Posts

8fe0f47

Merge branch 'development' into db-agents-kit-versioning

db2ff06

Apply MxGenAI connector changes to v2

ce749f9

Update release versions

44b9bdf

Adjust ref guide weights

716888d

Add release guide for Agents Kit 2 (#11417)

82f9153

* Add migration guide for AK2 * Apply feedback from review * Move release guide up a level * Clarify that SP agents need MxCloud resources

Add single-click link from AK1 to AK2 pages

96e6a7a

Minor tweaks

3165509

Add Agent Editor instructions for the MxGenAI connector in AK1

6d300b5

Minor tweaks

e220787

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Version Agents Kit#11320

Version Agents Kit#11320
dbreseman wants to merge 50 commits into
developmentfrom
db-agents-kit-versioning

dbreseman commented Jun 8, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

dbreseman Jun 19, 2026

Uh oh!

dbreseman Jun 22, 2026

Uh oh!

dbreseman Jun 25, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants


		For any additional feedback, send a message in the [#genai-connectors](https://mendixcommunity.slack.com/archives/C07P8NRBLN9) channel on the Mendix Community Slack. You can sign up for the Mendix Community using [this invitation link](https://mendixcommunity.slack.com/join/shared_invite/zt-270ys3pwi-kgWhJUwWrKMEMuQln4bqrQ#/shared-invite/email).

		### Featured Blogposts

Uh oh!

Conversation

dbreseman commented Jun 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

dbreseman Jun 19, 2026

Choose a reason for hiding this comment

Uh oh!

dbreseman Jun 22, 2026

Choose a reason for hiding this comment

Uh oh!

dbreseman Jun 25, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

dbreseman commented Jun 8, 2026 •

edited

Loading