Search widgets that you cloned or customized before a system upgrade may not be compatible with AI Search. You can resolve this issue by running a fix script that reclassifies search widget instances.

Before you begin

  1. Enable and configure AI Search in Service Portal
  2. Run the Portal Analyzer to identify all cloned or customized search widgets. For more information, see Portal Analyzer.
  3. For each cloned or customized search widget, copy the sys_id value of each widget instance that is associated with the widget.
  4. For each cloned or customized search widget, ensure that the widget and its corresponding widget instances have the latest AI Search code from the base system search widget.
    Warning: Run the fix script only after you've updated all cloned or customized search widgets. If you run the fix script without first updating the widget code, the widgets won't be able to uptake the AI Search code later.

Role required: admin

About this task

If you're unable to use AI Search in Service Portal, you may need to reclassify your cloned or customized search widgets. You can run the Reclassifying Search widgets fix script, which reclassifies widget instances to the sp_instance_ais class.

Procedure

  1. Navigate to All > System Definition > Fix Scripts.
  2. On the list, find and open the record named Reclassifying Search widgets.
  3. On the form, update the script to define which widget instances to reclassify.
    Paste the sys_id value of each search widget instance in the array. For example, you would enter the sys_id values as follows:
    var instances = ["sys_id_1", "sys_id_2"];
  4. Save the form.
  5. Select Run Fix Script.