Configure Workflow Triggers

Webhook

A webhook is an automated, event-driven mechanism for sending real-time data from an application over HTTP. You can configure a webhook trigger to call a workflow.

Go to AI Agent Studio.
From the Workflows tab, edit a workflow.
Select Settings and go to the Triggers tab.
Select Add for webhook trigger, enter a name, select type, and then select Apply.
Publish the workflow.

Email

You can configure an email trigger to call a workflow when an email is received in a monitored account. Each workflow can monitor only one unique inbound email account. You can't use the same inbound email account for another workflow.

To allow the workflow to be triggered by incoming emails:

Register the inbound email account in AI Agent Studio. See Add Email Accounts.
Go to AI Agent Studio.
From the Workflows tab, edit a workflow.
Select Settings and go to the Triggers tab.
Select your registered inbound email account.
Publish the workflow.

To verify that emails received in the selected inbound email account will now trigger this workflow:

Go to the Monitoring and Evaluation tab and open the Activities subtab.
Go to Inbound Emails to view the contents of the trigger email messages and verify that the messages are initiating the workflow correctly.

Schedule

You can configure a scheduled trigger based on a defined time interval, to call a published workflow without user interaction or API calls. Scheduled triggers are useful when workflows need to run regularly or at fixed intervals.

Note: Make sure you have the FAI Batch Job Manager (ORA_DR_FAI_BATCH_JOB_MANAGER_DUTY) permission assigned in the Security Console.

To allow the workflow to be triggered at a scheduled date and time:

Go to AI Agent Studio.
From the Workflows tab, edit a workflow.
Select Settings and go to the Triggers tab.

Select Add for schedule triggers and choose the type of schedule to create. Based on the selected type, specify other details.

Type	Description
Interval	Run the workflow between fixed time periods, for example, every 100 minutes, every 10 hours, or every 5 days.
Recurrence	Run once at a specific time or repeatedly on calendar patterns, such as daily, weekly, or monthly. Enter a start time and an optional date and time for the recurrence to end.

Publish the workflow.

To verify that your scheduled trigger is starting the workflow:

Go to the Monitoring and Evaluation tab and open the Activities subtab.
Go to Schedules to view the entry and verify the scheduled trigger is initiating the workflow correctly.

Signals

You can configure a signal trigger to call a workflow when a subscribed signal is received. A signal is a governed event contract that you define in AI Agent Studio and subscribe to from a workflow. Signal triggers are useful when workflows need to respond automatically to business events without user interaction or API calls.

To create a signal in AI Agent Studio:

Go to AI Agent Studio.
Select the Resources tab and open the Signals subtab.
Add a new signal definition.
Enter the signal code, version, name, status, description, and payload schema.
Select Create.

Created signals appear in the Signals subtab and can be reused across workflows.

To subscribe to a signal:

Go to AI Agent Studio.
From the Workflows tab, edit a workflow.
Select Settings and go to the Triggers tab.
In Signals section, select Add.
Select an active signal definition.
In Max attempts field, select the maximum number of times delivery can be attempted before it's exhausted.
In Retry delay field, select the base delay before a failed delivery is retried.
In Backoff policy field, select a backoff policy to determine how the retry delay changes after each failed delivery attempt.
Select Apply and then publish the workflow.

Your workflow is now subscribed to the signal you selected. It can start automatically when that signal is published.