Enabling locating of similar work orders

You can use AI to find work orders that are similar to another work order. For example, you can find work orders that are similar to another work order. The similar work orders feature uses the similarity model template.

1. In Maximo Manage, in the AI configuration application, in the table, click the WOSIMILARITY AI configuration.
   If you delete the default configuration and must add another configuration for the same feature, ensure that you use the similarity model template and that you select the latest version of the template.
2. In the Edit AI configuration dialog, review the default settings.
   1. Click Actions > Edit.
   2. Optional: In the Related Records field, specify a WHERE clause to limit what work orders can be reviewed for similarity.
      For example, you can limit the search to work orders that are for a certain asset or of a certain type. If a work order does not meet the criteria of the WHERE clause, you can trigger the similarity feature from that work order, but no similar work orders are returned.
   3. In the Template version field, ensure that the latest version is selected. To view all versions, click the Lookup icon.
   4. Optional: In the Additional details for AI explained section, provide any information that is specific to your organization and relevant to your end users to help them understand the model and its output.
      An AI icon is located alongside your model's output. Your users can click the AI icon and then access any information that you specify in this section alongside other general model information that's provided by IBM. You can complete the AI configuration process, view the AI icon and its content in context, and then edit this section later as needed.
   5. Click Save.
3. Set up arguments.
   1. Click Actions > Set arguments.
   2. For each of the arguments, review any default value and change as needed. Specify values for the date_field and features arguments. The following table describes all of the arguments.

      Table 1. Arguments for similarity model template

      Argument key	Description	Type	Default value
      date_field	A date field in work orders that is used to determine similarity. If you change the value for this parameter, you must also change the query templates for similarity in the MXAPIWODETAIL object structure. For more information, see Integration components for locating similar work orders.	string	changedate
      features	Fields to compare to determine how similar work orders are. If you change the value for this parameter, you must also change the query templates for similarity in the MXAPIWODETAIL object structure. For more information, see Integration components for locating similar work orders.	string	description, description_longdescription
      history_days	The maximum age in days of work orders that can be included for inferencing. This value is calculated from the base work order's date field value.	integer	30
      max_similarity_records	The maximum number of similar work orders that can be returned. Note: In the System properties application, you can configure the mxe.ai.comparetolimit property to determine the maximum number of work orders that can be reviewed for similarity.	integer	10
      retention_days	The maximum age in days from the current date for work orders that can be included for configuration. Work orders can be at most 1000 days old, but the higher this value, the longer it can take to complete inferencing and render results. This value also determines the age of work orders that can be similar. For example, a work order with a change date of today can return similar work orders that have a change date of up to 90 days ago.	integer	90
      similarity_threshold	The minimum similarity score that work orders must have to be included.	integer	70

   3. Click Save.
4. Click Actions > Activate.

   Activating the AI configuration indicates that the AI configuration is prepared and the model is ready to be processed by the cron tasks. Activation also automatically runs configuration and inferencing.

   Inferencing is controlled on a crontask schedule. The AIINFJOB crontask initiates inferencing for all eligible AI configurations. By default, the cron task runs every hour. If inferencing does not start promptly after the model is activated, you can edit the cron task schedule:

   1. In Maximo Manage, in the Cron Task Setup application, open the AIINFJOB cron task.
   2. In the Cron Task Instances table, for the WOAI instance, in the Schedule field, change the value.
5. Click Actions > Create model.
6. Verify that the AI feature is available.
   For more information about using this feature to locate similar work orders, see Viewing similar work orders.
7. Grant users access to the feature.
   Access to the similarity feature is controlled through a signature option for the associated object structure. By default, the MXAPIWODETAIL object structure is used.
   1. In the Security Groups application, select the security group to which you want to grant access.
   2. On the Object Structures tab, in the Object Structures table, select the object structure that you associated with the similarity AI configuration.
   3. In the Options for table, for the View similar work order option, select the Grant Access checkbox.