Setting Up Call Workflow Agent Actions

This topic describes how to configure a Business Rules Framework action to call a workflow agent in AI Agent Studio.

Use the Call workflow agent action to call an AI agent of type Workflow when the criteria for a business rule are met. This action is currently available for many events, such as the Incident Status Updated event for the Code Enforcement Incident resource. The workflow agent supports the trigger and input expected by the Business Rules Framework action. For the delivered Code Enforcement use case, the workflow agent expects the incident ID.

Note:

The Call workflow agent action is broadly available for supported events and isn’t repeated in the Business Rules Framework Event Details documentation in every individual event entry. You can identify whether the Call workflow agent action is available for an event in the Business Rules Framework by checking whether Call workflow agent appears in the Action Name list when adding an action to the rule.

A workflow agent is an AI Agent Studio agent team that runs a predetermined sequence of nodes. Each node performs a defined task, such as extracting data, calling a business object function, running an LLM, or sending an email. Workflow agents are created and published in AI Agent Studio before they can be called from the Business Rules Framework.

Note:

The Business Rules Framework doesn’t create or deliver the workflow agent. The business rule action submits the call to the selected workflow agent. Any downstream processing performed by the agent is managed by the workflow agent.

Configuring the Call Workflow Agent Action

To configure a Call workflow agent action:

1. Open the Business Rules Framework page.

2. Select the Code Enforcement offering.

3. Search for and open the Incident Status Updated event.

4. On the event details page, create a business rule or open an existing rule.

5. In the Criteria section, define the conditions that determine when the workflow agent should be called.

   For example, configure criteria so the action runs only for the incident status changes that should trigger the workflow agent.

   For more information about defining rule criteria, see Setting Up Business Rule Criteria. The criteria topic explains that rule criteria evaluate fields from the underlying event resource and other available criteria sources.

6. Expand the Actions section.

7. Click Add.

8. From the Action Name drop-down list, select Call workflow agent.

9. Click the Configure link for the Call workflow agent action.

10. On the Configure Action page, select the workflow agent details. In this example, enter values for the delivered Code Enforcement use case:

    Page Element	Description
    Family	For AI agents in Oracle Permitting and Licensing, enter PSC.
    Product	Enter the product area for the AI agent. For example, Code Enforcement.
    Agent Team	Enter the published agent team name. For example, Code Incident Checker.

11. Click Done and save the business rule.

When the Incident Status Updated event occurs and the rule criteria are met, the Business Rules Framework calls the selected workflow agent and passes the incident ID from the triggering incident.

The Business Rules Framework action is complete when the workflow agent request is submitted successfully. The agent’s downstream processing is handled by the workflow agent.

Note:

A successful Business Rules Framework action response indicates that the workflow agent request was submitted. It doesn’t necessarily indicate that all downstream workflow agent processing completed successfully.