Prompt tuning for the Maximo AI assistant

As a system administrator, you can affect how the Maximo® AI assistant responds to prompts.

To complete prompt tuning, you specify parameters, also known as prompts. Each prompt is the context that the assistant uses when answering questions or requests. Prompts are not rules that the assistant follows. To provide an answer, the assistant uses any prompts that are specified for tuning and the user's prompt. Data quality and availability can also affect responses.

For prompt tuning, you can write basic prompts and template prompts. A basic prompt is a natural language statement that is used by the model directly. A template prompt contains variables and is used to generate multiple, similar prompts. You might specify a template prompt if you want a prompt to apply to data under various conditions. You might specify a basic prompt if you have an exact attribute or value that you want the model to consider.

Complete prompt tuning only if you want to alter how the assistant responds to certain questions. If you are enabling your organization's first deployment of the AI assistant, you might skip prompt tuning until you have enabled and completed testing of the assistant. If the assistant can answer questions accurately for your organization, you do not need to complete prompt tuning.

Basic prompts

The following list contains example basic prompts. You can use these prompts for prompt tuning or write your own prompts.
  • 'Site ID' is typically the name of a site, place, or location
  • 'Asset condition' implies assethealth
  • High priority work order implies wopriority < 3
  • 'SR' is the same as 'service request'
  • Estimated total cost of a work order implies the summation of estlabcost, estmatcost, stservcost, and esttoolcost
  • 'Equipment' is the same as 'asset'
  • 'Downtime' or 'outage hours' implies totdowntime

Template prompts

When you write template prompts, use the following format: term1{object[where].attributefrom} implies term2‘{attributeto}’
term1
A keyword.
term2
A keyword.
object
The name of the referenced object.
where
A where clause. This value is optional.
attributefrom
The attribute of the object that is mapped from.
attributeto
The attribute of the object that is mapped to.

Do not specify more than one object in a prompt. Ensure that both attributefrom and attributeto are from the same object.

For example, the following prompt is a template prompt: Failures related to {failurecode[failurecode in (select failurecode from failurelist where type is null)].description} implies failurecode = '{failurecode}'

The prompt directs the assistant to primarily use failure code descriptions to understand and apply a failure code. To tie a failure code to its description, you can write one individual, basic prompt per failure code, or you can use a template prompt to automatically generate one prompt per failure code.

term1 is Failures related to, and term2 is failurecode.

object is failurecode. A period (.) is used to separate the object from the attribute. If a period is not used, the value is treated as an attribute.

where is failurecode in (select failurecode from failurelist where type is null).

attributefrom is description, and attributeto is failurecode.

The following prompts are examples of prompts that might be generated from the example template prompt:
  • Failures related to IT implies failurecode = 'IT'
  • Failures related to Pipe Failures implies failurecode = 'PIPES'
  • Failures related to CONVEYOR LINE FAILURES implies failurecode = 'CONVEYOR'

Procedure

To complete prompt tuning, complete the following steps:
  1. In Maximo Manage, in the Database Configuration application, from the More actions menu, click Prompt tuning for the assistant. Some prompts are provided by default. If you do not want to use these prompts, deactivate them by clearing the Activate checkbox. Do not edit the default prompts.
  2. Click the New Row icon.
  3. In the Name field, specify a name for the prompt.
  4. Optionally, in the Description field, specify a description for the prompt.
  5. Optionally, in the Object field, select the object that the prompt relates to. For example, if the prompt is used for sites, select an object structure for sites. Selecting an object for your prompt can enable the assistant to better understand the prompt and apply it as you intend.
  6. If the prompt is a template prompt, select the Template checkbox.
  7. In the Prompt field, specify your prompt.
  8. Select the Activate checkbox. When a basic prompt is activated, it is sent to the assistant as metadata. When the template prompt is activated, those generated prompts are sent to the assistant as metadata.
  9. Click OK.