1. Implementing Your Cloud Integrations
  2. Adding AI Agents to Application Pages

Adding AI Agents to Application Pages

Use Visual Builder Studio to add page-integrated AI agents to supported Redwood pages in Oracle Permitting and Licensing. Page-integrated agents can appear as an AI Assist button or a similar page action that opens an AI agent for agency staff.

Use these instructions when the setup for a delivered AI agent indicates adding or exposing an agent on an application page. For AI agents that are embedded in an application flow, invoked by Business Rules Framework, exposed from a landing page tile, scheduled in AI Agent Studio, or delivered as part of an agentic app, refer to the setup information for the specific AI functionality.

For more information about which AI agents are page-integrated, see Delivered AI Agents and Agentic Apps,

For general information about using AI Agent Studio, see Oracle AI for Fusion Applications: How do I use AI Agent Studio?

Before You Begin

Before adding an AI agent to a page:

  • Confirm that the agent is page-integrated.

  • Enable AI functionality for the applicable offering, if required setup for the agent.

  • Complete security setup for the users who will access the agent.

  • Configure and publish the agent in AI Agent Studio, if required.

  • Record the published agent team code.

  • Confirm that the page is a Redwood page that supports Visual Builder Studio extensibility.

For information about access requirements for AI Agent Studio, see Provide Access to Configure AI Agents in Oracle Permitting and Licensing.

Adding AI Agents to Pages

You can add an AI agent to a page only when the page or fragment supports extensibility. To support extensibility, the page or fragment must include one of these dynamic components:

  • Dynamic Container

  • Dynamic Table

  • Dynamic Form

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

Agencies can also create custom pages by using advanced extensibility. After deployment, the agency can create root menu tiles or quick action links to access the custom page.

Adding an AI Agent in Express Mode

Use Express Mode when the AI agent can be configured through an extensible constant on the page.

  1. Navigate to the Redwood page that you want to extend.

  2. Open the Settings and Actions menu and select Edit Page.

  3. Select Express Mode.

  4. Locate the constant for the AI agent on the page.

  5. Update the constant to show the agent and use the published agent team code.

    For example:

    {
  "showAgent": true,
  "agentTeamCode": "AGENCY_BUSINESS_LICENSE_ASSISTANT",
  "agentParameters": {
    "LnpRecordKey": $base.variables.recordKey
  }
}

  6. Preview the changes and test the AI Assist button then publish the changes.

Adding an AI Agent in Advanced Mode

Use Advanced Mode only when the setup information for the agent or page instructs you to configure the agent through an extensible fragment.

  1. Navigate to the Redwood page that you want to extend.

  2. Open the Settings and Actions menu and select Edit Page.

  3. Select Advanced Mode.

  4. Locate and open the extensible fragment for the page.

  5. Locate the constant for the AI agent.

  6. Update the constant to show the agent and use the published agent team code.

    For example:

    {
  "showAgent": true,
  "agentTeamCode": "AGENCY_BUSINESS_LICENSE_ASSISTANT",
  "agentParameters": {
    "LnpRecordKey": $base.variables.recordKey
  }
}

  7. Preview the changes and test the AI Assist button then publish the changes.

Configuring Agent Parameters

Use the AI agent constant to control whether the AI Assist button appears and which agent opens.

Parameter

Description

showAgent

Shows or hides the AI Assist button or page action. Set to true to show the agent.

agentTeamCode

Identifies the published agent team to open from the page. Use the exact code from the published agent team.

agentParameters

Passes page context to the agent, such as the record key. Configure parameters only when required by the setup topic or page context.

Some page-integrated agents require context parameters. For example, an application detail page may pass a record key so the agent can respond in the context of the current record. Don’t remove existing parameters or copy parameters from another page unless the setup for the agent instructs you to do so.

Extensible Pages

Agencies can use page extensibility to add AI agents to supported Redwood pages. Availability depends on the page, extension point, configured agent, and user security.

  • Permits

    • Permit Applications list page

    • Permit application detail page header

  • Planning and Zoning

    • Planning Applications list page

    • Planning application detail page header

  • Business Licenses

    • License Applications list page

    • License application detail page header

  • Code Enforcement

    • Incidents list page

    • Incident detail page header

    • Cases list page

    • Case detail page header

  • List Pages

    • Addresses list page and detail page header

    • Parcels list page and detail page header

    • Businesses list page and detail page header

    • Contractors list page and contractor detail page header

  • Public Application Pages

    • Apply page, also called the What would you like to apply for? page

  • Inspector Application

    For inspectors performing permit and business license inspections, these pages are extensible:

    • Inspection Tasks page

    • Inspection overview panel in inspection details

    • Inspection Result page