Setting Up the Code Enforcement Incident Workspace Agentic App

Set up the Code Enforcement Incident Workspace Agentic App to provide a centralized workspace where code technicians can review AI-generated incident recommendations, execute recommended actions, and monitor active code enforcement incidents. This topic describes the prerequisites, Business Rules Framework configuration, workflow agent requirements, and verification steps needed to configure and deploy the Agentic App.

Overview

The Code Enforcement Incident Workspace Agentic App provides a centralized workspace where code technicians can review AI-analyzed code enforcement incidents, view recommended actions, and execute those actions without navigating to individual incident records.

The Agentic App orchestrates multiple workflow agents to provide an AI-assisted experience. These workflow agents analyze reported incidents, summarize active incidents, and execute incident-related actions such as updating priorities, closing duplicate incidents, and scheduling inspections. The app also generates communications for overdue incidents when applicable.

The Code Enforcement Incident Workspace Agentic App uses the following workflow agents:

• Code Enforcement Incoming Incident Evaluation Assistant – Retrieves AI-generated recommendations for reported incidents and enables users to perform incident actions.

• Code Enforcement Active Incident Summary Generator– Generates summaries, charts, communications, and priority actions for active incidents.

• Inspection Scheduling Agent – Schedules inspections when users choose the Schedule Inspection action.

Here's what the workflow agent does:

• Analyze the reported incident.

• Detect duplicate incidents.

• Validate issue type and subtype.

• Review nearby violations.

• Generate AI recommendations.

• Store the analysis in the AI persistent table.

The agentic app retrieves this stored information and displays it in the Reported Incident Smart Analysis panel.

How the Agentic App is Invoked

The Agentic App is launched when a user opens the Code Enforcement Incident Workspace.

Before users interact with the workspace, AI analysis is performed during incident creation. A Business Rules Framework (BRF) rule invokes the incident review workflow agent whenever a code enforcement incident is submitted. The workflow agent analyzes the incident, generates AI recommendations, and stores the results in the AI persistent table. The Agentic App retrieves these results and displays them in the workspace.

When the workspace loads, it invokes the configured workflow agents by passing predefined Aura Message Hint values. These values determine which workflow branch executes and how the app initializes its content. Common Aura Message Hint values include:

• summary – Displays the workspace summary.

• initSubtitle – Displays the workspace subtitle.

• initDisplay – Populates workspace panels.

• initActions – Initializes available actions.

• initCommunications – Initializes communication content.

• invokeAction – Executes actions selected by the user.

Before You Begin

Before configuring the Code Enforcement Incident Workspace Agentic App, ensure that:

• AI capabilities are enabled for Code Enforcement.

• Oracle AI Agent Studio is available.

• Oracle Agentic Apps are enabled.

• Business Rules Framework is configured.

• The required workflow agents have been created.

• Each workflow agent includes the required Aura Message Hint switch cases.

• The workflow agents have been configured for use with Agentic Apps.

• You have the required administrative privileges.

For workflow agents used by Agentic Apps, the predefined Aura Message Hint values are mandatory and must be implemented as switch cases in the workflow. These values shouldn't be modified.

Enabling AI for Code Enforcement

Enable AI capabilities before configuring the Agentic App.

1. Sign in with administrator privileges.

2. Enable AI for the Code Enforcement offering.

3. Verify that the required AI models are available.

4. Deploy the workflow agents used by the Agentic App.

5. Publish the Agentic App after configuration is complete.

Only workflow agents that are configured to be exposed to Agentic Apps are available for selection in the Agentic App Builder.

Reviewing Access Requirements

Ensure that administrators and end users have the appropriate access to configure and use the Agentic App.

Administrators should have access to:

• Code Enforcement

• Business Rules Framework

• AI Agent Studio

• Workflow Agent Builder

• Agentic App Builder

Users who execute incident actions should have the appropriate Code Enforcement security privileges. Incident actions such as Close as Duplicate, Update Priority, and Schedule Inspection require a Code Technician assignment. If a user who isn't assigned as a Code Technician attempts to perform one of these actions, the workflow returns a validation message instead of executing the action.

Configuring the Business Rules Framework Rule

Configure a Business Rules Framework (BRF) rule to invoke the AI workflow whenever a new code enforcement incident is created.

Rule Setup	Description
Event	Create a rule that is triggered when a code enforcement incident is created or submitted.
Criteria	Specify the conditions under which the workflow should run. For example, configure the rule so that AI analysis runs only for incidents whose status is Reported.
Action: Call workflow agent	Configure the rule to invoke the workflow agent responsible for incident analysis. Configure the workflow action using values similar to the following: Family: Code Enforcement Product: Code Enforcement Agent: Incident Review workflow agent (or the deployed workflow agent that performs incident analysis) Use the workflow agent that generates AI recommendations and stores the analysis in the AI persistent table.

For more information about setting up the Business Rules Framework, see Business Rules Framework Overview.

Verifying the Agentic App

After completing the configuration:

1. Open the Code Enforcement Incident Workspace Agentic App.

2. Verify that the workspace loads successfully.

3. Confirm that the following workspace components are displayed:

   • Workspace summary

   • Reported Incident Smart Analysis panel

   • Active Incident Summary panel

   • Priority Actions

   • Communications

4. Verify that AI recommendations are displayed for reported incidents.

5. Select one of the available actions, such as:

   • Update Priority

   • Close as Duplicate

   • Schedule Inspection

6. Confirm that:

   • The corresponding workflow agent is invoked.

   • The business object executes successfully.

   • A confirmation message is displayed.

7. Refresh the workspace and verify that the latest incident data is displayed.

You can also test workflow agents independently by using the Preview feature in Workflow Agent Builder and supplying the appropriate Aura Action payload instead of launching the Agentic App.