--- author_name: Zeena Qarqash author_profile: keywords: tutorial auto_validation: true time: 20 tags: [ tutorial>beginner, software-product>joule, tutorial>license] primary_tag: software-product>joule parser: v2 slug: joule-studio-scm-equipment-assistant canonical_url: https://developers.sap.com/tutorials/joule-studio-scm-equipment-assistant --- # Use Joule Studio to Create an Assistant for Equipment Troubleshooting Use Joule studio to create and test an agent for intelligent maintenance assistance in supply chain management ## Prerequisites - Access to Joule Work and Joule Studio in the Agent Lab - You have been provided with the logon information ## You will learn - How to use intent-based development to create AI solutions - How SAP Domain Models and other resources are leveraged to contextualize the generated solution ## Intro >**IMPORTANT** > >**Welcome to the Agent Lab** > >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 UI, terminology, and functionality you see may differ from the final product. > - **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 unexpected behavior. 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. ### Get Started 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. ![Open the new solution dialog](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joule-studio-scm-equipment-assistant/010bis-create-solution.png) 3. Leave the selected **New Solution** unchanged, and fill in the agent details: Agent Name: ```COPY Equipment Troubleshooting Agent ``` Intent Statement: ```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](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joule-studio-scm-equipment-assistant/030bis-define-solution-details.png) 4. Choose **Create**. ### Intent 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](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joule-studio-scm-equipment-assistant/040bis-Intent-tools.png) > 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.” ![intent-tools](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joule-studio-scm-equipment-assistant/040bis-Intent-ready.png) 4. **Intent Fit** indicates how closely the proposed solution corresponds to your requirement. ![intent-fit](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joule-studio-scm-equipment-assistant/013bis-intent-fit.png) ### Requirements 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. ![Technical overview](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joule-studio-scm-equipment-assistant/060bis-prd-ready.png) 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. ![Technical overview](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joule-studio-scm-equipment-assistant/014bis-edit-PRD.png) ### Specification 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. ![Spec creation](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joule-studio-scm-equipment-assistant/070bis-create-spec.png) 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/**. ![Spec ready](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joule-studio-scm-equipment-assistant/070bis-spec-ready.png) The tool will work through the tasks defined in the specification. When it is finished, it will start building the agent. ![Solution code](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joule-studio-scm-equipment-assistant/080bis-implementation-in-progress.png) ### Solution 1. Wait until the implementation is finished successfully. That includes the successful automated tests. ![Solution ready](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joule-studio-scm-equipment-assistant/080bis-implementation-complete.png) 1. You can then explore the code if you need to. ![Solution code](https://raw.githubusercontent.com/sap-tutorials/sap-build-process-automation/main/tutorials/joule-studio-scm-equipment-assistant/085bis-solution-code.png) 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.