Create an AI Assistant to suggest salary recommendations.

To create an AI Assistant to suggest salary recommendations:

1. View the form page in Page Designer:
   1. On the Workspace home page, click the App Builder icon.
   2. Select the application.
   3. Select the form page, Edit Employee.
      The form page displays in Page Designer.
2. On the form page, add a button named SUGGEST_SALARY:
   1. Right-click the Edit Employee region and select Create Button.

      In the Property Editor, edit the Button attributes.

   2. Identification, Button Name - Enter the name used to reference the button. For example, enter:
      SUGGEST_SALARY
   3. Change the button position so it displays to the right of Salary (P3_SAL).

      Tip:

      You can edit the button attributes or drag and drop the button to the appropriate location in the Layout pane.

      • Layout, Sequence - Enter the display sequence for this item. Enter 60

      • Layout, Start New Row - Disable Start New Row.

        Note New Column is now enabled.

      
      

      
      Description of the illustration ai_assistant_suggest_salary_button.png

      
      
   4. Appearance, Button Template - Select Text with Icon.
   5. Appearance, Hot - Enable Hot.
   6. Appearance, Template Options - Click Use Template Defaults. In Template Options dialog, configure the following:
      • Common, Size - Select Large.
      • Common, Width - Select Stretch.
      • Advanced, Spacing Top - Select Large.
      • Click OK.
   7. Appearance, Icon - Select fa-robot.
   8. Behavior, Action - Select Defined by Dynamic Action.
   9. Behavior, Execute Validations - Disable Execute Validations.
   10. Click Save.
3. Add a hidden item named P3_DEPARTMENT:
   1. Right-click the Edit Employee region and select Create Page Item

      In the Property Editor, edit the Page Item attributes.

   2. Identification, Name - Enter the item name. For example, enter:
      P3_DEPARTMENT
   3. Identification, Type - Select Hidden.
   4. Click Save.
4. Create a computation to retrieve the department name:
   1. Right-click P3_DEPARTMENT and select Create Computation.

      In the Property Editor, edit the Computation attributes.

   2. Computation, Type - Select SQL Query (return single value).
   3. Computation, SQL Query - Enter the following:

      select dname
        from dept
       where deptno = :P3_DEPTNO

   4. Click Save.
5. Add a hidden item named P3_INIT_PROMPT:
   1. Right-click the Edit Employee region and select Create Page Item

      In the Property Editor, edit the Page Item attributes.

   2. Identification, Name - Enter the item name. For example, enter:
      P3_INIT_PROMPT
   3. Identification, Type - Select Hidden.
6. For P3_INIT_PROMPT, create a computation:
   1. Right-click P3_INIT_PROMPT and select Create Computation.

      In the Property Editor, edit the Computation attributes.

   2. Computation, Type - Select Static Value.
   3. Computation, Static Value - Enter the following:

      Department: &P3_DEPARTMENT. Current salary: &P3_SAL.

   4. Click Save.
7. Create a dynamic action that fires when the user clicks the SUGGEST_SALARY button:
   1. Click the Dynamic Actions tab in the left pane.
   2. Right-click Click and select Create Dynamic Action.
      A dynamic action named New appears in the left pane. The Property Editor displays Dynamic Action attributes.
8. In the Property Editor, edit the Dynamic Action attributes:
   1. Identification, Name - Enter the name of the dynamic action. For example, enter:
      AI: Suggest Salary
   2. When, Event - Specifies the event that causes the dynamic action to fire. Accept the default, Click.
   3. When, Selection Type - Specifies the page element or construct that triggers the event. For example, select Button.
   4. When, Button - Specify the button that triggers the dynamic action. Select SUGGEST_SALARY.
9. Edit the True action, Show. In the Dynamic Action tab, click the Show action.

   Edit the Action attributes in the Property Editor.

10. Identification, Action - Select Show AI Assistant.
11. Configure Generative AI attributes:
    1. Generative AI, Service - Select the Generative AI Service to be used by the AI Assistant. Application Default uses the Generative AI Service specified on the AI page in the application attributes. See Configuring AI Attributes for an Application.
    2. Generative AI, System Prompt - The System Prompt gives the AI a context. This message does not display on front end, but is sent to all AI service requests on the back end.

       You will use this attribute in conjunction with Initial Prompt.

       Enter:

       You are an HR manager who provides suggestions for salary raises of employees.
       Based on the department the percentage of the increase differs.
       
       Here is the list of departments and the increase percentage values:
       - ACCOUNTING 5%
       - OPERATIONS 7%
       - RESEARCH 10%
       - SALES 3%
       
       You will get the department information and the current salary of an employee.
       Based on these information you will calculate a new salary.
       
       The calculated salary should be displayed without special characters and currency symbols. Also round decimal numbers to the next highest integer. Answer in complete but short sentences containing the calculated salary.
       
       Only answer questions to salary suggestions and nothing else.
       If needed parameters like the department name or current base salary are missing, reply that you need more information to proceed.

    3. Generative AI, Welcome Message - Specify an optional welcome message shown by the AI Assistant. For example, enter:

       Hi. I'm your personal HR assistant. I can assist you in calculating salary raises.

12. Configure the Appearance attributes:
    1. Appearance, Display As - Select how the AI Assistant should appear on your page. Select Dialog.
    2. Appearance, Title - Enter the title that displays on the dialog.

       Enter:

       Personal HR Assistant

13. Initial Prompt attributes - The Initial Prompt is the first message/context from a user's perspective:
    1. Initial Prompt, Type - Select Item.

       This attribute determines how the AI Assistant should return responses. Select the type of initial prompt to be delivered to the AI Assistant. The initial prompt represents a message as if it were coming from the user. This can be either a specific item value or a value derived from a JavaScript expression.

    2. Initial Prompt, Item - Enter a page item used to set the initial prompt.

       Select P3_INIT_PROMPT.

    3. Initial Prompt, Immediate Action Prompt - Enter a prompt that is used in conjunction with the Initial Prompt to display an immediate AI-generated response for the end user.

       Enter:

       Calculate the salary suggestion

14. Use Response - Returns the content of an answer (or AI message). For this example, you specify a page item.
    1. Use Response, Type - Determines how the AI Assistant should return responses. Select Item.
    2. Use Response, Item - Select P3_SAL.
    3. Use Response, Button Label - Specify the label for the message action button, which is used to send the response to a designated target. Enter:
       Apply suggestion
    4. Use Response, JavaScript Detection Expression - Enter a JavaScript Expression to search for certain criteria within the message. This expression should return the text to be used in the response. Enter the code:

       // search for numbers with a length of 3-5 and just return the number if one is found
       this.fullContent.match( /\b\d{3,5}\b/g ) ? this.fullContent.match( /\b\d{3,5}\b/g )[0] : ""

15. Click Save.
16. Test your changes:
    1. Return the Employees page and run the page.
    2. Find an employee and click the Edit icon to view the Edit Employee form.

       The Edit Employee form appears.

       
       

       
       Description of the illustration ai_assistant_edit_employee.png

       
       

       Note that Clark's Salary is 2450.

       The Edit Employee form appears.
    3. Click Suggest Salary.

       The Personal HR Assistant appears.

       
       

       
       Description of the illustration ai_assistant_apply_suggestion.png

       
       
    4. Click Apply Suggestion.

       Note that the employee's Salary is no 2573.

    5. Click Apply Changes to accept the change and exit the form.