AI Agent: Maintenance Advisor

Agent Name:

Maintenance Advisor

Agent Use Case:

Maintenance Advisor enables you to leverage additional guidance and retrieve information from your internal knowledge base (user manuals, maintenance handbooks, and other standard documentation) and maintenance work order service history so that you can expedite the resolution and repair of assets in your organization.

With this capability, the advisor can analyze similar past work orders and pull in relevant repair procedures and troubleshooting content, all in one place.

Use it to: 

  • Reference failure patterns, resolutions, and actions from past repairs.
  • Retrieve manuals and documentation that align with your asset and issue. 
  • Generate smart repair suggestions tailored from your maintenance history.

Agent Description:

A specialized maintenance assistant that helps maintenance technicians research solutions for an issue reported on work order, including finding similar historical repairs, finding related answers in documents, and retrieving details about the work order.

Agent Tools: 

Tool Name Tool Code Tool Type Tool Description Specifications
Maintenance Work Order Tool ORA_MNT_WO_TOOL Business Object This tool retrieves details about a maintenance work order, including the description of the issue being fixed, operations for the fix, the internal work order identifier, and other internal identifiers that are required for other tools. It requires a work order number that's extracted from the user question. A work order number is distinct from an internal work order identifier. The tool returns comprehensive information about the work order, including the work order description, asset details, and item details. Use this tool when you need to find detailed information for a given work order. Use this tool to retrieve work order attributes and information regarding the description and operations. 
Maintenance Work Order History Tool ORA_MNT_WO_HISTORY_TOOL Business Object This tool retrieves details about past work order histories, including the work order number, work order description, and operations for each work order. Use this tool when you need to find work orders that have addressed issues that are similar to the current work order. It requires the WorkOrderNumber and OrganizationCode of the current work order. The tool returns comprehensive information for work orders that's  similar to the current work order. Use this tool to answer questions using service history. Details such as the inspections and repairs done in the past can help you diagnose the current issues.
Maintenance Work Order Doc Tool  ORA_SCM_MAINTENANCE_WO_DOC Document  Use this tool to answer questions by looking up important articles such as frequently asked questions (FAQs), explanations of procedures, how-to guides, manual troubleshooting tips, installation manuals, and best practices in the knowledge base.  Use this tool to answer questions from uploaded documentation in an internal knowledge base. 

Use of institutional knowledge and analysis of past work orders can streamline maintenance troubleshooting activities in organizations and ensure that more informed and timely solutions are taken to repair assets. 

Steps to Enable

You can use AI Agent Studio to use or copy a preconfigured agent template to create Agents for your business processes. To automatically add a suffix to all artifacts in your agent team, you can Copy Template instead of Use Template. When you copy a template, you're directly taken to the agent team canvas where you can edit the agent team settings, agents, tools, and topics. The Use Template option takes you through a step-by-step process for configuring each artifact in the agent team.

For information on using AI Agent Studio, see How do I use AI Agent Studio?

Tips And Considerations

If you created any AI agents in the application before 25C update, we recommend that you replace your existing agent with an agent you create in Oracle AI Agent Studio for Oracle Fusion Cloud Applications. You can migrate the document tool you created for your existing agent to AI Agent Studio. Here’s how:

  1. Go to My Client Groups > Show MoreConfigure RAG Agents.
  2. Click the Tools tab and click Migrate action for your tool.
  3. Enter a unique name and tool code.
  4. Select the relevant family and product for your agent.
  5. Use the tool name to locate your tool in AI Agent Studio.
  6. Click OK.

After your tool is migrated, create a new agent in AI Agent Studio using the appropriate template, add your migrated tool, and publish your agent. Then, create a new guided journey and add an agent task of the type Workflow Agent for the new agent you just created in AI Agent Studio. Next, update the guided journeys with the new journey code where you’ve enabled your previous agent so that the journeys use the new agent. After you have tested and verified your new agent, you can use the Delete action in Configure RAG Agents to remove the original agent.

Key Resources

Access Requirements

To access the Oracle AI Agent Studio for Fusion Applications and manage SCM AI agents, users must be assigned a configured job role that contains these duty roles:

  • SSCM Intelligent Agent Management Duty (ORA_RCS_SCM_AI_AGENT_MANAGEMENT_DUTY and ORA_RCS_SCM_AI_AGENT_MANAGEMENT_DUTY_HCM – both duty role codes are required)
  • Fai Genai Agent SCM Administrator Duty (ORA_DR_FAI_GENERATIVE_AI_AGENT_SCM_ADMINISTRATOR_DUTY)

In the Security Console, filter by Roles and Privileges to find the SCM Intelligent Agent Management Duty role. Filter by Roles and Permission Groups to find the Fai Genai Agent SCM Administrator Duty role.

To interact with AI agents in product pages, users must be assigned a configured job role that contains this duty role:

  • Fai Genai Agent Runtime Duty (ORA_DR_FAI_GENERATIVE_AI_AGENT_RUNTIME_DUTY)

In the Security Console, filter by Roles and Permission Groups to find this duty role.

To allow users to interact with agents, you must also enable permission groups in the Security Console on those users’ configured job roles that contain the Fai Genai Agent Runtime Duty role. You can enable permission groups when you manage the basic information of your configured job roles.

Users’ configured job roles must also contain privileges that allow access to the pages where AI agents are enabled.