OpenAPI Extensions to Automatically Create Agent Actions

Add optional OpenAPI extensions to your OpenAPI document to automatically create agent actions when you deploy.

To validate and test documents to make sure that they work with your AuraEnabled Apex controller methods, make sure that the MuleSoft for Agentforce API Design Extension in the MuleSoft for Agentforce Extension Pack (beta) is installed.

ExtensionDescription
x-sfdc/agent/action/publishAsAgentActionRequired. Set this attribute to true to enable the operation as an action.
x-sfdc/privacy/isPiiOptional. If publishAsAgentAction is enabled, set this attribute to true to enable PII service for queries sent under that operation.
x-sfdc/agent/action/isUserInputRequired if publishAsAgentAction is enabled. Set this attribute to true to surface the field to the user for further input.
x-sfdc/agent/action/isDisplayableRequired if publishAsAgentAction is enabled. Set this attribute to true for the field to be displayable to the user.

These OpenAPI extensions are boolean fields you can add to a resource path in your OpenAPI document. For example:

If you add the OpenAPI extensions, confirm that the agent actions based on the deployed API are available in your org.

  1. From Setup, in the Quick Find box, enter Agentforce Assets and select it.
  2. Click the Actions tab, then filter the list by searching for AuraEnabled.
  3. To create additional agent actions, click New Agent Action.