Get Started with Agent Networks
Setting up Anypoint Code Builder, permissions, access, and gateways ensures that you can create agent networks quickly and easily.
Before You Begin with Agent Networks
Before you start your agent network project, make sure that you have these products and access.
Agent Network Prerequisites
| Task | Product Prerequisites | Permissions and Access Prerequisites |
|---|---|---|
Set up agent network |
||
Create target space using Anypoint Runtime Manager |
Managed Flex Gateway with target space entitlements. Create at least one small Managed Flex Gateway and one large Managed Flex Gateway.
|
|
Set up ingress and egress gateways for target space using Anypoint Code Builder Command Palette |
Managed Flex Gateway with target space entitlements. Create at least one small Managed Flex Gateway and one large Managed Flex Gateway.
|
Runtime Manager: Manage Servers permission |
Set up ingress and egress gateways for target space using Anypoint CLI |
Managed Flex Gateway with target space entitlements. Create at least one small Managed Flex Gateway and one large Managed Flex Gateway.
|
Runtime Manager: Manage Servers permission |
Create project |
||
Create project using Anypoint Code Builder with MuleSoft Dev Agent |
Anypoint Code Builder desktop or web IDE. For more information, see Getting Started with Anypoint Code Builder.
|
A tenant relationship established with a trusted Salesforce organization.
|
Create project using Anypoint Code Builder UI or Command Palette |
Anypoint Code Builder desktop or web IDE. For more information, see Getting Started with Anypoint Code Builder.
|
Configure your allowlist. For more information, see Allow URLs for Anypoint Code Builder. |
Create project using Anypoint CLI |
Java 17. Because agent network binaries require Java to build the agent network, make sure you install Java 17 on your machine and set the |
Runtime Manager: Manage Servers permission |
Define agent network specification |
||
Add Exchange assets to project using Anypoint Code Builder with MuleSoft Dev Agent
|
Einstein enablement in Access Management. For more information, see Enabling or Disabling Agentforce for Anypoint Platform. |
A tenant relationship established with a trusted Salesforce organization.
|
Add Exchange assets to project using Anypoint CLI
|
Java 17. Since agent network binaries require Java to build the agent network, make sure you install Java 17 on your machine and set the JAVA_HOME environment variable. |
Runtime Manager: Manage Servers and Anypoint Design Center: Design Center Developer permissions |
Build project (applies only to CLI) |
||
Build project using Anypoint CLI |
Java 17. Because agent network binaries require Java to build the agent network, make sure you install Java 17 on your machine and set the JAVA_HOME environment variable.
|
Runtime Manager: Manage Servers permission |
Publish project assets to Exchange |
||
Publish project assets using Anypoint Code Builder with MuleSoft Dev Agent |
Einstein enablement in Access Management. For more information, see Enabling or Disabling Agentforce for Anypoint Platform.
|
A tenant relationship established with a trusted Salesforce organization.
|
Publish project assets using Anypoint Code Builder UI or the command palette |
Allowlist Anypoint Code Builder URLs. For more information, see Allow URLs for Anypoint Code Builder.
|
|
Publish project assets using Anypoint CLI |
Java 17. Because agent network binaries require Java to build the agent network, make sure you install Java 17 on your machine and set the |
Anypoint Exchange: Exchange Contributor and Runtime Manager: Manage Servers permissions |
Deploy project instance |
||
Deploy project instance using Anypoint Code Builder with MuleSoft Dev Agent |
Einstein enablement in Access Management. For more information, see Enabling or Disabling Agentforce for Anypoint Platform.
|
A tenant relationship established with a trusted Salesforce organization.
|
Deploy project instance using Anypoint Code Builder UI or command palette commands |
Allowlist Anypoint Code Builder URLs. For more information, see Allow URLs for Anypoint Code Builder.
|
|
Deploy project instance using Anypoint CLI |
Java 17. Because agent network binaries require Java to build the agent network, make sure you install Java 17 on your machine and set the |
API Manager: Deploy API Proxies and Manage Policies and Runtime Manager: Create Applications permissions |
Set Up the Private or Target Space for Your Environment
To deploy an agent network, you need a target space on either CloudHub 2.0 or 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 or Target Space
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.