Deep Link Tool: Turning insights into Actions

Halton Chen — Thu, 09 Apr 2026 03:41:55 +0000

Introduction

In my previous post, I walked through how to build your first Oracle AI Agent. If you haven’t seen it, I recommend starting there.

This post addresses a more important question:
How do you make an AI agent actually useful in real business workflows?
The answer is simple but often overlooked: you must connect insights to actions.

In Oracle AI Agents, this is achieved through tools, and one of the most powerful types is the Deep Link tool.
Specifically, I’ll show:

What a deep link looks like in an AI agent response
Why it matters
How to configure a deep link tool in Oracle

What does a deep link look like in an AI Agent?

Let’s start with a simple example.
When I ask the agent:
“Show me my incomplete requisitions”
The agent does two things:

Returns the relevant data
Provides a clickable link to each requisition

When I click the link, I’m taken directly to that requisition in Oracle Fusion.
No navigation. No searching. No extra clicks.
This is where AI agents move beyond answering questions — they start enabling real work.

Once we click on “here”, it will automatically link to the requisition page.

Why Deep Links Matter

A deep link is a URL that takes a user directly to a specific page or record inside Oracle Fusion.
Instead of navigating through the UI, the user is routed instantly to the exact destination.

Without deep links, the workflow looks like this:
• Navigate to Procurement
• Open Purchase Requisitions
• Search for the requisition
• Open it

With deep links:
• Click once → land directly on the record
This reduces friction and makes the AI agent actionable, not just informative.

How deep link work in the AI Agent

In the Purchase Requisition Status Advisor, there are three tools:
• Get User Session,
• Purchase Requisition Details,
• View Purchase Requisition Details
The tool "View Purchase Requisition Details" is a deep link tool.

Understanding the deep link configuration

In our case, Oracle provides a standard deep link tool, “ORA_VIEW_PURCHASE_REQUISITION_DETAILS”
Tool Type: Deep Link

The deep link tool is connected with deep link “Deep link that enables employees to view the full details of a requisition.”

The most important part of deep link is the relative url, it tells Oracle which page to open.

/fscmUI/redwood/procurement/requisitions/tabbar/shopping/requisitiondetails?requisitionHeaderId={RequisitionHeaderId}

Key Concepts:
• Relative URL: Everything after your Oracle domain
• Parameter:
requisitionHeaderId={RequisitionHeaderId}

Example: full URL
When you open a requisition in the browser, the full URL looks like below, you can copy it when open a requisition in the browser.

https://yourcompany.oraclecloud.com/fscmUI/redwood/procurement/requisitions/tabbar/shopping/requisitiondetails?requisitionHeaderId=300000303705247&tabSelected=tab_requisitions

The relative URL is just the tail end of the real URL, everything after your company’s Oracle domain name.
The AI agent simply generates this dynamically using the correct ID.

Key Takeaway

Deep links are what make AI agents operational, not just conversational.
They:
• Reduce navigation effort and improve user experience
• Connect AI insights directly to business actions

Oracle AI Agent 101 : Build your first agent step-by-step

Halton Chen — Sat, 04 Apr 2026 23:57:36 +0000

Introduction

Oracle AI Agent Studio enables organizations to rapidly build AI-powered assistants embedded within Oracle Cloud Applications. In this walkthrough, I demonstrate how to create, configure, test, and publish a custom procurement-focused AI agent using an out-of-the-box template.

Procurement users often spend time manually checking requisition status across systems. This agent simplifies that by enabling natural language queries tied directly to transactional data.

What You Will Build

A custom AI Agent for Purchase Requisition status
Integration with business objects and document retrieval (RAG)
Defined topics to control agent scope
A tested and published AI Agent Team

Access Oracle AI Agent Studio

Navigate to Tools → AI Agent Studio within Oracle Cloud Applications. This provides access to prebuilt agent templates that accelerate development.

Create a Custom Agent from Template

Filter templates by Procurement and select a relevant out-of-the-box agent. Use the 'Copy Template' feature to create a custom version. Apply a naming convention (e.g., adding a suffix) to distinguish your agent.

Key Components of an AI Agent

Tools

Defines the additional utilities an agent can use to accomplish a task. One or more tools are assigned to agents, and they're reusable among agents.

List of Tools:

• Calculator tool
• Email tool
• Business object tool: Use Business Object tools when you need structured transactional data (e.g., PR status).
• User query tool
• Document retrieval tool for retrieval-augmented generation (RAG) : Use Document Retrieval (RAG) when answers depend on unstructured knowledge (e.g., policies or documents).

Topics

Defines the areas of expertise through instructions that set the boundaries and constraints for agent conversations and abilities.
Without well-defined topics, the agent may respond outside procurement scope, reducing accuracy.

Configure Agent Details

Review agent configuration including prompts, LLM provider selection, and tool assignments. Save the agent in draft status for further testing.

Configure Agent Team

In Agent Team settings, configure LLM providers, define security roles, and configure starter questions to guide user interaction.

Test Using Debug Mode

Click on the Triangle to run in debug mode.
Use the Debug feature to validate agent responses. Ensure queries return accurate procurement data and remain within defined topic boundaries.

Example: “What is the status of my purchase requisition?”
The agent retrieves real-time data using the business object tool and returns the current approval status.

Publish the Agent

Once validation is complete, publish the agent team to make it available to end users.

Key Takeaways

Templates significantly reduce setup time
Tools extend agent capabilities through integrations
Topics are critical for controlling agent scope
Debugging ensures reliability before deployme

Forem: Halton Chen

Deep Link Tool: Turning insights into Actions

Introduction

What does a deep link look like in an AI Agent?

Why Deep Links Matter

How deep link work in the AI Agent

Understanding the deep link configuration

Key Takeaway

Oracle AI Agent 101 : Build your first agent step-by-step

Introduction

What You Will Build

Access Oracle AI Agent Studio

Create a Custom Agent from Template

Key Components of an AI Agent

Tools

List of Tools:

Topics

Configure Agent Details

Configure Agent Team

Test Using Debug Mode

Publish the Agent

Key Takeaways