-
Manage Servers
-
Create Applications
-
Read Servers
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 |
|
Anypoint Code Builder |
|
Anypoint Design Center |
Design Center Developer |
API Manager |
|
Exchange |
Exchange Contributor |
Usage |
Usage Viewer |
CloudHub 2.0 or Runtime Fabric (limited availability) |
See Permissions by Product in Anypoint Platform for a list of all Anypoint Platform permissions.
Additional Requirements
To complete these task, you also need:
-
Your Anypoint Platform credentials
-
A tenant relationship established with a trusted Salesforce organization
-
Allowlist Anypoint Code Builder URLs. For more information, see Allow URLs for Anypoint Code Builder.
-
PowerShell (For Windows operating systems only).
CLI Requirements (Optional)
If you’re using the Anypoint CLI to create agent network projects, ensure you meet these requirements.
-
Node 20 (v20.19.4) or later. See Nodejs.org.
-
Java 17 or later. Set the
JAVA_HOMEenvironment variable.
Task Overview
Step 1: Set Up Your Agent Network
-
Use Anypoint Runtime Manager to set up a private space in CloudHub 2.0 or deployment target in Runtime Fabric.
-
Set up Ingress and egress Flex Gateways for the private space or deployment target.
-
If using Anypoint Code Builder, see Set Up Agent Network Gateways for the Private Space or Deployment Target.
-
If using the Anypoint CLI, see the setup gateways command reference.
-
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.
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:
-
CloudHub 2.0:
-
Create a private space in CloudHub 2.0 or verify that you can access an existing private space.
To create a private space, see Creating Private Spaces. We recommend naming the private space
agent-network-space. -
Associate the new or existing private space with the business groups and environments where you plan to deploy your agent network.
You must complete this step so that the private space appears as a valid deployment target in Anypoint Code Builder and Anypoint CLI.
-
-
Runtime Fabric (limited availability):
Create a target space for Runtime Fabric.
For information about Runtime Fabric deployments, see Managed Flex Gateway on Runtime Fabric.
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.
-
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.
-
If you’re not logged in, log in to your Anypoint Platform account.
-
Select the business group, environment, and private or target space.
The
MuleSoft: Set Up Agent Network Gatewayscommand 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.



