Getting Started

System Requirements

Before you start, ensure you have the following prerequisites:

Java Development Kit (JDK) 8, 11, and 17
Apache Maven
MuleSoft Anypoint Studio

Option 1: Maven Central Repository

Edit File `pom.xml`

💡

The MAC Project connectors are constantly updated, and the version is regularly changed. Make sure to replace {version} with the latest release from Maven Central (opens in a new tab).

Copy and paste the following Maven Dependency into your Mule application pom file.

pom.xml

<dependency>
    <groupId>io.github.mulesoft-ai-chain-project</groupId>
    <artifactId>mule4-agentforce-connector</artifactId>
    <version>{version}</version>
    <classifier>mule-plugin</classifier>
</dependency>

Option 2: Local Maven Repository

Download the Agentforce Connector

Clone the Agentforce Connector repository from GitHub:

git clone https://github.com/MuleSoft-AI-Chain-Project/mule-agentforce-connector.git
cd mule-agentforce-connector

Install the Connector with Java 8

mvn clean install -Dmaven.test.skip=true -DskipTests

Installing with Java 11, 17, 21, 22, etc.

Step 1

export MAVEN_OPTS="--add-opens=java.base/java.util=ALL-UNNAMED --add-opens=java.base/java.net=ALL-UNNAMED --add-opens=java.base/java.util.regex=ALL-UNNAMED --add-opens=java.base/java.lang.reflect=ALL-UNNAMED --add-opens=java.base/java.lang=ALL-UNNAMED --add-opens=java.xml/javax.xml.namespace=ALL-UNNAMED"

Step 2

 
For Java 11
mvn clean install -Dmaven.test.skip=true -DskipTests -Djdeps.multiRelease=11
 
For Java 17
mvn clean install -Dmaven.test.skip=true -DskipTests -Djdeps.multiRelease=17
 
For Java 21
mvn clean install -Dmaven.test.skip=true -DskipTests -Djdeps.multiRelease=21
 
For Java 22
mvn clean install -Dmaven.test.skip=true -DskipTests -Djdeps.multiRelease=22

Add the Connector to Your Project

Add the following dependency to your pom.xml file:

pom.xml

  <dependency>
  	<groupId>com.mulesoft.connectors</groupId>
  	<artifactId>mule4-agentforce-connector</artifactId>
  	<version>1.0.0</version>
  	<classifier>mule-plugin</classifier>		
  </dependency>

💡

The MAC Project connectors are constantly updated, and the version is regularly changed. Make sure to replace {version} with the latest release from our GitHub repository (opens in a new tab).

Retrieving Salesforce Credentials

To use the Agentforce Connector in Anypoint Studio / Code Builder, you need to create a Connected App on your Salesforce Org.

In order to create client credentials, follow these instructions (Step 1 + 2 only, Create Connected App and Add Connected App to Agent): Salesforce Developer Guide (opens in a new tab)

Anypoint Configuration

The Agentforce Connector can be easily configured. Go to the Global Elements in your MuleSoft project, and create a new configuration. In the Connector Configuration, you will find the Agentforce Configuration. Select it and press OK.

Adding Credentials to Connector Configuration

Enter the data in the dedicated fields:

Salesforce Org: Enter the name of your Salesforce org. For example, from the URL https://agentforce-111-231-222-demo.my.salesforce.com/, the org name is agentforce-111-231-222-demo.my.salesforce.com.
Client ID: Enter the consumer key from your connected app.
Client Secret: Enter the consumer secret from your connected app.

Connector Overview Supported Operations