Edit and divide the Creating Your First Agent guide

content/en/docs/marketplace/genai/concepts/agents.md

@@ -10,9 +10,9 @@ description: "Describes Agents and Agentic Patterns as used with generative AI i
 
 GenAI agents are autonomous computational systems that perform actions in response to triggers such as user input or system events. These agents apply reasoning, execute tools (functions), and leverage data from knowledge bases to determine the most appropriate responses. They may be adaptive (learning-based) or task-specific, designed to automate processes and improve operational efficiency.
 
-If you are interested in creating your own agent, explore the guide on [building your first agent in Mendix](/appstore/modules/genai/how-to/howto-single-agent/). It walks you through how to combine prompt engineering, function calling, and knowledge base integration—all within a Mendix app.
+If you are interested in creating your own agent, explore the guide on [Creating Your First Agent](/appstore/modules/genai/how-to/creating-agents/). It walks you through how to combine prompt engineering, function calling, and knowledge base integration—all within a Mendix app.
 
-## Multi-Agent systems
+## Multi-Agent Systems
 
 Sometimes, a single agent is not enough for more complex use cases. In such cases, a multi-agent solution is needed. Multi-agent architectures go beyond single-agent implementations when tasks become too complex for one agent to handle alone. While single agents work well for simple, well-defined tasks, more complex or uncertain scenarios require multiple agents to collaborate. Multi-agent systems enable the coordination of business processes, specialized task allocation, and protocol execution by invoking dedicated sub-agents, often dynamically. This approach leads to better performance and more efficient operations compared to relying on a single agent to handle everything.
 

content/en/docs/marketplace/genai/how-to/creating-agents/_index.md

@@ -0,0 +1,47 @@
+---
+title: "Creating Your First Agent"
+url: /appstore/modules/genai/how-to/creating-agents/
+linktitle: "Creating Your First Agent"
+weight: 60
+description: "Introduces an example agent use case and describes three approaches for implementing it with Agents Kit using knowledge base retrieval and function calling."
+aliases:
+    - /appstore/modules/genai/how-to/howto-single-agent/
+---
+
+## Introduction
+
+This guide explains how to create an agent in your Mendix app that combines [knowledge base retrieval (RAG)](/appstore/modules/genai/rag/) and [function calling](/appstore/modules/genai/function-calling/) capabilities from Mendix Agents Kit.
+
+## Agent Use Case
+
+{{< figure src="/attachments/appstore/platform-supported-content/modules/genai/genai-howto-singleagent/structure_singleagent.svg" alt="Agent use case structure showing integration of LLM, knowledge base, and function calling" >}}
+
+For this agent, you will set up logic that calls LLMs available via Mendix Cloud GenAI calls to dynamically determine which in-app and external information is needed based on user input. The system retrieves the necessary information, uses it to reason about the actions to perform, and handles execution while keeping you informed and involved where needed.
+
+The end result is an example agent in a Mendix app. In this use case, you can ask IT-related questions to the model, which assists in solving problems. The model has access to a knowledge base containing historical, resolved tickets that can help identify suitable solutions. Additionally, function microflows are available to enrich the context with relevant ticket information, such as the number of currently open tickets or the status of a specific ticket.
+
+This agent is a task agent, which means that:
+
+* It is a single-turn interaction (one request-response pair for the UI).
+* No conversation or memory is applicable.
+* It focuses on specific task completion.
+* It uses a knowledge base and function calling to retrieve data or perform actions.
+
+## Implementation Approaches {#implementation-approach}
+
+You can define an agent for your Mendix app using any of the following approaches, all of which use Agents Kit:
+
+* Use [Agent Editor in Studio Pro](/appstore/modules/genai/how-to/create-agent-with-agent-editor/) for creating and iterating on agent definitions as part of the app model. This is the recommended approach for most use cases because it uses existing development capabilities of the platform to define, manage, and deploy agents as part of a Mendix app.
+* Use the [Agent Builder UI to define agents](/appstore/modules/genai/how-to/create-agent-with-agent-commons/) at runtime based on the principles of Agent Commons. It enables versioning, development iteration, and refinement at runtime, separate from the traditional app logic development cycle.
+* Use the building blocks of GenAI Commons to [define the agent programmatically](/appstore/modules/genai/how-to/create-agent-programmatically/). This is useful for very specific use cases, especially when the agent needs to be part of the code repository of the app.
+
+## Getting Started
+
+All three approaches require the same foundational setup. Start with the [Set Up Your App for Agent Creation](/appstore/modules/genai/how-to/creating-agents/shared-setup/) guide to do the following:
+
+* Set up your app with the required modules and configuration
+* Generate ticket data and ingest historical information into a knowledge base
+* Create the domain model and user interface for agent interaction
+* Build function microflows that the agent can call to retrieve data
+
+After completing the shared setup, continue with your chosen implementation approach.