Agentforce Workshop

Appearance

Exercise 4: Connect Agentforce with your MuleSoft App ​

In this exercise, you’ll configure an Agentforce agent in Agent Builder, add your hotel-reservation topic and its actions, then test end-to-end by having the agent retrieve real reservation data on demand.

Step 1: Access your Agent ​

  1. In Setup, search for Agentforce Agents and select Agentforce Agents (Under Agentforce Studio).

  2. Click on Agentforce (Default) or Einstein Copilot depending on your environment, then Open in Builder.

  3. Click Deactivate to deactivate the agent.

Step 2: Add the API Actions to your Agent ​

  1. Remove the default topic, Click the arrow down icon next to MigrationDefaultTopic and select Remove from Agent.

  2. Click the arrow down icon next to Manage the topics assigned to your agent, and select Add from Asset Library.

  3. Search for Hotel and select the Hotel Room Reservation topic.

  4. Click Finish.

    This topic was generated by the API Catalog.

  5. In the Topics sidebar, click the Hotel Room Reservation topic.

  6. Click the This Topic's Actions tab.

    You will see your API endpoints listed as Agent actions, parsed via Topic Center and the API Catalog.

Step 3: Test the Agent with the API ​

  1. Click the refresh button to reset the conversation.

  2. Enter the prompt:

    txt
    Can you provide the reservation details for reservation Id 35245

  3. Examine the plan—you’ll see the agent select the Hotel_Room_Reservation topic and then the reservationRetrieve action created through the API Catalog.

Debugging Tips ​

  • Ensure your API in Anypoint Exchange has the sf-api-catalog tag.
  • Confirm conformance to the SF API Topic & Action Enablement Ruleset.
  • Verify your API Instance is Active and has the Auto-Discovery ID.
  • Make sure your Agent user has access to Named Credentials and API calls.
  • Object Settings: Read access to User External Credential object.
  • System Permission: API Enabled.

Summary ​

In this exercise, you:

  1. Accessed and deactivated the default Agentforce agent in the Agent Studio.
  2. Removed the sample topic and imported your Hotel Room Reservation topic from the Asset Library.
  3. Verified that the API endpoints were added as actions under the selected topic.
  4. Tested the agent by issuing a sample reservation query and reviewed the execution plan.
  5. Learned key debugging checks to ensure your MuleSoft API and Agentforce integration is correctly configured.

TIP

This is a working document—please share feedback to help us improve. Feel free to reach out to Akshata Sawant (akshata.sawant@salesforce.com) with any questions or for assistance. Thank you!