Prerequisites for Custom Agent Actions Using Apex REST

You must first install Agentforce for Developers to use this feature. Agentforce for Developers is available in the VS Code and Open VSX marketplaces as a part of the Salesforce Extension Pack (Expanded). You can install it in the VS Code desktop application, or just use it in Code Builder, where the Salesforce Extension Pack (Expanded) comes pre-installed.

Agentforce for Developers is enabled by default. Any developer with access to a Salesforce org can use the extension. See Set Up Agentforce for Developers for more details.

An Apex REST class must be annotated with @RestResource. The class must contain at least one method annotated with either @HttpGet, @HttpPost, @HttpPut, @HttpPatch, or @HttpDelete. See Apex REST Annotations.

In order for an Apex class to qualify to be registered as an OpenAPI spec in the API catalog, it must have annotation @RestResource and have sharing rules defined using either the with sharing, without sharing, or inherited sharing modifiers. Apex classes from installed managed packages don't qualify. Apex classes from installed managed packages don't qualify. The Apex code inside a managed package remains inaccessible, even if declared global.

If this is your first time working in the VS Code IDE, check out the documentation for Salesforce Extensions for Visual Studio Code and Code Builder. You will also need to install the Salesforce Command Line Interface (CLI).

Decomposing External Service Registration (ESR) files makes them easier to work with because you can edit the OpenAPI v3 specification in a YAML editor in the VS Code IDE. To decompose your ESR metadata into YAML and metadata XML files, run sf project convert source-behavior -b decomposeExternalServiceRegistrationBeta in the command line to decompose existing ESR metadata files. New ESR files will be automatically decomposed upon generation. This command updates the sfdx-project.json file in your project to include the following:

When deploying the decomposed ESR to the org, the ESR metadata type data is reconstructed into a single record by embedding the YAML contents into the metadata xml. See External Service Registration Metadata for Apex REST.

Your AI AppDev org comes ready for Salesforce development. Salesforce Extensions for VS Code and Code Builder runs commands against this org. Connect to this org and then bring your Apex REST classes into your Salesforce IDE to generate your OAS. See Change or Open your Default Org to learn more about connecting to a Salesforce org.

The Org Browser displays all the metadata types in your connected org and makes it easy to retrieve any metadata component. Use the org browser and navigate to your existing Apex REST classes for which you want to generate the OAS. Click the retrieve icon next to the metadata type to quickly retrieve the required classes. The retrieved classes are located in the /force-app/main/default/classes in your Salesforce project. See Org Browser to learn more.