Design an Integration to Call a Workflow

To use a human in the loop workflow with Agentic AI, you must create an integration that calls the workflow.

Prerequisites:

• You have created and activated a human in the loop workflow and a form.
• You have created a REST trigger connection.

Before you create the integration, note the following:

• The integration must be of asynchronous type, that is, the integration's endpoint does not receive a response.
• The integration must always start with a REST trigger connection.
• The REST trigger connection must be configured with the following:
  • POST verb
  • JSON request payload

Design an Integration to Call a Workflow

1. Open a project.
   1. In the navigation pane, select Projects.
   2. Select the project name.
2. Create an integration.
   1. In the left toolbar, select Integrations .
   2. In the Integrations section, click Add (if no integrations have been designed) or+ (if one or more integrations have been designed).
      The Add integration panel appears.
   3. Click Create and then select Application.
   4. Enter a name for the integration and provide additional descriptive information, if needed.
   5. Click Create.

      The integration canvas opens.

3. Configure the REST trigger connection that starts the integration.
   1. Click and in the resulting dialog select the REST trigger connection that you have created before.
      The Configure Basic Info page displays.
   2. Enter a meaningful name in the What do you want to call your endpoint? field and click Continue.
   3. In the Configure Resource Configuration page, enter the following details and click Continue.
      1. Provide an operation name: Enter the operation name.
      2. What does this operation do?: Provide a brief description of the purpose of the operation.
      3. What is the endpoint’s relative resource URI?: Enter the endpoint's relative path.
      4. What action do you want to perform on the endpoint?: Select POST.
      5. Add and review parameters for this endpoint: Select this option.
      6. Configure a request payload for this endpoint: Select this option.
      7. Configure request headers?: Select Custom
   4. In the Configure Request page, enter the following and click Continue.
      1. Select the request payload format as JSON.
      2. Click <<inline>> to copy and paste the JSON payload and click OK when complete.
   5. In the Configure Request Header page, add a custom HTTP request header x-agentic-callback-uri and enter a description for the custom header (for example, Callback URL).

      Note:

      This custom header specifies the call back URL which the AI agent uses to get the response/update after the human approval task completes.
   6. Click Continue.
   7. In the Summary page, click Finish.
4. Add a Human in the loop action to the integration to call a workflow.
   1. Click Actions to open the Action panel.
   2. From the Call section on the panel, drag the Human in the loop action and drop it onto the sign that appears when you hover over a connection arrow between elements.
      Alternatively, hover over a connection arrow, click the sign that appears, and select the Human in the loop action from the dialog box.
   3. In the Configuration Wizard that appears, configure the human in the loop action.
      1. On the Configure Basic Info page, provide a unique name and description in the following fields.
         • What do you want to call your endpoint?: Enter a unique name.
         • What does this endpoint do?: Provide a description.
      2. Click Continue.
      3. On the Configuration page, complete the following.
         • From the Process drop-down, select the workflow that the integration calls.
         • From the Version drop-down, select the appropriate version of the workflow selected.
      4. Click Continue.
      5. On the Summary page, review the data and click Finish.
   4. Click Continue.
   The human in the loop element is added to the integration.
5. Add a Map action before the Human in the loop action to pass information from the integration to the human in the loop workflow.
   1. Click Actions to open the Action panel.
   2. Drag a Map action and drop it onto the sign that appears when you hover over the connection arrow before the human in the loop action.
   3. Select the map action, click and select Edit. The mapper opens.
   4. In the Sources list on the left, expand the tree until you find the data element that you need to pass to the workflow.
   5. In the Target list on the right, expand the tree until you find the input that needs to receive the data.
   6. Drag the source element to the target element.
      For more information on mapping, see Map Data in Using the Oracle Mapper with Oracle Integration 3.
   7. After you've completed mapping elements, test your mapping.
      See Test Your Mappings in Using the Oracle Mapper with Oracle Integration 3.
6. Activate the integration.
   After you've completed designing the integration, activate it so that you can use it to create an agentic AI tool. See Activate an Integration in Using Integrations in Oracle Integration 3.