You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/en/docs/marketplace/genai/how-to/create-single-agent.md
+9-7Lines changed: 9 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -301,7 +301,7 @@ Add a microflow tool that returns ticket details for a specific identifier.
301
301
302
302
3. Save the tool and the Agent document.
303
303
304
-
#### Connect Functions via MCP (Whole-Server Only)
304
+
#### Connect Functions via MCP (WholeServer Only)
305
305
306
306
Connect an MCP server as a tool source through a consumed MCP service document and import server-level tools.
307
307
@@ -310,24 +310,26 @@ Connect an MCP server as a tool source through a consumed MCP service document a
310
310
2. Give it a name, for example `MyMCP` and configure:
311
311
312
312
* **Endpoint**: create and select a string constant that contains your MCP server URL
313
-
* **Credentials microflow** (optional): set this when authentication is required
313
+
* **Credentials microflow** (optional): set this when authentication is required.
314
314
* **Protocol version**: select the protocol that matches your MCP server
315
315
316
+
For more details regarding protocol version and authentication, please review the [technical documentation](https://docs.mendix.com/appstore/modules/genai/genai-for-mx/agent-editor/#define-mcp).
317
+
316
318
3. In the consumed MCP service document, click **List tools** to verify the connection.
317
319
318
320
4. With the `IT_Ticket_Helper` Agent document open, in the **Tools** section click **New** and select **MCP tool**.
319
321
320
322
5. Select the consumed MCP service document you configured in the previous steps, then save the tool and the Agent document.
321
323
322
-
In Agent Editor, MCP integration is currently whole-server only. Selecting individual tools from the MCP server is not supported in this flow.
324
+
In Agent Editor, MCP integration is currently wholeserver only. This means that all tools exposed by the consumed MCP service will be made available to the agent. Selecting individual tools from the MCP server is not supported in this flow.
323
325
324
326
#### Include Knowledge Base Retrieval: Similar Tickets
325
327
326
328
Link a knowledge base collection to the agent so it can retrieve relevant historical tickets during response generation.
327
329
328
330
1. In **App Explorer**, right-click your module and select **Add other** > **Knowledge base**.
329
331
330
-
2. Set a name, for example `MyKnowledgebase` and configure the **Knowledge base key** by creating and selecting a constant that contains your knowledge base resource key from the Mendix Cloud GenAI Portal.
332
+
2. Set a name, for example `MyKnowledgebase` and configure the **Knowledge base key** by creating and selecting a String constant that contains your knowledge base resource key from the Mendix Cloud GenAI Portal.
331
333
332
334
3. Click **List collections** to validate the connection and load available collections.
333
335
@@ -348,7 +350,7 @@ Link a knowledge base collection to the agent so it can retrieve relevant histor
348
350
349
351
Before testing, make sure the app model has no consistency errors.
350
352
351
-
1. Make sure to set the `ASU_AgentEditor` as after-startup microflow. Start the app locally in Studio Pro. Wait until the local runtime is fully running.
353
+
1. Select `ASU_AgentEditor` as your [after-startup microflow](/refguide/runtime-tab/#after-startup) in **App** > **Settings** > **Runtime**. Start the app locally in Studio Pro. Wait until the local runtime is fully running.
352
354
353
355
2. With the `IT_Ticket_Helper` Agent document open, go to the Playground section of the editor.
354
356
@@ -373,7 +375,7 @@ Wire the **Ask the agent** button to a microflow that invokes the Agent Editor a
373
375
4. Configure the action:
374
376
375
377
* **Agent**: select the `IT_Ticket_Helper` Agent document
@@ -386,7 +388,7 @@ Wire the **Ask the agent** button to a microflow that invokes the Agent Editor a
386
388
387
389
6. Save the microflow and run the project.
388
390
389
-
You can now open the **TicketHelper_Agent** page and click **Ask the agent** to execute the agent from your app logic. When the model determines that a tool or knowledge base is needed, it will use the configuration that you added in the Agent document.
391
+
View the app in the browser and open the **TicketHelper_Agent** page and click **Ask the agent** to execute the agent from your app logic. When the model determines that a tool or knowledge base is needed, it will use the configuration that you added in the Agent document.
390
392
391
393
392
394
## Define the Agent Using Agent Commons {#define-agent-commons}
0 commit comments