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
- Open Anypoint Code Builder (IDE).
- Select Design an API under Quick Actions.
- Check Enable this API for Agent Topics and Actions.
- 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)
- 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:
- Open API Project Properties.
- Deselect Enable this API for Agent Topics and Actions.
- 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.