How to add a concept with the AI Model Builder
- Last Updated: May 13, 2026
- 6 minute read
- Semaphore
- Documentation
This topic describes how to use the AI Model Builder to request concept suggestions and add the following concept types to your model:
- Top concepts: The highest level and broadest concepts in a concept scheme.
- Narrower concepts: Concepts that have narrower relationships to broader concepts in your model. By defining narrower concepts in your models, you can improve the accuracy of your results.
Concepts are the core entity in a model. Concepts can have multiple labels, metadata properties, and relationships to enrich their meaning and purpose in a model. To assist in creating effective models, Semaphore includes an AI Model Builder tool. The tool allows you to quickly build your model by requesting concept suggestions from the AI assistant and then adding the suggestions to your model with a couple clicks.
Note: If you prefer, you can also manually add concepts to your model. See Add a concept for details.
Related videos
In this video, you learn how to enrich your semantic model in Semaphore using the AI Model Builder. This includes learning how to use the AI Model builder for alternative labels, narrower concepts and advanced suggestions.
Note: To see the video description, resources, and list of links on YouTube, hover over the video player and click the video title at the top.
Assumptions
- You have an existing model.
- The model contains at least one concept scheme.
- You have the MANAGER, EDITOR, or CONTRIBUTOR role for the model.
- You have configured the AI Model Builder.
Create a top concept
To create a top concept:
-
Open your model; then, click Open Master. Note that, for this procedure, we will use the provided Nature sample model in our examples.
-
In the list of concept schemes on the left, select the scheme for which you want to add a concept. For example, select Animals.
-
Open the AI Model Builder by doing one of the following:
- In the concept scheme list, click the Suggest icon
next to the scheme for which you want to add a concept. - In the Details view for your concept scheme, click Suggest top concepts in the Top Concepts section.
The Suggest top concepts pane opens.

- In the concept scheme list, click the Suggest icon
-
Choose whether you want to submit a basic or advanced request to the AI assistant:
- Basic: To execute a basic request, select Get Suggestions on the Basic tab. The Assistant AI generates a list of suggested concepts based on the model's name and description, and the selected concept scheme's labels and top concepts.
- Advanced: To execute an advanced request, select the Advanced tab; then, complete the following and click Get Suggestions.
- Select the model data or concept data you want considered in your request. By default, all the types of data are selected.
- In the Additional requirements or information field, type any additional requirements or information you want to submit for the request. For example, type
return only suggestions for arthropods.
A list of suggested concepts is returned.

-
From the Suggestions list, select the concepts you would like to create in your model. If you would like to see more than the top results, click Load More. Click Create selected to add your selected concepts to the model. For the purposes of our example, select Insect and Crustacean.
Note: After you click Get Suggestions, you must click Restart to modify the query and request an updated list of results.
Results: Your new top concepts have been created. You can view your new concepts by expanding the list for the concept scheme you updated. For example, expand the Animal list to see Insect and Crustacean added to the list. You can now enrich your top concepts by adding labels, concept relationships, narrower concepts, and more.
-
Optionally, in the Details view for your concept, provide the following data about your concept:
- Add or change classes.
- Change the preferred label or add a label in a new language.
- Add alternative labels in any language.
- Add metadata properties.
- Add or change Top Concept Of relationship to concept schemes.
- Add or change relationships to other concepts.
See the other topics in How to build a model section for more information on specifying concept data.
Results: You have successfully created top concepts.
Create a narrower concept
To create a narrower concept:
-
Open your model; then, click Open Master. In this procedure, we will use the provided Nature sample model in our examples.
-
In the list of concept schemes on the left, expand the list of concept schemes you want to update to expose the related concepts. Next, select the concept for which you want to create a narrower concept. For example, expand the Animals; then, select Mammal.
-
Open the AI Model Builder by doing one of the following:
- In the concept scheme list, click the Suggest icon
next to the concept for which you want to add a narrower concept. - In the Details view (the default) for your concept, click Suggest narrower concepts in the Narrower Concepts section.
The Suggest narrower concepts for pane opens.

- In the concept scheme list, click the Suggest icon
-
Choose whether you want to submit a basic or advanced request to the AI assistant:
- Basic: To execute a basic request, select Get Suggestions on the Basic tab. The Assistant AI generates a list of suggested concepts based on the model's name and description, in addition to the following criteria for the selected concept:
- Name and description
- Preferred labels and alternative labels
- Preferred labels of related concepts
- Class
- Advanced: To execute an advanced request, select the Advanced tab; then, complete the following and click Get Suggestions.
- Select the model data or concept data you want considered in your request. By default, all the types of data are selected.
- In the Additional requirements or information field, type any additional requirements or information you want to be submitted for your request. For example, type
return only mammal orders that contain hedgehogs and shrews.
A list of suggested concepts is returned.

- Basic: To execute a basic request, select Get Suggestions on the Basic tab. The Assistant AI generates a list of suggested concepts based on the model's name and description, in addition to the following criteria for the selected concept:
-
From the Suggestions list, select the concepts you would like to create in your model. If you would like to see more than the top results, click Load More. Click Create selected to add your selected concepts to the model. For the purposes of our example, select Eulipotyphla.
Note: After you click Get Suggestions, you must click Restart to modify the query and request an updated list of results.
Results: Your new narrow concept has been created. You can view your new concept by expanding the list for the concept scheme you updated. For example, expand the Animal and Mammal lists to see that Eulipotyphla has been added. You can now enrich the narrow concepts you created by adding labels, concept relationships, narrower concepts, and more.
-
Optionally, in the Details view for your concept, provide the following data about your concept:
- Add or change classes.
- Change the preferred label or add a label in a new language.
- Add alternative labels in any language.
- Add metadata properties.
- Add or change Top Concept Of relationship to concept schemes.
- Add or change relationships to other concepts.
See the other topics in How to build a model section for more information on specifying concept data.
Results: You have successfully created a narrower concept.