Skip to Content

Adding custom or out-of-the-box fields as attributes to the semantic model

The semantic model in BMC Helix ITSM helps the system understand and respond to user questions about tickets like incidents, changes, work orders, and problems. It acts as metadata for the Large Language Model (LLM), helping it to understand how different ticket types are structured and related. When a user asks a question about ticket types (Incidents, change requests, assets, work orders, and problem investigations) in Agentic chat, BMC HelixGPT uses both the semantic model and the user query to determine the responses.

The semantic model is configured out-of-the-box and includes schema definitions for the HPD:HelpDesk, CHG:Infrastructure Change, CTM:People, PBM:Problem Investigation, and WOI:WorkOrder forms. Each schema includes attributes and their relationships to other objects. If you have customized the HPD:HelpDesk or CHG:Infrastructure Change forms by adding custom fields, you can include these fields as attributes in the semantic model.

Important
The semantic model is evaluated in conjunction with the LLM prompt. The definitions, relationships, and context established in the semantic model guide how the LLM interprets the data, ensuring behavior aligns with the intent defined in the prompt.

For more information on customizing the shared ticket console, see Customizing the Shared Ticket Console.

Related topics

Configuring Agentic chat for BMC Helix ITSM

To add custom or out-of-the-box fields as attributes to the semantic model

Warning
Important

Response generation might vary if you do not perform the configuration for customization properly.

  1. On the BMC Helix ITSM navigation bar, select Configuration > Innovation Studio Configuration.
  2. In the Settings pane, select HelixGPT Configuration > Semantic Model Configuration.
  3. In the Semantic Model Configuration pane, click Configuration.
    Semantic Model.png
  4. On the Create semantic model configuration page, specify the following information:
Field nameDescription
Entity TypeSelect Attribute.
Name

Enter the exact name of the field as specified on the form, that is, HPD:HelpDesk or CHG:Infrastructure Change form.

This field is added as an attribute to the semantic model.

Alias

Specify an alias name for the attribute.

An alias is a simple, English-based variable name. You can follow either of these naming conventions:

  • Java convention (lowerCamelCase): assigneeName
  • Python convention (snake_case): assignee_name
Schema Name

Specify the schema name to which the attribute belongs.

If the attribute belongs to the HPD:HelpDesk schema, type Incident.
If the attribute belongs to the CHG:Infrastructure Change schema, type Change.
If the attribute belongs to the Asset Console CRD schema, type Asset.

Field ID

Specify the field ID of the field.

Data TypeSelect the data type of the field.
Enum valuesIf the data type of the field is enum, specify the enum values in JSON format.
For reference, take a look at 'Status' field from Incident schema.
Search category nameUse the field to form a filtering qualification for similarity search by using (MFS) Multi-Form Search.
Important:  The field definition must match the field value set for Full Text MFS Category Name in BMC Helix Innovation Studio.
StatusSelect Active or Inactive to activate or inactivate the attribute, respectively.
Additional info

Provide additional information for an attribute to give the LLM clearer contextual meaning.

The following examples show how additional information improves attribute understanding:

  1. ASCHG (Change schema):
    Describes the Change Coordinator or assignee. To retrieve unassigned change tickets, use the qualification 'ASCHG' = $NULL$.
  2. End of support (Asset):
    Indicates the date after which the asset is no longer supported.
DescriptionSpecify a description for the attribute.
It provides general, human-readable information about the record for administrators. This field is optional and meant only for reference.
IsSortableToggle to ensure the fields marked can be used for sorting.
IsFilterableToggle to ensure the fields marked can be used for filtering.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC Helix ITSM 26.2