Skip to Content

Use Joule Studio to Create an Assistant for Equipment Troubleshooting

Requires Customer/Partner License
Beginner
20 min.
Use Joule studio to create and test an agent for intellegent maintenance assistance in supply chain management.
You will learn
  • How to use intent-based development to create AI solutions.
  • How SAP Domain Models and other resources are levergaed to contextualize the generated solution
Rebecca YangMay 26, 2026
Created by
mhplum
May 12, 2026
Contributors
mhplum

Prerequisites

  • Access to Joule Work and Joule Studio in the Agent Lab at SAPPHIRE
  • You have been provided with the logon information

IMPORTANT

Welcome to the Agent lab SAPPHIRE 2026!

You are working with a pre-release version of the Joule Studio. This gives you an early look at our upcoming capabilities. Please keep the following in mind:

  • Features are subject to change: The user interface (UI), terminology, and functionalities you see in this lab may differ from the final generally available product (GA).
  • For Educational use only: This environment is designed for learning and experimentation, not for production use.
  • Potential instability: As a preview version, you may encounter occasional instability or minor bugs. The exercises are designed to work with the current state of the platform. If you get stuck, please notify a session instructor.

Using Joule Studio’s intent-based development, learn to create an intelligent Supply Chain management (SCM) assistant that helps technicians quickly access equipment history and troubleshooting guidance.

  • Step 1
    1. Open Joule Work and select the Develop + area.

    2. Select the Agent tile and then choose Create.

      Click + to open the new solution dialog
    3. Leave the selected New Solution unchanged, and fill in the agent details:

      Agent Name:

      COPY
      Copy
          Equipment Troubleshooting Agent
      

      Intent Statement:

      COPY
      Copy
         Create an AI agent that helps maintenance technicians quickly access equipment history and troubleshooting guidance.
      

      Select Quick create.

      Enter agent name and intent statement
    4. Choose OK to launch Joule Studio.

  • Step 2
    1. This is where the tool tries to understand your intentions. The tool will attempt to understand your prompt and will likely ask you clarifying questions if you have not chosen quick-create as recommended above. Once it decides it understands enough, it will map the challenge to SAP’s Reference Business Architecture and performs a fit-gap analysis. It has access to SAP Knowledge Graph, SAP LeanIX, and SAP Domain Models to help it create the intent document. Intent fit indicates how closely the proposed solution corresponds to your requirement.

      intent-tools

      Answer the questions set by the tool. The questions that the tool asks cannot be predicted, so you have to use your judgement. Bear in mind that some landscapes such as S/4HANA or Success Factors as backends so tailor your responses accordingly. The more complex you make your scenario, the longer it will take to generate and test the solution.

    2. Once the intent document is created, proceed to the next phase, which is requirement generation. This might happen automatically if you have selected quick-create at the start. If processesing is waiting for your input to proceed, enter Create Requirement or similar.

    3. While the requirements are being generated, you can explore the intent on the Idea Board.

      intent-tools
  • Step 3

    When the requirement is ready, you have the opprotunity to review and refine it. For this tutorial, you will accept suggested product requirement document without changes. To progress to the next phase, you need to transform the PRD into a technical specification.

    Depending on your role in your company, you might be finished at this point and make the PRD available to a different team to take further. However, in this tutorial, you are taking the project forward with the generation of a technical specification. Similar to the previous step, this might happen automatically if you have selected quick-create at the start.

    At this stage, you can see the your PDR similar to the one below in markdown format.
    If you need to update it manually, you can just proceed clicking on the text in the view or by editing the files in thededicated code tab.

    Technical overview
  • Step 4

    When the specification is complete you could pass it on to another team to do the implementation. However, here you are going to get the tool to implement the agent. This might happen automatically if you have selected quick-create at the start.

    Spec creation

    While the solution is being generated, you can explore the specification in the Code** tab. You’ll find it as specification/specification.md

    Spec ready

    If processesing is waiting for your input, enter instruction similar to Execute Specification or Implement the Solution.

    Spec ready

    The tool will work through the tasks defined in the specification. When it is finished, it will update the status in the specification to show the tasks have been done.

    Solution code
  • Step 5
    1. Wait until the implementation is finished successfully.
    Solution ready
    1. You can then explore the code if you need to.

      Solution code
    2. Go to the view tab of your solution and try your agent. What you can do will depend on what has been implemented.

    For the Agent Lab at SAPPHIRE, you will not be deploying your agent. However, the code that has been generated follows SAP best practices and would be deployable to the runtime.

Back to top