Creating AI Agents using Business Object in Oracle Fusion

In my previous blog, I had demonstrated how to create a RAG-based AI Agent using Oracle Fusion AI Agent Studio. In this blog, I will demonstrate how we can create an AI Agent using a Business Object.

Oracle Fusion provides powerful REST APIs that allow applications and integrations to access business data securely. Using Business Objects in AI Agent Studio, we can connect these APIs directly to AI agents and create intelligent conversational experiences.

In this blog, we will walk through a step-by-step process to build an AI agent that retrieves worker information from Oracle Fusion using a Business Object. The AI agent will accept a worker’s person number as input and return details such as employee name, email, phone number, assignment details and more. To be specific, we will be using the Get all workers REST API.

On a high-level, the steps involved are as follows:

1. Create a Business Object
2. Create a Tool based on the Business Object
3. Create an Agent Team
4. Create an Agent
5. Publish AI Agents

So let’s crack on!!!!

Create Business Object

From the navigation-pane at the bottom, click on Business Object.

Click on Add.

Select Family and Product. For this blog, I’ll use HCM and Global Human Resources respectively, since we are creating a business object to fetch the details of workers. I’ll select Monolith resource as the Resource Type.

Under Resource Path, add the endpoint for the API Get all workers from the oracle documentation cited above.

Scroll down. Click on Add from Specification.

All exposed REST APIs would be enlisted. Select Get all workers operation from the list. Click Done.

Under Headers section, click Add. Add REST-Framework-Version = 4.

Next, add parameters under Parameters and Business Object fields. Click Add Parameters. Here, we will pass the person Number as the parameter. So I add the necessary details.

I add the sample response Payload.

We are all set. Click Done.

Amend the Resource Path to accommodate the parameter and if you want to restrict the output fields. (Make sure you test the resource path using Postman before you use in this step)

Click Done and then Create.

This will create the Business object.

Create Tools

Next step is to create the Tool using the Business Object that we created in the above section.

Click Add.

Select the Tool Type as ‘Business Object’. Type in a Tool Name. Tool Code should auto-populate from the tool name you enter. Enter a Description.

Scroll down. For this tool, I will not need Human in the Loop approvals before running the tool, so I will keep this option disabled.

Under Business object, click on Add.

Search for the business object you created. Select the business object and click Add.

The Business Object will be added in the tool. Select the Function.

Click Create.

Our Business Object Tool is created. Next step is to create our Agent Team.

Create Agent Team

Next step is to create the AI Agent Team. To create the AI Agent Team, navigate to the Agent Teams tab. and click on the Add(+) button.

Under the Details tab, provide a Name for your Agent Team. Agent Team Code should auto-populate. Under Family, select the pillar in which you want to create the Agent in. Select the Product. For this demonstration, I have used HCM and Global Human Resources for the Family and Product respectively. Since we are creating a supervisor agent, I will select the agent Type as Supervisor. Add a Description.

Under the LLM tab, you can select the Large Language Model you want to use for NLP. You can chose to use the default model(GPT-4.1 Mini). Note that this model is free to use.

Or you can chose from the list of other available LLMs. Note that there might be additional charges to use these models. I would highly recommend checking with your Oracle CSM on the usage costs, in case you want to use any of these models.

If you are using one of the paid models, you have the flexibility to restrict the usage.

Under the Security tab, you can specify who should have access to use this Agent Team. If you want to make this Agent Team available for all employees, make sure you enable ‘For all employees’ option.

If you want to restrict the Agent Team to the users who are assigned to a specific role, you can select the appropriate role.

Under the Chat Experience tab, you can Enable file upload and Enable third party file upload options. For this demonstration, I will keep them disabled.

You can set Starter Questions under the Questions tab. Enable AI generated follow-up questions if you want. I will skip for this demonstration.

You can add any input variables under the Input Variables tab.

Click on Create to create your Agent Team.

Add Agent to the Agent Team

Once you have created the Agent Team, next step would be to create the Agent. From the tools panel on the left, click on Agents, as highlighted in the screenshot below. Then click on New Worker Agent, as we want to create a worker agent for this demo. Based on your requirement, you can also chose to add a Supervisor Agent.

The Agent creation panel pops up. Enter the Agent Name, Agent Code, Family and Product. Enter a Description for the Agent. Use the Agent Persona and Role to set the character profile(tone, style, attitude, and behavioural patterns) of the agent.

Use Prompt section to instruct the agent about its tasks, roles and responsibilities. Add guidelines for agent responses. You can instruct the Agent to redact PII information here.

I will leave default values for remainder of the tabs and click on Create. This will create the Agent. Note that we are yet to add our tool to the agent.

To add the tool, select Tools. From the left-hand pane, search for the tool that you created earlier, and add the tool. Click Add.

The tools window pops up. Click Add. Repeat these steps if you want to add more tools to the agent.

Notice that our tool has been added.

Test the Agent Team.

Next step would be to publish the agent. However, before publishing the agent and making it available for business users, you need to test the agent. Click on the Debug button to bring up the chat panel.

Publish Agent Team

To publish the agent team, click on the Publish button on the top-right-hand corner.

You should be able to verify the status from the Agent Teams page. Note that since we have created the Agent Teams from scratch, it has been tagged as a Custom Agent Team.

There you go, we have successfully created a custom AI Agent using a Business Object Tool in Oracle Fusion.

References