Contact Us 1-800-596-4880

Get Started with Agent Networks

Creating agent networks is a multi-step process. Review these prerequisites and task overviews to make sure you can create agent networks efficiently.

Before You Begin

Before you get started, review these prerequisites.

Anypoint Platform Requirements and Permissions

Anypoint Platform Component Required Permissions

Runtime Manager

  • Manage Servers

  • Create Applications

  • Read Servers

Anypoint Code Builder

  • Anypoint Code Builder

  • Developer Mule Developer Generative AI User

Anypoint Design Center

Design Center Developer

API Manager

  • Deploy API Proxies

  • Manage Policies

Exchange

Exchange Contributor

Usage

Usage Viewer

CloudHub 2.0 or Runtime Fabric (limited availability)

Runtime Fabric permissions CloudHub 2.0 permissions

See Permissions by Product in Anypoint Platform for a list of all Anypoint Platform permissions.

Additional Requirements

To complete these task, you also need:

CLI Requirements (Optional)

If you’re using the Anypoint CLI to create agent network projects, ensure you meet these requirements.

Task Overview

Step 1: Set Up Your Agent Network

  1. Use Anypoint Runtime Manager to set up a private space in CloudHub 2.0 or deployment target in Runtime Fabric.

  2. Set up Ingress and egress Flex Gateways for the private space or deployment target.

Step 2: Create a Project

Now you’re ready to create an agent network project. Choose one of these methods.

Step 3: Define Your Agent Network Specification

After you create your agent network project, configure agent-network.yaml and exchange.json to reflect the structure of your network.

Step 4: Publish Your Agent Network Assets

Build and publish your agent network project as Anypoint Exchange assets. When you publish the agent network, an asset is created in Exchange for each broker, agent, and MCP server that’s in your agent network.

Step 5: Deploy Your Agent Network Instances

Deploy your agent network instance to a deployment target. You can deploy to a CloudHub 2.0 private space or to a Runtime Fabric (limited availability).

Set Up the Private Space or Deployment Target for Your Environment

To deploy an agent network, you need a private space on CloudHub 2.0 or a deployment target on Anypoint Runtime Fabric.

If you already have a private space configured in CloudHub 2.0, you can associate it with the business groups and environments where you’ll deploy your agent network.

Depending on your deployment target:

Set Up Agent Network Gateways for the Private Space or Deployment Target

After you have a target space, use the MuleSoft: Set Up Agent Network Gateways command to create the ingress and egress gateways required for deployment in either CloudHub 2.0 or Runtime Fabric.

For agent networks, you must have at least one small Managed Flex Gateway and one large Managed Flex Gateway in your environment. For more information about gateways, see Flex Gateway Deployment Models.

For more information about Runtime Fabric deployments, see Managed Flex Gateway on Runtime Fabric.

  1. In Anypoint Code Builder, from the Command Palette, run the command MuleSoft: Set Up Agent Network Gateways.

    If you didn’t associate the private space with the business group and environment, you see an error.

  2. If you’re not logged in, log in to your Anypoint Platform account.

  3. Select the business group, environment, and private or target space.

    The MuleSoft: Set Up Agent Network Gateways command creates these gateways in the private or target space you select:

    • agent-network-ingress-gw (with public and internal endpoint)

    • agent-network-egress-gw (with internal endpoint only)

If the gateways already exist in the selected private or target space, the command doesn’t recreate them.