Building Joule Skills for Sales Order Queries in S/4HANA Cloud - Part 3: Developing Joule Skills

[teng_teng69]

This is Part 3 of a 4-part hands-on workshop series on building AI-powered conversational skills using SAP Joule Studio.

• Part 1: Environment Setup
• Part 2: Creating Actions with OData V4
• Part 3: Developing Conversational AI Skills
• Part 4: Process Automation Integration

Overview

In this module, you'll use Joule Studio to create and deploy a Joule skill that consumes services from SAP S/4HANA Cloud. This is where the magic happens - you'll build an intelligent conversational skill that can interact with users and backend systems.

Prerequisites

• Access to an SAP BTP tenant with Joule and Joule Studio
• Completion of Part 1: Associate Environment
• Completion of Part 2: Create Action Projects

What You'll Learn

• How to create a new Joule skill project
• How to configure skill inputs, outputs, and responses
• How to integrate actions with your skill
• How to deploy and test your skill

Estimated Time

30 minutes

Understanding Joule Studio

Joule Studio is SAP's AI-powered development environment for creating conversational AI skills. It provides an intuitive interface for building intelligent applications that can understand natural language and interact with backend systems.

Integration Focus: In this module, you'll build a skill that integrates with the SAP S/4HANA Cloud Public Edition Sales Order (A2X) OData V4 API to provide intelligent conversational access to sales order data. Official API reference: CE_SALESORDER_0001

Step 1: Create a Joule Skill Project

1. Open the SAP Build Lobby.

2. Choose Create.

3. Select the Joule Skill tile, then choose Next.

4. Enter name Sales Order Assistant and description Supply Sales Order Info., then choose Review.

5. On the following screen choose Create.

6. Enter name showGeneralInfo and description a skill to show the general header info of a given sales order., then choose Create.

Tip: The description is important because Joule will use it to identify the correct skill to select during a conversation.

Step 2: Configure Skill Parameters

7. Choose Trigger to open the side panel.

8. Choose Parameters, then choose Configure beside Skill Inputs.

9. Click Add Input, enter:

• Name: SalesOrderNo
• Description: Sales Order Number
• Mark Required
• Choose Apply

10. Choose Design Console. You should see errors (this is normal at this stage).

Step 3: Add First Action - Get Sales Order

11. Choose the + between Trigger and End.

12. Choose Call Action.

13. Choose Browse All Actions.

14. Select the action Get entity from SalesOrder by key and then choose Add.

15. Choose Select a Destination, then choose + Create a Destination Variable.

16. Enter S4HANA_CLOUD_SALES_ORDER and a description, then choose Create.

17. Choose Inputs, then choose the SalesOrder field to open the Skill Content pane.

18. Choose SalesOrderNo from the skill inputs.

Step 4: Add Send Message - General Info

19. Choose the + between the first action and End.

20. Choose Send Message.

21. Choose Open Message Editor.

22. Configure the General Info message card:

• Type: Card
• Title: Sales Order: [click to choose SalesOrder in the Data Mapping]
• Text: [click to choose Sold-to Party in the Data Mapping]
• Description: This order was created by [click to choose Created By in the Data Mapping].
• Image: sap-icon://sales-order
• Status State: Information

23. Add an Action Button:

• Title: Explore More
• URL: [Sales order management page link in your S4/HANA system]
• Image: sap-icon://detail-view

24. Add an Edit Section with title General Info and attributes by clicking to choose values in the Data Mapping:

• Total Amount: [choose TotalNetAmount]
• Requested Delivery Date: [choose RequestedDeliveryDate]
• Delivery Status: [choose OverallDeliveryStatus]

25. Choose Save to persist your message changes.

26. Choose Release.

27. Choose Release in the popup.

Step 5: Add Second Skill - Show Detailed Info

30. Make sure the Sales Order Assistant project is on the status of editable, click Create, then Joule Skill.

31. Enter name ShowDetailedInfo and description A skill to show the detailed items info of a given sales order., then choose Create.

32. Choose Parameters, then choose Configure beside Skill Inputs.

33. Click Add Input, enter:

• Name: SalesOrderNo
• Description: Sales Order Number
• Mark Required
• Choose Apply

34. Choose the + between Trigger and End, then choose Call Action.

35. Choose Browse All Actions.

36. Select the action Get entities from related _Item, then choose Add.

37. Choose Select a Destination, then select the existing destination variable S4HANA_CLOUD_SALES_ORDER.

38. Choose Inputs, then choose the SalesOrder field to open the Skill Content pane. In the Skill Content panel, select SalesOrderNo to map it.

Step 6: Configure Detailed Message (List)

39. Choose the + before End, select Send Message, then Open Message Editor.

40. Configure the Detailed Info message:

• Type: List
• Title: Sales Order Items
• Text: Detailed item(s) are shown below:
• Image: sap-icon://menu

41. Configure List Items by clicking to choose values in the Data Mapping:

• List content: [choose value]
• Image: sap-icon://product
• Title: [choose SalesOrderItem]
• Text: [choose OriginallyRequestedMaterial]
• Description: The volume is [choose ItemVolume] [choose ItemVolumeSAPUnit]
• Status State: Information

• Detailed View:
  • Title: Material Info:
  • Attribute: Material Group: [choose ProductGroup]
  • Attribute: Original Plant: [choose Plant]
  • Attribute: Net Weight: [choose ItemNetWeight]
  • Attribute: Unit of Weight: [choose ItemWeightSAPUnit]

42. Choose Save.

Step 7: Deploy and Test

43. Choose your environment and then click Deploy.

44. Select the S4HANA_CLOUD destination and click Deploy.

45. Choose your environment, then choose Joule.

46. Choose Launch.

47. Enter Please get me the details for sales order 485511 and choose Send.

Next Steps

In the final part, you'll learn how to integrate business processes and workflows into your skills, enabling end-to-end automation with email notifications.

Continue to Part 4: Process Integration

Part 3 of 4 | Joule Studio Workshop Series

[JungHyuk]

I would like to know how to resolve this error.