Integrating with AI Agents

This topic describes how to extend the pages in Oracle Permitting and Licensing to add AI agent functionality.

Your agency can use AI functionality including AI agents on pages to help users with various tasks.

Steps for Enabling AI Agents

Let's take a look at the steps for getting started with AI agents:

Enable AI functionality at the offering level in Functional Setup Manager.
In the AI Agent Studio, find the AI agent that you want to make available to agency staff.
Click the Copy Template button or use the AI agent as delivered. Click Publish.
On the Agent Teams page, note the Agent Team Code for the published agent team.
Go to an AI-ready page for the offering in the Redwood Experience interface. For example, you can embed an AI Assist button on these pages for agency staff: list and detail pages for Addresses, Parcels, Businesses, and Contractors.
In the lower right corner of the page, hover over the Ask Oracle icon to view the Edit Page in Visual Builder Studio pencil icon. Click the pencil icon button on the left:
Associate the desired agent with the AI Assist button.

In express extensibility, update parameters with the agent team code as it appears on the Agent Teams page. For example, you can add a value like this to the agent constant:
```
{

    "showAgent": true,

    "agentTeamCode": "PUBLIC_SECTOR_CONTRACTOR_LICENSE_AGENT_COPY"

}
```
The AI Assist button appears on the page and any other existing actions are moved to the three-dot Actions menu.

See details in the next sections for more information.

Enabling AI Functionality By Offering

Your agency enables AI functionality for each offering in Functional Setup Manager prior to use within Oracle Permitting and Licensing. Here's how to enable AI functionality for each offering:

Go to the Functional Setup Manager by selecting Setup and Maintenance > Offering: <Select from Drop-Down List>.
On the Setup page, click the Change Feature Opt In link.
On the Opt In page, click the Features pencil icon in the top Public Sector <Offering> row.
Select the Enable check box for the Enable AI Functionality for <Offering> checkbox.
Click Done.

Adding AI Agents to Pages

Here's how to add AI Agents to pages in Oracle Permitting and Licensing.

To support extensibility out-of-the-box, the page or fragment needs to have one of these dynamic components implemented and enabled for extensibility:

Dynamic Container
Dynamic Table
Dynamic Form

AI agent functionality for specific products can also be extensible using extensible constants.

As an agency, you can also create your own page using advanced extensibility, and after deployment, you can create root menu tiles or quick action links to access the page.

Extensibility Steps

You can use express mode or advanced mode to add a button or link to use an AI agent directly on a page. A page must be extensible to embed the AI functionality.

This is what express mode looks like:

Navigate to the page and click Edit Page in Visual Builder.
Select Express Mode.

Locate a constant for the AI agent on the page.

Here's an example; the constant will have a format like this:

{   

 "showAgent": true,

"agentTeamCode":"AGENCY_BUSINESS_LICENSE_ASSISTANT",

"agentParameters": {"LnpRecordKey":  $base.variables.recordKey}

}

Preview the changes and test.
Publish the changes.

Here's how to use advanced mode:

Navigate to the page and click Edit Page in Visual Builder.
Select Advanced Mode.
Through documentation, search the extensible fragment and open it.

Locate a constant for the AI agent on the page.

Here's an example; the constant will have a format like this:

{   

 "showAgent": true,

"agentTeamCode":"AGENCY_BUSINESS_LICENSE_ASSISTANT",

"agentParameters": {"LnpRecordKey":  $base.variables.recordKey}

}

Preview the changes and test.
Publish the changes.

Extensible Pages

Agencies use express mode to show or hide the AI Assist button in page header regions.

Here are some of the available pages that can be extended with AI agent functionality using the extensibility steps provided in this topic:

Permit Applications list page and detail page header
Planning Applications list page and detail page header
License Applications list page and detail page header
Incidents list page and detail page header
Cases list page and detail page header
Addresses list page and detail page header
Parcel list page and detail page header
Apply page (What would you like to apply for? page)

Agencies can also add the assist button to these pages for use by agency staff:

Addresses list and detail pages
Parcels list and detail pages
Businesses list and detail pages
Contractors list and detail pages