You are here:
Integrate Integration Procedures with Agentforce
To make Integration Procedures available as a new action type within Agent Actions, start by selecting the desired Integration Procedure. Define its input and output data in JSON format, then verify the data. This process automatically converts the Integration Procedure Data JSON into a format compatible with Agentforce. Then, create an Agent Action, configure the Agent and Subagent, and activate the embedded Integration Procedure within Agentforce. After it’s set up, the Integration Procedure can be triggered during agent-customer interactions to drive real-time automation and data access.
Before you begin:
- Ensure that you’ve the Omnistudio permissions. See Omnistudio Permission Sets.
- Enable the Omnistudio Metadata in your org. See Enable Omnistudio Metadata API Support.
Prepare an Integration Procedure for Agentforce Integration
Before using an Integration Procedure within Agentforce, it's important to note that the data format expected by Agentforce is different from the standard Integration Procedure format. To ensure compatibility, you must prepare the Integration Procedure accordingly.
- From the Integration Procedure list view page, select and open the Integration Procedure that you want to integrate with Agentforce.
- Click Preview.
- Click Configure Agentforce.
-
Define the input and output data for the Integration Procedure in JSON format, and then
click Verify Data.
For example, enter this data that includes a user’s income details in JSON format to calculate the base tax slab and surcharge based on the income slab.Note
When defining the input and output JSON, only alphanumeric characters (A-Z, a-z, 0-9) are allowed for the key in the key-value pair. No special characters are permitted.
Input Data JSON:
{ "taxpayerId": "TAXP123456", "financialYear": "2024-2025", "totalIncome": 1800000 }Output JSON Response:
{ "taxpayerId": "TAXP123456", "financialYear": "2024-2025", "baseTax": 315000, "surcharge": 0, "totalTaxPayable": 315000 }When you click Verify Data, the data structure is updated automatically.
- Click Next.
- Click Save.
- Activate the Integration Procedure.
Create Agent Actions
Agent Actions act as connectors between Agentforce and the Integration Procedure.
-
From Setup, search and open Agentforce Assets, click Actions, and
then click New Agent Action.
Note
Dynamic Apex classes may be auto-generated even before configuring Integration Procedures as Agent Actions. These Apex classes have no functional impact and can be safely ignored.
- Select Integration Procedure as the reference action type.
- Select the desired Integration Procedure as the reference action.
- Enter an Agent action label.
- Enter an Action API name.
- Click Next.
-
Provide input instructions:
- Select Require input.
- Select Collect data from user.
-
Provide output instructions:
- Select Select Show in conversation.
- Click Finish.
Configure an Agent
Create an Agent to manage conversation flows and execute Agent Actions. Add a subagent and associate it with the Agent Action. Subagents define specific intents or tasks the Agent handles.
For information about how to configure an Agent, see Configure Your Agent.

