All Products
Search

This Product

    Microservices Engine:Manage agents

    Document Center

    Microservices Engine:Manage agents

    Last Updated:Dec 08, 2025

    The Agent2Agent (A2A) protocol is an open standard. It enables seamless communication and collaboration between AI agents. This addresses the rising O&M, management, and deployment costs that are associated with a growing number of agents. It also helps multi-agent systems evolve toward a microservices model. To support unified agent management, Nacos provides the A2A Registry feature starting from version 3.1.0. This feature supports agent registration, discovery, namespace fencing, and version management. When Nacos is hosted on the MSE platform, MSE centrally manages the agents and their AgentCards registered in Nacos. This topic describes how to manage agent instances using MSE.

    Prerequisites

    Create an agent

    1. Log on to the MSE Registry & Configuration Management console and select a Region in the top menu bar.

    2. In the navigation pane on the left, choose Microservices Registry > Instances.

    3. On the Instances page, click the name of the target instance.

    4. In the navigation pane on the left, choose Agent management. In the upper-left corner of the page, select a Namespace and then click Create Agent.

    5. On the Create Agent page, select Create from JSON or Manual create.

      • Create from JSON: Click to browse for a local file. Upload the complete AgentCard JSON file, or paste the content into the text box, and then confirm the settings.

      • Manual create: Configure the parameters on the panel and then confirm the settings.

    Delete an agent

    1. Log on to the MSE Registry & Configuration Management console. In the top menu bar, select a Region.

    2. In the navigation pane on the left, choose Microservices Registry > Instances.

    3. On the Instances page, click the name of the target instance.

    4. In the navigation pane on the left, choose Agent management. In the upper-left corner of the page, select a Namespace. Click Delete in the Actions column of the target agent. In the dialog box that appears, click Delete.

    View agent details

    1. Log on to the MSE Registry & Configuration Management console and select a Region in the top menu bar.

    2. In the navigation pane on the left, choose Microservices Registry > Instances.

    3. On the Instances page, click the name of the target instance.

    4. In the navigation pane on the left, click Agent management. In the upper-left corner of the page, select a Namespace.

      • In this namespace, you can view information about all agents on the Nacos instance, such as the Agent name, Release version, Capabilities, Skills, and Release time.

    5. Click an agent name to view its details.

      • The Basic Information tab is selected by default. On this tab, you can view the basic information of the agent, such as the agent name, version number, endpoint, and transport protocol.

        • Below the Basic Information tab, you can see a list of all historical versions of this agent. If you click a historical version, the content on the Basic Information tab is automatically replaced with the content of the selected version.

      • Select the JSON tab to view the complete AgentCard JSON content for this agent. You can copy the content.

    Edit an agent

    1. Log on to the MSE Registry & Configuration Management console and select a Region in the top menu bar.

    2. In the navigation pane on the left, choose Microservices Registry > Instances.

    3. On the Instances page, click the name of the target instance.

    4. In the navigation pane on the left, choose Agent management. In the upper-left corner of the page, select a Namespace, and then click Edit in the Actions column of the target agent.

    5. In the Edit Agent panel, select Create from JSON or Manual create.

      1. Create from JSON: Click to browse for a local file. Upload the complete AgentCard JSON file, or paste the content into the text box, and then confirm the settings.

      2. Manual create: Configure the parameters on the panel and then confirm the settings.

    Important

    When you edit an agent, a new version is published based on your changes. If the version number is the same as a historical version, the information for that historical version is overwritten. If the version number is different, a new version is created and set as the latest published version.

    Search for an agent

    1. Log on to the MSE Registry & Configuration Management console and select a Region in the top menu bar.

    2. In the navigation pane on the left, choose Microservices Registry > Instances.

    3. On the Instances page, click the name of the target instance.

    4. In the navigation pane on the left, choose Agent management. In the upper-left corner of the page, select a Namespace.

    5. In the search box above the agent list, enter the name of the target agent. Then, click the image.png icon or press the Enter key to search. Fuzzy search is supported.