Overview

Use MuleSoft’s Topic Center (also known as Agentforce: Topic Center) to configure API specifications for topics and agents, then sync them to Salesforce API Catalog. This enables AI-powered agents to perform tasks autonomously, such as updating records, retrieving data, and executing actions across systems.

Key Concepts

• Topics – Bundles of actions and instructions that guide agents in completing tasks.
• Actions – Specific operations an agent can perform (e.g., updating a record, fetching data).
• Instructions – Guidelines that help agents determine how to execute actions.

Prerequisites

Before starting, ensure:
✅ Tenant relationship between Anypoint Platform and a Salesforce org with agent entitlements.
✅ API Catalog is enabled in Salesforce.
✅ Required permissions in Anypoint Platform:

• Exchange: Viewer, Creator
• Runtime Manager: Read/Create/Delete applications
• Design Center Developer access
  ✅ API Governance is enabled for version control.
  ✅ Familiarity with API design basics and business groups.

---

Step 1: Create an API Specification Project

1. Open Anypoint Code Builder (IDE).
2. Select Design an API under Quick Actions.
3. Check Enable this API for Agent Topics and Actions.
4. Fill in project details:
   • Project Name (unique identifier)
   • Project Location (avoid nested directories)
   • API Type: REST API
   • Specification Language: OAS 3.0 (YAML/JSON)
   • Business Group (required for governance)
5. Click Create Project → The Agent Topics configuration panel opens.

---

Step 2: Configure Topics

In the Agent Topics panel, define:

• Topic Label (unique name)
• Classification Description (how the agent identifies when to use the topic)
• Scope (narrowly defines the agent’s allowed actions)
• Instructions (guidelines like “Always clarify device type before troubleshooting”)

---

Step 3: Define Agent Actions

Annotate API operations to enable agent actions:

yaml

Copy

x-sfdc/agent/action/publishAsAgentAction: true  
x-sfdc/privacy/isPii: false  # Optional PII handling  
x-sfdc/agent/action/isUserInput: false  # User input required?  
x-sfdc/agent/action/isDisplayable: true  # Show field to users?  

Note: Metadata must be inline (not via $ref).

---

Step 4: Apply Governance & Publish

• The SF API Topic and Action Enablement ruleset is auto-applied.
• Validate governance rules to ensure API readiness.
• Publish to Exchange → Syncs to Salesforce API Catalog for agent use.

---

Disabling Topics & Actions

To remove topic functionality:

1. Open API Project Properties.
2. Deselect Enable this API for Agent Topics and Actions.
3. Click Apply → Removes sf-api-catalog/sf-api-topic tags and governance rules.

---

Next Steps

• Deploy the API in API Manager for Salesforce integration.
• Assign topics to agents in Agent Builder for autonomous task execution.

This streamlined process ensures AI agents leverage APIs efficiently while maintaining governance and security.