Adding custom fields as attributes to the semantic model

If you have customized the HPD:HelpDesk or CHG:Infrastructure Change form and created custom fields, you can add the custom fields as attributes to the semantic model.

For example, if you have created a custom field called Location in the HPD:HelpDesk form, you can add the Location field as an attribute to the semantic model.

The semantic model provides a structured, business-oriented view of the BMC Helix ITSM objects, that is, incident, change request, and people data, and serves as metadata for the Large Language Model (LLM). The LLM uses the semantic model to comprehend the semantics of the data, set the context of the user questions, and generate accurate responses.

Related topics

Configuring Agentic chat for BMC Helix ITSM

When a user asks a question about incidents or change requests in Agentic chat, BMC HelixGPT uses the text from the user question and the semantic model configuration to establish the qualification criteria for determining the tickets to be returned in the response.

The semantic model is configured out-of-the-box and contains information about the HPD:HelpDesk, CHG:Infrastructure Change, and CTM:People form schemas, their attributes, and their relationship with other objects.

For example, the HPD:HelpDesk form is configured as a form schema, and the Priority field of the HPD:HelpDesk form is configured as an attribute in the semantic model. When a user asks a question to show incidents that have high priority, the LLM uses the semantics to determine the tickets to be returned.

To add custom fields as attributes to the semantic model

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.

AliasSpecify an alias name for the attribute.
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.

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.
StatusSelect Active or Inactive to activate or inactivate the attribute, respectively.
Additional info

Specify additional information about the attribute to provide additional contextual reference about the attribute to the LLM.

For example, additional information for the ASCHG attribute provides additional context about the attribute to the LLM.

DescriptionSpecify a description for the attribute.

 

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