ServiceJack can generate suggestions based on the Spot's details and the input for your chosen action. Some actions produce a text response, while others produce a maintenance programme whose sections you can save as task templates. The response itself does not update the Spot or create maintenance tasks.
Requirements
This guide covers browser use. Your organisation must accept the AI terms of use and enable browser access. Access for Manager users must be enabled separately. The service must also be available, and your organisation must have some of its shared usage quota remaining. If necessary, ask your administrator to check the AI settings and usage limit.
You need permission to access the data used by the action. Saving a task template also requires permission to create task templates: permission to use AI alone is not enough.
Select an action and its input
In your browser, open the page containing the information you want to use with AI. In the bottom-right corner of the page, click the button showing ServiceJack's face below the AI label. If the assistant buttons are closed, first open them using the small pop-up window icon in the same corner.
In the ServiceJack window, select a category and then the action you want. The categories and actions depend on the page you have open and the interface language, so the list of actions is not the same everywhere.
Some editing windows also offer direct actions. You can find them in the menu opened by clicking ServiceJack's face at the right-hand end of the window's title bar. A direct action uses information associated with the saved item currently open and may start as soon as you select it.
Check that the correct Spot and other requested selections are set in the input form. If the action asks for an individual task or service request, for example, first select the Spot and then the associated item. Enter additional instructions only if the action provides a field for them. Required fields and limits on text or numeric values depend on the action. Start processing with the Continue button at the bottom of the form.
If the action uses the Spot's basic details, it retrieves the saved name, description and data field values according to your access permissions. Save any relevant changes before starting the request: simply opening the editing window does not pass unsaved changes to the AI.
Check the response before using it
Wait for the response to finish. A standard text response appears in the ServiceJack window. Read it and check that it concerns the correct equipment and is based on the correct input. If you want to use the suggestion in the Spot's details, make and save the changes separately in the Spot's own editing view.
When an action produces task template suggestions that can be saved, Review content appears in ServiceJack's results area. It opens the maintenance programme review window. This button and Recreate content are not available for every text response.
The AI-generated maintenance programme is a suggestion. Compare it with the equipment manufacturer's instructions and your organisation's maintenance practices. In particular, the recurrence and work steps must be adapted to the actual equipment.
Edit the maintenance programme sections and save the templates
In the review window, the maintenance programme is divided into separate sections, such as daily, weekly, monthly or annual maintenance. Review each section you need before saving it:
- Task template name names the template to be saved. Task name is the default name of the task created from the template. Both are required, and each can contain up to 512 characters.
- Task description contains the work instructions. Correct the work steps and add any essential missing information. The maximum description length is 4,096 characters.
- Recurrence consists of a number and a time unit. The number starts at 1, and the unit comes from the maintenance type in the suggestion. Check both: for example, 2 and Weeks mean an interval of two weeks. A recurring template requires a value of at least 1. If the work does not recur, select No recurrence as the unit.
This review window does not show weekday restrictions, and all weekdays are allowed by default. If necessary, add more detailed scheduling settings in the regular task template.
You can discard an unnecessary unsaved section using the Delete button at the bottom of that section. This removes the suggested section from the review window. It does not delete any previously saved task template or task.
Save a reviewed section using the Create Task template button at the bottom of that section. Each section is saved separately as a regular task template. Simply reviewing the suggestion or clicking the window's Close button does not save the sections.
Verify that the template was saved and put it to use
After a section is saved successfully, its fields are locked and Open the Task template appears above it. Open the template using this button and check the name, description and recurrence. If an error occurs, the form becomes editable again. Check the fields and your permission to create templates. If the outcome of saving is unclear, for example because of a connection error, check the task template list to see whether the template was created before trying to save again.
In the template you opened, complete the necessary task settings, such as the task form, work requirements and resourcing. See creating and editing a task template.
Saving the template does not start the maintenance programme or create a task for the selected Spot. Select the saved template when creating a new task, and set the correct Spot, responsible party and due date for the task. The schedule for recurring work and how subsequent tasks work are explained in setting up a recurring maintenance task.
Generating a new suggestion
When you close the maintenance programme review window and reopen ServiceJack, its results area shows Recreate content. This sends a new request using the same selections and entered information. The item details saved in Spotilla are retrieved again during processing, so changes made to them in the meantime may affect the response.
Processing a new request uses the shared AI quota. It does not change or delete templates already saved. If you also save sections from the new suggestion, they become new task templates. If you want to change the input selections, start the action selection process again.
Differences on mobile
Android and iOS have a separate AI Assistant for Spots, tasks and service requests. Open the item's details view and tap the AI button showing a face in the bottom-right corner. On Android, the button is above the bottom tab bar. Select an available action in the assistant and make the input selections it requests.
The mobile assistant displays the action's result. The button for copying the result is labelled Copy text, even in the Finnish interface. Displaying or copying the result, or opening a previous result, does not save a task template or change the Spot, task or service request. The browser's Review content form and task template saving described in this guide are not available in the mobile assistant.
Mobile access is enabled separately in your organisation's settings. Enabling browser access alone is not enough. Mobile uses the same organisation-wide AI quota, and you need permission to access the item being processed. See mobile access requirements and the shared usage limit.