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:

  • Create a project. See Create or Import a Project in Using Integrations in Oracle Integration 3.
  • Create a human in the loop workflow. There must be at least one user task in the workflow with an associated form and a user assigned to the task. The workflow and form must be in Active state. For details, see the following:
  • Create a REST trigger connection with the REST adapter.

    The REST connection must be configured with the Trigger role and use OAuth 2.0 Or Basic Authentication as the security policy. See Create a Connection in Using the REST Adapter with Oracle Integration 3.

Before you create the integration, keep in mind 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 Integrations icon.
    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 Plus icon 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.
    4. In the Configure Request Parameters page, add a request parameter and select its data type.

      Note:

      This parameter specifies the call back URL which the AI agent uses to get the response/update after the human approval task completes.
    5. Click Continue.
    6. 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.
    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 Integration actions icon 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 Plus icon sign that appears when you hover over a connection arrow between elements.
      Alternatively, hover over a connection arrow, click the Plus icon 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 Integration actions icon to open the Action panel.
    2. Drag a Map action and drop it onto the Plus icon sign that appears when you hover over the connection arrow before the human in the loop action.
    3. Select the map action, click Actions icon 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.