Friday, April 10, 2026

#1135 - OIC Agents & Human in the Loop (HITL)

Introduction

So what is this? - from ORCL help center - 

Human-in-the-Loop (HITL) in Oracle Integration Cloud (OIC) is a functionality that enables, manages, and automates human interaction with agentic AI workflows. It allows for the integration of human judgment, approval, and oversight into automated processes to improve accuracy, safety, and compliance.

For more background, Raison d'être etc. - please check out the detailed post from my esteemed colleague, Stan.

Back to my apocryphal Order Processing agent - we could envisage a corporate rule where orders > $10000 require human approval.

To enable such, we would need - 

  • a UI - some sort of Order Approval form
  • a workflow design - who should approve? within which timeline?
  • the ability to be invoked as a tool
  • the ability to make a callback to the agent e.g. order approved or order rejected.
and that's exactly what we're offering -




Forms

Here we surface the Forms you know and love from Process Automation -


I add the fields from my purchase order and also include a text area for any notes the approver may want to add.
The order fields are marked as Read Only, that's why you don't see text boxes. 

This form will be surfaced via the workflow, which we will now define. Remember to activate the form, before attempting to reference it in the workflow. 


Workflows

Just add the Human Task -
Now configure it - 


As you can see, there are 2 Outcomes available - 
  • Complete, i.e. human task has completed.
  • Approve or Reject - which I will choose.
I configure the other fields -

Now to the Start Event - 
I configure it as follows - 




{"assignee": "niall.commiskey@oracle.com",
"taskTitle" : "Approve Order for NiallC",
"orderNr": "1234",
"customer": "NiallC",
"country": "Ireland",
"product" : "iBike",
"price" : "67890",
"customerEmail" :"xxx@gmail.com"}


 As you can see, the Start Event payload includes the order data, along with the assignee and task title.

These are used in the human task mapper - 

The End Event has been configured as follows - 

The Mapping is as follows - 





Note - this is the callback, i.e. the return of the approvers response to the AI Agent.

The callback url can be viewed here- 


I activate the Workflow - 

and wrap it in an integration - 
This leverages the Human-in-the-loop native action - 


Assign the new tool to the agent, and add the following to the agent guidelines -


#### 2.1.  Human Approval for Large Orders
Use the **Human Approval** tool to get human approval for large orders. Large orders are those with a price > 10000. Wait for the response - if approved then create the order, if rejected, then notify the customer with a relevant email.

I run the integration with the following payload - 


This will trigger the approval human task - 

The Approve Order task is accessed via the Process Workspace



I click APPROVE - 

Back in Project Observability - 

Note the Callback - 

Now to the agent audit trail - 

Summa Summarum

HITL is a great addition to your Agentic AI toolkit, providing as it does, the hook for control and governance. This will improve the accuracy, safety, and compliance of your agentic workflows. 



















No comments: