Use Joule Studio to Create an Assistant for Equipment Troubleshooting

1. Open Joule Work and select the Develop area.

2. Select the Agent tile and then choose Create.

   In Joule Studio, you can create an agent, build n8n agentic workflows and applications, or extend existing agents and assistants.

   

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.

   

4. Choose Create.

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.

   

   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 are used 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 processing 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. Using the “intent-analysis” skill, Joule generates a proposed solution displayed on the Idea Board. Through its integration with SAP Signavio, Joule can map your intent to the relevant business process. In this tutorial, the identified business process is “Acquire to Decommission.”

   

4. Intent Fit indicates how closely the proposed solution corresponds to your requirement.

   

When the requirement is ready, you have the opportunity to review and refine it. For this tutorial, you will accept suggested Product Requirement Document (PRD) 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 PRD similar to the one below in markdown format.

If you need to update the PRD manually, you can simply click on the text in the View tab, edit the files in the dedicated Code tab, or even make the changes through the chat interface with Joule.

Once the specification is complete, you could hand it over to another team for implementation. However, here, you can have the tool implement the agent for you. This may happen automatically if you selected Quick Create at the start.

While the solution is being generated, you can explore the specification in the Code tab. You’ll find it as specification.md under the specification/equipment-troubleshooting-agent/.

The tool will work through the tasks defined in the specification. When it is finished, it will start building the agent.

1. Wait until the implementation is finished successfully. That includes the successful automated tests.

1. You can then explore the code if you need to.

   

2. Go to the Try tab of your solution to test your agent. What you can do will depend on what has been implemented. If you need some inspiration, ask How can I test this agent? to get suggestions for prompts you can use.

For this tutorial, you will not be deploying your agent unless your instructor says otherwise. However, the code that has been generated follows SAP best practices and would be deployable to the Joule Studio runtime.