ORACLE AI AGENT STUDIO
Unofficial Technical Documentation – 25D
Table of Contents
1. Introduction
2. Monitor and Evaluate AI Agents
3. AI Agent Workflows
4. Access Requirements and Security Configuration
o 4.1 Prerequisites for Permission Groups
o 4.2 Assigning Predefined Duty Roles
o 4.3 Product-Specific Access Configuration
5. Agent Task Type Integration
o 5.1 External Guided Journeys
o 5.2 Section Level Guided Journeys
6. AI Agent Studio Core Features
7. Exploring AI Agents
8. Profile Options Reference
9. Security Privileges Reference
10. Key Resources and Documentation
1. Introduction
Oracle AI Agent Studio is a comprehensive design-time environment that empowers organizations to
create, configure, validate, and deploy Generative AI (GenAI) features and AI agents tailored to meet
specific business needs. This fully integrated solution within Oracle Fusion Cloud Applications provides
secure and seamless access to knowledge stores, tools, and APIs, enabling direct deployment of agents
into business workflows.
Navigation Path: Navigator → Tools → AI Agent Studio
2. Monitor and Evaluate AI Agents
2.1 Overview
AI Agent Studio now provides comprehensive monitoring and evaluation capabilities that allow
organizations to track agent performance, understand usage patterns, identify common errors, and
measure overall effectiveness in real-world scenarios.
2.2 Accessing Monitoring and Evaluation
Navigation: AI Agent Studio → Monitoring and Evaluation tab
2.3 Key Capabilities
• Interaction Tracking: Monitor all agent interactions and conversations
• Usage Pattern Analysis: Understand how agents are being utilized across the organization
• Error Identification: Identify and analyze common errors and performance issues
• Performance Measurement: Evaluate agent accuracy and effectiveness metrics
• Real-world Usage Insights: Gain insights into actual deployment performance
2.4 Prerequisites
• Access to AI Agent Studio (see Section 4: Access Requirements)
• Appropriate monitoring privileges configured
3. AI Agent Workflows
3.1 Workflow Overview
AI Agent Studio introduces predefined workflows that represent business processes as connected
sequences of nodes. Each node performs specific functions and passes output to subsequent steps,
ensuring predictable and structured automation.
3.2 Workflow vs. Hierarchical Agent Teams
Feature Workflows Hierarchical Agent Teams
Execution Order Fixed, predetermined sequence Based on LLM reasoning and context
Predictability High - follows strict order Variable - depends on AI decision-making
Use Case Business processes requiring strict execution order Complex reasoning tasks requiring flexibility
Control Deterministic Adaptive
3.3 Workflow Node Types
Workflows support various node types including:
• Data Extraction Nodes: Extract and process data from various sources
• Business Object Nodes: Interact with Fusion Applications business objects
• LLM Nodes: Execute large language model operations
• Email Nodes: Send communications through integrated email systems
• Custom Action Nodes: Perform specialized business logic
3.4 Creating Workflows
Steps:
1. Navigate to AI Agent Studio
2. Select "Workflow" as the agent team type
3. Configure the predetermined sequence of nodes
4. Define input/output relationships between nodes
5. Test and validate the workflow
6. Deploy to production environment
3.5 Prerequisites
• Access to AI Agent Studio (see Section 4: Access Requirements)
4. Access Requirements and Security Configuration
4.1 Prerequisites for Permission Groups
Before configuring AI Agent Studio access, ensure the Security Console is properly configured for external
application integration.
4.1.1 Required Profile Option Configuration
Profile Option: ORA_ASE_SAS_INTEGRATION_ENABLED
• Name: Enable Security Console External Application Integration
• Level: Site level
• Required Value: Yes
4.1.2 Configuration Steps
1. Navigate to Setup and Maintenance work area
2. Search for "Manage Administrator Profile Values" task
3. Locate profile option ORA_ASE_SAS_INTEGRATION_ENABLED
4. Set Site profile level value to "Yes"
5. Save configuration
4.2 Assigning Predefined Duty Roles
4.2.1 Important Considerations
⚠ Caution: Using predefined roles might account for subscription consumption regardless of whether
you purchased the cloud service. See Oracle's "Guidance for Assigning Predefined Roles" documentation.
4.2.2 Access to All Products Configuration
Navigation: Navigator → Tools → Security Console
Steps:
1. Create new custom job role with permission groups enabled
2. Navigate to Role Hierarchy page → Roles and Permission Groups tab
3. Add the following duty roles:
Duty Role Code Description
ORA_DR_FAI_GENERATIVE_AI_AGENT_CX_ADMINISTRATOR_DUTY Fai Genai Agent CX Administrator Duty
ORA_DR_FAI_GENERATIVE_AI_AGENT_FIN_ADMINISTRATOR_DUTY Fai Genai Agent FIN Administrator Duty
ORA_DR_FAI_GENERATIVE_AI_AGENT_GRC_ADMINISTRATOR_DUTY Fai Genai Agent GRC Administrator Duty
ORA_DR_FAI_GENERATIVE_AI_AGENT_HCM_ADMINISTRATOR_DUTY Fai Genai Agent HCM Administrator Duty
ORA_DR_FAI_GENERATIVE_AI_AGENT_PRC_ADMINISTRATOR_DUTY Fai Genai Agent PRC Administrator Duty
ORA_DR_FAI_GENERATIVE_AI_AGENT_PRJ_ADMINISTRATOR_DUTY Fai Genai Agent PRJ Administrator Duty
ORA_DR_FAI_GENERATIVE_AI_AGENT_PSC_ADMINISTRATOR_DUTY Fai Genai Agent PSC Administrator Duty
ORA_DR_FAI_GENERATIVE_AI_AGENT_SCM_ADMINISTRATOR_DUTY Fai Genai Agent SCM Administrator Duty
4. Additional Role Requirement: If user lacks
ORA_ASM_APPLICATION_IMPLEMENTATION_CONSULTANT_JOB (Application Implementation
Consultant) job role, add ORA_FAI_MANAGE_ALL_AI_AGENTS (Manage All Intelligent Agents) from
Roles and Privileges tab
5. Save custom role and assign to appropriate users
4.3 Product-Specific Access Configuration
4.3.1 Oracle Fusion Cloud Human Capital Management (HCM)
For Users WITHOUT HCM Application Administrator Job Role:
1. Create new custom job role (permission groups enabled)
2. Roles and Privileges tab: Add ORA_HRC_HCM_AI_AGENT_MANAGEMENT_DUTY (Manage HCM
Intelligent Agent)
3. Roles and Permission Groups tab: Add
ORA_DR_FAI_GENERATIVE_AI_AGENT_HCM_ADMINISTRATOR_DUTY (Fai Genai Agent HCM
Administrator Duty)
4. Save and assign to appropriate job roles
For Users WITH HCM Application Administrator Job Role:
1. Create new custom job role (permission groups enabled)
2. Roles and Permission Groups tab: Add
ORA_DR_FAI_GENERATIVE_AI_AGENT_HCM_ADMINISTRATOR_DUTY
3. Save and assign to appropriate job roles
4.3.2 Oracle Fusion Cloud Supply Chain & Manufacturing (SCM)
For Users WITHOUT Supply Chain Application Administrator Job Role:
1. Create new custom job role (permission groups enabled)
2. Roles and Privileges tab: Add:
o ORA_RCS_SCM_AI_AGENT_MANAGEMENT_DUTY (SCM Intelligent Agent Management Duty)
o ORA_RCS_SCM_AI_AGENT_MANAGEMENT_DUTY_HCM (SCM Intelligent Agent Management Duty
HCM)
3. Roles and Permission Groups tab: Add
ORA_DR_FAI_GENERATIVE_AI_AGENT_SCM_ADMINISTRATOR_DUTY
4. Save and assign to appropriate job roles
For Users WITH Supply Chain Application Administrator Job Role:
1. Navigation: Navigator → Tools → Security Console
2. Search for ORA_RCS_SUPPLY_CHAIN_APPLICATION_ADMINISTRATOR_JOB (Supply Chain Application
Administrator)
3. Edit the job role
4. Enable permission groups
5. Save job role
4.3.3 Oracle Fusion Cloud Procurement (PRC)
For Users WITHOUT Procurement Application Administrator Job Role:
1. Create new custom job role (permission groups enabled)
2. Roles and Privileges tab: Add:
o ORA_PO_PRC_AI_AGENT_MANAGEMENT_DUTY (PRC Intelligent Agent Management Duty)
o ORA_PO_PRC_AI_AGENT_MANAGEMENT_DUTY_HCM (PRC Intelligent Agent Management Duty
HCM)
3. Roles and Permission Groups tab: Add
ORA_DR_FAI_GENERATIVE_AI_AGENT_PRC_ADMINISTRATOR_DUTY
4. Save and assign to appropriate job roles
For Users WITH Procurement Application Administrator Job Role:
1. Navigation: Navigator → Tools → Security Console
2. Search for ORA_PO_PROCUREMENT_APPLICATION_ADMIN_JOB (Procurement Application
Administrator)
3. Edit the job role
4. Enable permission groups
5. Save job role
4.3.4 Oracle Permitting and Licensing (PSC)
For Users WITHOUT PSC Application Administrator Job Role:
1. Create new custom job role (permission groups enabled)
2. Roles and Privileges tab: Add:
o ORA_PSC_AI_AGENT_MANAGEMENT_DUTY (PSC Intelligent Agent Management)
o ORA_PSC_AI_AGENT_MANAGEMENT_DUTY_HCM (PSC Intelligent Agent Management HCM)
3. Roles and Permission Groups tab: Add
ORA_DR_FAI_GENERATIVE_AI_AGENT_PSC_ADMINISTRATOR_DUTY
4. Save and assign to appropriate job roles
For Users WITH PSC Application Administrator Job Role:
1. Create new custom job role (permission groups enabled)
2. Roles and Permission Groups tab: Add
ORA_DR_FAI_GENERATIVE_AI_AGENT_PSC_ADMINISTRATOR_DUTY
3. Save and assign to appropriate job roles
5. Agent Task Type Integration
5.1 External Guided Journeys
5.1.1 Overview
External enabled guided journeys now support the Agent task type alongside existing task types (External
URL, Manual Task, and Video). This enhancement allows users to leverage AI capabilities for external
guided journeys.
5.1.2 Supported Agent Types
Agent Type External Guided Journey Support
Workflow Agent ✅ Supported
RAG Agent ❌ Not Supported
5.1.3 Configuration Requirements
Required Profile Option:
• Code: ORA_PER_AGENT_TASK_TYPE_GUIDED_JOURNEYS_ENABLED
• Name: Agent Task Type Enabled for Guided Journeys
• Default Value: N (Disabled)
• Required Value: Y (Enabled)
5.1.4 Key Capabilities
• Multi-agent workflow integration
• Interactive application engagement
• Seamless external journey enhancement
5.1.5 Access Requirements
Required Privilege: HRC_ACCESS_AI_AGENT_CHAT_PRIV (Access Intelligent Agent Chat)
Configuration Steps:
1. Add function privilege to custom roles
2. Refer to Release 13 Oracle HCM Cloud Security Upgrade Guide (Document ID 2023523.1)
3. See Security Reference for Common Features guide
5.2 Section Level Guided Journeys
5.2.1 Overview
AI-based Agent task types can now be displayed in section level guided journeys on Redwood pages,
extending beyond page level implementations.
5.2.2 Key Benefits
• Contextual AI Support: Leverage AI capabilities at the section level within transactions
• Enhanced User Experience: Find relevant answers within specific transaction contexts
• Seamless Integration: Native integration with Redwood page architecture
5.2.3 Configuration Requirements
Required Profile Option:
• Code: ORA_PER_AGENT_TASK_TYPE_GUIDED_JOURNEYS_ENABLED
• Name: Agent Task Type Enabled for Guided Journeys
• Default Value: N
• Required Value: Y
5.2.4 Implementation Considerations
Consideration Details
Scope Only available in guided journeys
Platform Redwood pages only
Data Persistence Interactions displayed on UI only, not stored
Task Library Cannot be created in task library or task groups
5.2.5 Access Requirements
Required Privilege: HRC_ACCESS_AI_AGENT_CHAT_PRIV (Access Intelligent Agent Chat)
6. AI Agent Studio Core Features
6.1 Overview
AI Agent Studio serves as a comprehensive design-time environment integrated into Fusion Applications,
providing secure access to knowledge stores, tools, and APIs.
6.2 Core Capabilities
6.2.1 Agent and Team Management
• Template Instantiation: Configure and deploy predefined Agents and Agent Teams templates
• Custom Development: Create custom Agents and Agent Teams from scratch
• Extension: Extend pre-configured agent templates
6.2.2 Tool and Topic Management
• Custom Tools: Create specialized tools for agent functionality
• Topic Configuration: Define and manage conversation topics
• Knowledge Integration: Upload documents for semantic search capabilities
6.2.3 Debugging and Testing
• Environment Debugging: Debug Agents and Agent Teams within your environment
• Validation: Validate agent configurations before deployment
• Testing: Comprehensive testing capabilities
6.2.4 Integration Capabilities
Agents can be configured to:
Capability Description
Business Object Integration Retrieve or take actions on Fusion Applications business objects (including custom objects)
Email Integration Send emails through Oracle Fusion Cloud HCM Alert system to specific roles
Deep Linking Provide deep links within Fusion Applications
Mathematical Operations Perform complex mathematical calculations
6.3 Prerequisites
6.3.1 Platform Requirements
• Oracle Applications Platform: Appropriate services must be deployed
• Reference: FAQ2521 on My Oracle Cloud Support
6.3.2 Security Configuration
• Profile Option: ORA_ASE_SAS_INTEGRATION_ENABLED set to Yes
• Permission Groups: Enable for appropriate roles
• Reference: Section 4: Access Requirements
7. Exploring AI Agents
7.1 AI Agents Page Overview
The AI Agents page provides a centralized interface for viewing and interacting with all available AI
Agents within your organization.
7.2 Access Methods
URL Pattern: [Base_URL]/fscmUI/redwood/human-resources/ai-studio/agent-explore
Example: https://example.com/fscmUI/redwood/human-resources/ai-studio/agent-explore
7.3 Available Functions
Function Description
Agent Search Search for available agents across the platform
Conversation History View previous conversations with agents
Chat Sessions Start new or resume existing chat sessions
Issue Identification Identify if there are open issues with any agent
7.4 Prerequisites
7.4.1 Required Profile Option
• Code: ORA_HCM_VBCS_PWA_ENABLED
• Name: Enable VBCS Progressive Web Application User Interface
• Required Value: Yes
7.4.2 Security Requirements
• Add required privileges and duty roles
• Reference: "How can I give users access to AI agents?" documentation
8. Profile Options Reference
8.1 Complete Profile Options List
Profile Option Code Display Name Default Purpose
Value
ORA_ASE_SAS_INTEGRATION_ENABLED Enable Security N/A Enable
Console External Security
Application Console for AI
Integration Agent Studio
ORA_PER_AGENT_TASK_TYPE_GUIDED_JOURNEYS_ENABLED Agent Task Type N Enable Agent
Enabled for Guided task type in
Journeys guided
journeys
ORA_HCM_VBCS_PWA_ENABLED Enable VBCS N/A Enable AI
Progressive Web Agents page
Application User access
Interface
8.2 Profile Option Configuration
Navigation: Setup and Maintenance → Manage Administrator Profile Values
Steps:
1. Search for the specific profile option code
2. Set the appropriate profile level (Site, Application, Responsibility, or User)
3. Enter the required value
4. Save configuration
5. Verify activation
9. Security Privileges Reference
9.1 Key Privileges
Privilege Code Display Name Purpose
HRC_ACCESS_AI_AGENT_CHAT_PRIV Access Intelligent Agent Chat Access agent chat functionality
ORA_FAI_MANAGE_ALL_AI_AGENTS Manage All Intelligent Agents Comprehensive agent management
9.2 Duty Roles by Product
9.2.1 Cross-Product Duty Roles
Code Product Description
ORA_DR_FAI_GENERATIVE_AI_AGENT_CX_ADMINISTRATOR_DUTY CX Customer Experience AI
Agent Administration
ORA_DR_FAI_GENERATIVE_AI_AGENT_FIN_ADMINISTRATOR_DUTY Finance Financial AI Agent
Administration
ORA_DR_FAI_GENERATIVE_AI_AGENT_GRC_ADMINISTRATOR_DUTY GRC Governance, Risk, and
Compliance AI Agent
Administration
ORA_DR_FAI_GENERATIVE_AI_AGENT_HCM_ADMINISTRATOR_DUTY HCM Human Capital
Management AI Agent
Administration
ORA_DR_FAI_GENERATIVE_AI_AGENT_PRC_ADMINISTRATOR_DUTY Procurement Procurement AI Agent
Administration
ORA_DR_FAI_GENERATIVE_AI_AGENT_PRJ_ADMINISTRATOR_DUTY Projects Project Management AI
Agent Administration
ORA_DR_FAI_GENERATIVE_AI_AGENT_PSC_ADMINISTRATOR_DUTY PSC Permitting and Licensing
AI Agent Administration
ORA_DR_FAI_GENERATIVE_AI_AGENT_SCM_ADMINISTRATOR_DUTY SCM Supply Chain
Management AI Agent
Administration
9.2.2 Product-Specific Management Duties
Code Product Description
ORA_HRC_HCM_AI_AGENT_MANAGEMENT_DUTY HCM HCM-specific agent management
ORA_RCS_SCM_AI_AGENT_MANAGEMENT_DUTY SCM SCM-specific agent management
ORA_RCS_SCM_AI_AGENT_MANAGEMENT_DUTY_HCM SCM SCM agent management with HCM
integration
ORA_PO_PRC_AI_AGENT_MANAGEMENT_DUTY Procurement Procurement-specific agent management
ORA_PO_PRC_AI_AGENT_MANAGEMENT_DUTY_HCM Procurement Procurement agent management with HCM
integration
ORA_PSC_AI_AGENT_MANAGEMENT_DUTY PSC PSC-specific agent management
ORA_PSC_AI_AGENT_MANAGEMENT_DUTY_HCM PSC PSC agent management with HCM
integration
9.2.3 Standard Job Roles
Code Description
ORA_ASM_APPLICATION_IMPLEMENTATION_CONSULTANT_JOB Application Implementation Consultant
ORA_RCS_SUPPLY_CHAIN_APPLICATION_ADMINISTRATOR_JOB Supply Chain Application Administrator
ORA_PO_PROCUREMENT_APPLICATION_ADMIN_JOB Procurement Application Administrator
10. Key Resources and Documentation
10.1 Oracle Documentation References
Resource Description Reference
Implementing and Using Journeys Comprehensive guide for journey Oracle Help Center
Guide implementation
Security Reference for Common Security privilege documentation Oracle Help Center
Features
Oracle HCM Cloud Security Release 13 security implementation My Oracle Support (Document ID
Upgrade Guide 2023523.1)
10.2 What's New Documentation
Release Feature Documentation
25A AI Agent Task Type for Guided Journeys What's New, 25A
25C Oracle AI Agent Studio for Fusion Applications What's New, 25C
10.3 Support Resources
Resource Location Purpose
FAQ2521 My Oracle Cloud Support Platform deployment requirements
Document ID 2023523.1 My Oracle Support HCM security upgrade guide
Guidance for Assigning Predefined Roles Oracle Documentation Role assignment best practices
10.4 Cross-References
• Access Configuration: See Section 4: Access Requirements and Security Configuration
• Profile Options: See Section 8: Profile Options Reference
• Security Privileges: See Section 9: Security Privileges Reference
• Monitoring: See Section 2: Monitor and Evaluate AI Agents
• Workflows: See Section 3: AI Agent Workflows
Appendices
Appendix A: Quick Start Checklist
Prerequisites Verification
• [ ] Oracle Applications Platform services deployed
• [ ] ORA_ASE_SAS_INTEGRATION_ENABLED profile option set to Yes
• [ ] Permission groups enabled for relevant roles
Basic Access Configuration
• [ ] Identify required product areas (HCM, SCM, Procurement, etc.)
• [ ] Create custom job roles with permission groups enabled
• [ ] Assign appropriate duty roles based on product requirements
• [ ] Configure required profile options
• [ ] Test access to AI Agent Studio
Feature Enablement
• [ ] Enable monitoring and evaluation features
• [ ] Configure workflow capabilities if needed
• [ ] Set up guided journey integration if required
• [ ] Enable AI Agents page access if needed
Appendix B: Troubleshooting Guide
Common Issues and Solutions
Issue Symptoms Solution
Access Denied Cannot access AI Agent Verify duty roles and permission groups configuration
Studio
Profile Option Not Features not appearing Check profile option values and levels
Working
Agent Task Type Agent option not visible Enable
Missing in guided journeys ORA_PER_AGENT_TASK_TYPE_GUIDED_JOURNEYS_ENABLED
Monitoring Cannot access Verify access requirements and platform deployment
Unavailable monitoring tab
Diagnostic Steps
1. Verify profile option configurations
2. Check role assignments and privilege grants
3. Confirm platform service deployment
4. Review security console configuration
5. Test with minimal privilege set first
This document serves as a technical reference for implementing and managing Oracle AI Agent Studio within
Oracle Fusion Cloud Applications environments. Prepared for personal technical reference material for 25D.
