Skip to Content

Use Joule Studio to Create and Deploy a Joule Skill

Requires Customer/Partner License
Use Joule Studio to create and deploy a Joule skill that consumes services from two different systems.
You will learn
  • How to consume action projects in a Joule skill
  • How to release and deploy the project containing the Joule skill
  • How to test the Joule skill in the standalone assistant
mhplumMartin PlummerSeptember 8, 2025
Created by
mhplum
July 15, 2025
Contributors
thecodester
mhplum

Prerequisites

Joule Studio in SAP Build is the new design time focused on developing AI capabilities. Joule studio gives SAP customers and partners the possibility to develop AI capabilities, such as custom Joule skills and custom AI agents, to extend the capabilities of Joule co-pilot and optimize organization-specific automation.

  • Step 1
    1. Open the SAP Build Lobby.

      The lobby is a central page for creating, accessing, and managing your projects in SAP Build.

      Lobby
    2. Choose Create.

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

      Enter name and description
    4. Enter name CreateBadge and description Create a badge for an employee given the employee's ID, then choose Review.

    5. On the following screen choose Create.

      Joule Studio create
    6. Choose Create > Joule Skill.

      Joule Studio create popup
    7. Enter name CreateBadge and description Create a badge for an employee given the employee's ID, then choose Create.

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

      Joule Studio fresh project
  • Step 2
    1. Choose Trigger (or <<) to open the side panel.

      Open side panel for trigger
    2. Disable Allow Joule to generate a response.

      Open side panel for trigger
    3. Choose Parameters, then choose Configure beside Skill Inputs.

      Configure inputs
    4. Choose Add Input three times and enter:

      Name Description Required
      EmployeeID Employee ID select
      Status Status
      CommunityID Community ID
    5. Choose Apply.

    6. Choose Configure beside Skill Outputs.

    7. Choose Add Output three times and then enter:

      Name Description Type Required
      Badge Badge Number select
      Employee ID Employee ID String select
      Employee Name Employee name String select
      Configure outputs
    8. Choose Apply.

    9. Expand Skill Outputs.

      Output parameters
    10. Close the side panel.

    11. Choose Save.

    12. Choose Design Console. You should see errors.

      Design console errors
    13. Close the Design Console.

  • Step 3
    1. Choose the + between Trigger and End.

      Joule Studio add action
    2. Choose Call Action.

      Joule Studio browse all actions
    3. Choose Browse All Actions.

      Joule Studio add action
    4. Select the action GET Retrieves business partner data by using business partner number and then choose Add.

      Joule Studio create variable
    5. Choose Select a Destination, then choose + Create a Destination Variable.

      Joule Studio create variable
    6. Enter S4HANA_MOCK and a description, then choose Create.

    7. Select the destination variable.

      Joule Studio select variable
    8. Choose Inputs, then choose the BusinessPartner field to open the Skill Content pane.

      Joule Studio map input
    9. Choose EmployeeID.

    10. Choose Outputs and expand the tree to see it.

      Joule Studio inspect output
    11. Close the pane and then choose Save.

  • Step 4
    1. Choose the + between the first action and End.

      Joule Studio action
    2. Choose Call Action.

      Joule Studio browse actions
    3. Choose Browse All Actions.

      Joule Studio select action
    4. Select the action POST Invoke action createBadge, then choose Add beside it.

      Joule Studio create variable
    5. Choose Select a Destination, then choose + Create a Destination Variable.

      Joule Studio create variable
    6. Enter Badge_Service and a description, then choose Create.

    7. Select the Badge_Service destination variable.

    8. Choose Inputs, then choose the businesspartnerId field to open the Skill Content pane.

    9. Expand the tree in the Skill Content pane and map the fields as shown.

      Joule Studio map inputs
    10. Choose Outputs and then expand the tree to see the result.

      Joule Studio inspect outputs
    11. Close the pane and then choose Save.

  • Step 5
    1. Choose the + between the second action and the End element.

      Add send message
    2. Choose Send Message.

      Open message editor
    3. Choose Open Message Editor.

      Message editor
    4. Enter Badge Request in the Title field.

    5. In the Text field, enter Badge has been created for. Then use <> to open Data Mapping and add the badgeId and firstname parameters.

      Data mapping in message editor
    6. In the Illustration field, choose an appropriate illustration.

    7. Choose Add Button.

    8. Enter Go to Badge System.

    9. Enter https://dev-advocates-sap-build-full-66wu1vlc.launchpad.cfapps.us10.hana.ondemand.com/buildapps237846.buildapps237846/index.html

      Edited and previewed message
    10. Check the preview and then choose Save.

    11. Close the side pane and choose Save.

  • Step 6
    1. Choose End.

      Mapped data to skill outputs
    2. Map the fields as shown.

    3. Close the side pane and choose Save.

  • Step 7
    1. Choose Release.

      Release
    2. Choose Release.

      Released
    3. Choose Show Project Version to change to the released version.

    4. Choose Deploy.

      Deploy
    5. Select your environment and choose Deploy.

    6. Select the respective destinations

      Destinations
    7. Choose Deploy.

      Deployed
  • Step 8
    1. Go to the SAP Build Lobby.

    2. Choose Control Tower -> Environments.

    3. Choose your environment.

    4. Choose Joule.

      Joule tab in environment
    5. Choose Launch.

      New conversation
    6. Enter Please create a badge for the employee with the ID 1003764. The badge status is NEW and his community ID is john.doe@bestrunsap.com

    7. Choose Send.

      Conversation result
    8. Choose the Go to Badge System button.

    9. Enter User Name: code, Password: me??Jam7, then choose Continue.

      CREDENTIALS LOCKED?: Please note that the credentials are used by multiple people, and can lead to the credentials being locked. If they are locked, you can skip the rest of the step for viewing the creation of the badge within the UI.

      You can view the newly created badge in the OData service manually, by opening a browser and entering the following URL and replacing with your badge ID:

      https://badges.cfapps.eu10.hana.ondemand.com/service/BadgeRequests/Badges?$filter=badgeId%20eq%2034

      You will see the details about the badge.

      Badge in Odata service
    10. Find your Badge ID in the list of requests.

      Badge system list of badges
  • Step 9

    The Send Message activity in a Joule skill

Back to top