Enabling the AI assistant

You can enable an AI assistant for Maximo Manage, Maximo Health, Operational Dashboard, and asset dashboards. The assistant uses the nl2oslc model template.

1. In Maximo Manage, open the AI configuration application and then in the table, click the ASSISTANT AI configuration.
   If you delete the default configuration and then add another configuration for the assistant, ensure that you use the nl2oslc model template and that you select the latest version of the model.
2. Review the content in the Edit AI configuration dialog.
   1. Click Actions > Edit.
   2. In the Template version field, select the latest version of the model. To view all versions, click the Lookup icon.
      If you are using the v9-251127-amd64 catalog version, you can choose either the Granite or GPT model version. If you are using Maximo AI Service on-premises, you must have adequate hardware to run the model version that you choose. The following table describes the requirements for each version.

      Table 1. Hardware requirements for Granite and GPT model

      Template version	Requirements for on-premises Maximo AI Service
      1.0.4-granite	The Granite™ 3.2 8B Instruct model requires at least one A100 GPU. This template version is also compatible with H100 GPUs, which can deliver improved performance and accuracy compared to A100.
      1.0.4-gpt	The gpt-oss-120b model fosters better performance, including faster response times and greater accuracy. However, it requires a minimum of one H100 GPU. Note: If you already configured the AI assistant but want to change the template version to the gpt-oss-120b model, changing the template version will delete any set arguments. Make sure that you record any current argument settings before you upgrade so that you can set the arguments after you change the template version.

   3. Edit the quick starters.
      Quick starters are suggested requests or questions that appear in the welcome message when the assistant is opened by one of your users. Quick starters can enable users to explore the assistant and its features more efficiently. You can use the default quick starters or specify your own. Quick starters cannot be customized to certain roles or users. Specify requests or questions that most of your users might want and that the assistant can answer based on the selected object structures.
   4. Click OK.
3. Set up arguments.
   Arguments control some aspects of the models output and how it processes data.
   1. Click Actions > Set arguments. Some earlier versions of the assistant do not have arguments that you can set. If the Actions menu does not contain a Set arguments action, you do not set arguments.
   2. Review the values for the arguments.

      Table 2. Arguments for assistant model template

      Argument key	Description	Type
      use_explanation	Indicate whether responses include the query that was used to retrieve data. If set to true, which means the query is included, performance can be affected.	string
      use_router_filter	Indicate whether prompts are screened for relevance before the assistant processes them. By default and as a best practice, this argument is set to false. If set to true, meaning the prompts are screened, performance can be affected.	string

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

   Activating the AI configuration indicates that the AI configuration is prepared.

5. From the Actions > Create model
   Creating the model enables the assistant on the user interface. The assistant is available for Maximo Manage, Maximo Health, Operational Dashboard, and asset dashboards.

   The assistant appears in the lower right of the interface. You can drag and drop the icon to different areas on the user interface, but the assistant chat window always opens on the right side of the page.

   Note: If you are using the Maximo Application Suite customer-managed feature channel, starting in the December 2025 update, the AI assistant is launched from an icon in the page header in Maximo Manage, Maximo Health, Operational Dashboard, and asset dashboards. The chat window opens on the right side of the page. If the assistant requires time to respond to a question or request, you can close the chat window. The assistant continues working, and the icon notifies you when the work is done.