Skip to content

Commit 086f04c

Browse files
committed
SAS-1848 small changes to agent editor how-to
1 parent 0129bd6 commit 086f04c

1 file changed

Lines changed: 9 additions & 7 deletions

File tree

content/en/docs/marketplace/genai/how-to/create-single-agent.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -301,7 +301,7 @@ Add a microflow tool that returns ticket details for a specific identifier.
301301
302302
3. Save the tool and the Agent document.
303303
304-
#### Connect Functions via MCP (Whole-Server Only)
304+
#### Connect Functions via MCP (Whole Server Only)
305305
306306
Connect an MCP server as a tool source through a consumed MCP service document and import server-level tools.
307307
@@ -310,24 +310,26 @@ Connect an MCP server as a tool source through a consumed MCP service document a
310310
2. Give it a name, for example `MyMCP` and configure:
311311
312312
* **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.
314314
* **Protocol version**: select the protocol that matches your MCP server
315315
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+
316318
3. In the consumed MCP service document, click **List tools** to verify the connection.
317319
318320
4. With the `IT_Ticket_Helper` Agent document open, in the **Tools** section click **New** and select **MCP tool**.
319321
320322
5. Select the consumed MCP service document you configured in the previous steps, then save the tool and the Agent document.
321323
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 whole server 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.
323325
324326
#### Include Knowledge Base Retrieval: Similar Tickets
325327
326328
Link a knowledge base collection to the agent so it can retrieve relevant historical tickets during response generation.
327329
328330
1. In **App Explorer**, right-click your module and select **Add other** > **Knowledge base**.
329331
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.
331333
332334
3. Click **List collections** to validate the connection and load available collections.
333335
@@ -348,7 +350,7 @@ Link a knowledge base collection to the agent so it can retrieve relevant histor
348350
349351
Before testing, make sure the app model has no consistency errors.
350352
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.
352354
353355
2. With the `IT_Ticket_Helper` Agent document open, go to the Playground section of the editor.
354356
@@ -373,7 +375,7 @@ Wire the **Ask the agent** button to a microflow that invokes the Agent Editor a
373375
4. Configure the action:
374376
375377
* **Agent**: select the `IT_Ticket_Helper` Agent document
376-
* **Context object**: `TicketHelper` (input parameter)
378+
* **Context object**: `$TicketHelper` (input parameter)
377379
* **Request**: empty
378380
* **FileCollection**: empty
379381
* **Output: Object name**: `Response`
@@ -386,7 +388,7 @@ Wire the **Ask the agent** button to a microflow that invokes the Agent Editor a
386388
387389
6. Save the microflow and run the project.
388390
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.
390392
391393
392394
## Define the Agent Using Agent Commons {#define-agent-commons}

0 commit comments

Comments
 (0)