AI Agent: Sales Promotions Advisor

Use an AI agent in the Order Management work area to get suggestions about how to promote, upsell, and cross sell items on sales orders. The agent can make suggestions and ask you follow up questions depending on the choices that you make in the sales order.

The Sales Promotion Advisor will automatically analyze your sales order, and then use the rules that you have set up to identify any promotions that it can apply. It can also suggest complementary offers to help you cross sell and upsell. The agent can update the sales order according to the selections that you make while you interact with it.

Get a personalized promotion according to context. For example, order a printer and the agent can suggest a discount for ink.
Cross sell and upsell. Get a recommendation for an add-on or a bundle while you create the sales order and increase the order's value.
Get the details that you need exactly when you need them. The agent can provide the exact amount of detail in a recommendation that you need to make an informed choice so you can quickly submit the order.
Get recommendations according to the values from a large set of attributes. Use these values to provide recommendations that meet your customer's specific requirements.

Some typical recommendations include getting a discount according to the:

Order line's quantity or amount
Total quantity for an item across all order lines in the order
Total amount on the sales order

For example:

Buy a quantity of 5 of the Glorious Bouquet and get 30% off.
Buy a quantity of 22 of the LCD Monitor and get a free keyboard.
Pay immediately and get a 10% discount.
Ship by ground and get 5% off.

Try It

Go to the Order Management work area, create a sales order, then click Offers and Benefits > Show Offers and Promotions:

Examine the recommendations in the summary:

xxxxxxxxxxx

Notice these recommended promotions:

Promotion 1 is a cross sell
Promotion 2 is a discount for an immediate payment
Promotion 3 is a volume discount

Click Apply Promotion Free Keyboard, then examine the results:

xxxxxxxxx

The breakdown includes your choices. . .

xxxxxxxxxxx

. . .and also the order total:

xxxxxxxxxxx

Click View Details, then look:

xxxxxxx

Steps to Enable

Make sure you have the ORA_DR_FAI_GENERATIVE_AI_AGENT_SCM_ADMINISTRATOR_DUTY role.
Make sure you have the FAI_VIEW_AI_AGENT_WORKFLOW_DATA and FAI_MANAGE_AI_AGENT_WORKFLOW_DATA roles so you can access the templates.
Go to the Setup and Maintenance work area, then use the Manage Administrator Profile Values task to set the Enable VBCS Progressive Web Application User Interface (ORA_HCM_VBCS_PWA_ENABLED) profile to Y at the site level.
Go to Tools > AI Agent Studio, set the Family to SCM and the product to Order Management, then click Copy Template under Sales Promotions Advisor:
Click Copy, enter a suffix, then click Continue. We recommend that you use the suffix to indicate versions, such as 1, 2, 3:
Notice the tools:
Here's a summary:

Tool	Description
Order Promotions Advisor	Promotions that are available for the sales order.
GetSalesOrderLines	Get details about the sales order or order lines that you select.
GetOrderPricingRecommendations	Get details about the promotions that available according to values in the sales order.
GetOrderAmount	Calculate the order total, dates, and so on.
GetUpdatedOrderLineAndCharges	Calculate charges on the order line, dates, and so on.
Apply Promotion	Apply the promotion.
AddOrderLine	Add an order line as part of the promotion.
updateLine	Update an order line as part of the promotion.
CopyOrderLines	Copy an order line as part of the promotion.
RemoveOrderLines	Remove an order line as part of the promotion.
SelectItemFromCategory	Select an item as part of the promotion.

If necessary, you can modify the description and prompt to meet your needs:

xxxxxxxxxxxx

Click Publish, click Agent Teams, then confirm that the agent's status is Published. Also, set the Agent Team Code attribute to promotionAgentName. In this example, that value is SALES_PROMOTIONS_ADVISOR_1:

xxxxxxxxxxxx

Go to the redesigned order page, then click Edit Page in Visual Builder Studio:

Edit Page in Visual Builder

Set promotionAgentName to SALES_PROMOTION_ADVISOR_1, then click Preview:

xxxxxxxxxx

If all looks good in the preview, then publish your changes.

Next, set these order management parameters:

Number of Recommendations to Display. Specify how many recommendations the summary displays. It comes predefined with a value of 3.
Item Details to Display in Offers. Specify whether to display the item number, item description, or both of them.

Tips And Considerations

You can use the agent only in the Order Management work area.
You can't use the agent in a guided journey.
You can use the agent only for a draft order or a revision.
You can submit the sales order directly from the agent. However, we recommend that you allow your users to review the order before submitting it.
A recommendation can offer a choice that allows you to select among two or more conditions that are needed to apply the promotion. For example, if you use UPS 3 Day Ground or Fedex 3 Day Ground, then get 30% off the sale price.

Use the item search tool and the order total tool to set up your prompt to meet your specific requirements. For example, if the advisor says get 50% off all electronics this week and you want to add an item from the electronics category to get the discount, then you can use the search tool to search items in the category. You can tune these prompts to meet your needs.

The agent can use the values from these attributes on the order header when it creates a recommendation:

Bill To City
Bill To Country
Bill To County
Bill To Province
Bill To State
Business Unit
Currency
Customer
Customer Account. Must match the Bill To Account on your promotion's set up.
Postal Code. Must match the Bill To Postal Code on your promotion's set up.
Pricing Strategy
Ship To City
Ship To Country
Ship To County
Ship To Postal Code
Ship To Province
Ship To State

If the value in the attribute meets the promotion's requirements, then the agent can provide a recommendation. For example, if the value in the Bill To City on the sales order in the Order Management work area meets the value that you specified for the Bill To City attribute that you set up on the pricing promotion in the Pricing Administration work area, then the agent can make a recommendation.

The agent can update these attributes when you select one of its recommendations:

Item
Item Category
Line Amount
Line Quantity
Order Total
Group Amount. A group of items in the promotion that are necessary to meet the promotion's incentive.
Group Quantity. The quantity for a group of items in the promotion that are necessary to meet the promotion's incentive.
Aggregated Amount. The total amount in a category of items that's necessary to meet the promotion's incentive.
Aggregated Quantity. The total quantity in a category of items that's necessary to meet the promotion's incentive.
Promotion Code

It can update these attributes on the order line:

Payment Term
Shipping Method
UOM

Key Resources

Access Requirements

To access the Oracle AI Agent Studio for Fusion Applications and manage SCM AI agents, users must be assigned a configured job role that contains these duty roles:

SCM Intelligent Agent Management Duty (ORA_RCS_SCM_AI_AGENT_MANAGEMENT_DUTY and ORA_RCS_SCM_AI_AGENT_MANAGEMENT_DUTY_HCM – both duty role codes are required)
Fai Genai Agent SCM Administrator Duty (ORA_DR_FAI_GENERATIVE_AI_AGENT_SCM_ADMINISTRATOR_DUTY)

In the Security Console, filter by Roles and Privileges to find the SCM Intelligent Agent Management Duty role. Filter by Roles and Permission Groups to find the Fai Genai Agent SCM Administrator Duty role.

To interact with AI agents in product pages, users must be assigned a configured job role that contains this duty role:

Fai Genai Agent Runtime Duty (ORA_DR_FAI_GENERATIVE_AI_AGENT_RUNTIME_DUTY)

In the Security Console, filter by Roles and Permission Groups to find this duty role.

To allow users to interact with agents, you must also enable permission groups in the Security Console on those users’ configured job roles that contain the Fai Genai Agent Runtime Duty role. You can enable permission groups when you manage the basic information of your configured job roles.

Users’ configured job roles must also contain privileges that allow access to the pages where AI agents are enabled.