Taxonomy Advisor
The PoolParty Taxonomy Advisor, enhances taxonomy enrichment by leveraging Large Language Models (LLM) to create narrower concepts and alternative labels.
Taxonomy Advisor assists users in their work on extending their taxonomies. The currently supported features are:
obtaining suggestions for narrower concepts
receiving suggestions for alternative labels
Note
Please note that the LLM used deploys carefully crafted prompts to ensure the best possible quality of the suggestions for both narrower concepts and alternative labels while adhering to the state-of-art security standards.
Note
Currently these functions are only supported in English. Taxonomy Advisor may function in other languages too, but we cannot guarantee high quality results.
Being a PoolParty feature Taxonomy Advisor requires authentication. This external service connection has be set up in the Semantic Middleware Configurator before you can use it. To explore the Taxonomy Advisor functionalities proceed as follows:
Start PoolParty in your browser and enter your credentials to log in.
The PoolParty home page opens where you can select the project to work on.
Now open the project where you want to use Taxonomy Advisor.
You can either use the the PROJECT (1) menu or select the desired project from the list of all available projects and clicking the Open button.
Note
Either click Open Project (2) or Recently Opened Projects (3) under the PROJECT menu (1) to select the project you want to work on. You can also search for the desired project using the Search Projects field.
After the desired project has been loaded you can use the Taxonomy Advisor in two ways:
After having selected a concept (1) on the tree view on the left hand side you see all details of the selected concept. At the bottom of the Narrower Concepts (2) respectively Alternative Labels (3) sections you see three respectively two little icons. Clicking the last one will either open a dialog showing LLM suggested narrower concepts respectively a dialog listing LLM recommended alternative labels.
After having selected a concept (1) on the tree view right click it to open the context menu where you see the new feature Extend the taxonomy (2); click the little arrow to show the two available sub-items: Add Narrower Concept (3) and Add Alternative Label (4) to open the respective dialog showing either the LLM suggested narrower concepts respectively the LLM recommended alternative labels.
In this guide we will add both alternative labels and narrower concepts to a selected concept. The following steps will give you all the details on how to benefit from the LLM based Taxonomy Advisor.
Let us now add narrower concepts. As mentioned above either use the context menu Add Narrower Concepts (Step 3.b) or click the last little icon underneath all existing narrower concepts (Step 3.a).
This opens a new dialog listing narrower concepts suggested by the LLM. Initially, this list shows the first few suggested narrower concepts. To expand this list click on More suggestions ... at the bottom of this list to display up to eight new suggestions.
The above screenshots shows an expanded list of suggested narrower concepts for the concept Anaconda (1). If you go over the i symbol on the right (2) of this dialog with your mouse, an info appears stating that the content has been generated by an external LLM service. The Add selected concepts (7) button remains grayed out until you have selected at least one concept from the list of suggestions.
You can select all suggestions by ticking the Select all checkbox (3) or individually select the concepts by ticking the respective leading checkbox (4) before each listed concept.
If you want to edit the narrower concept's label simply put the mouse over this concept to display the pen symbol (5), with a click the name of the concept will be editable (6).
Note
The following characters are not allowed when changing the name of a concept label:
\,",<,>, tabs and line breaks.When you are happy with the selected suggested narrower concepts click the now active Add selected concepts (7) button. If you want to abort the operation click on Cancel (8).
Note
Clicking Add selected concepts (7) triggers a check for duplicates. If the concept label already exists an error message appears. Now you can either change such label name or abort the operation with a click on Cancel (8).
The procedure for adding alternative labels is virtually the same as for adding alternative concepts. As mentioned before either use the context menu Add Alternative Labels (Step 3.b) or click the last little icon underneath all existing alternative labels (Step 3.a).
This opens a new dialog listing alternative labels suggested by the LLM. Initially, this list shows the first few suggested alternative labels. To expand this list click on More suggestions ... at the bottom of this list to display up to eight new suggestions.
The above screenshots shows an expanded list of suggested alternative labels for the concept Anaconda (1). If you go over the i symbol on the right (2) of this dialog with your mouse, an info appears stating that the content has been generated by an external LLM service. The Add selected labels (7) button remains grayed out until you have selected at least one alternative label from the list of suggestions.
You can select all suggestions by ticking the Select all checkbox (3) or individually select alternative labels by ticking the respective leading checkbox (4) before each listed alternative label.
If you want to edit the name of the alternative label simply put the mouse over this label to display the pen symbol (5), with a click the name of this alternative label will be editable (6).
Note
The following characters are not allowed when changing the name of an alternative label:
\,",<,>, tabs and line breaks.When you are happy with the selected suggested alternative labels click the now active Add selected labels (7) button. If you want to abort the operation click on Cancel (8)
Note
Clicking Add selected labels (7) triggers a check for duplicates. If the alternative label name already exists an error message appears. Now you can either change such label name or abort the operation with a click on Cancel (8).
Note
This external service requires authentication. Your API key can be saved under the Taxonomy Advisor option in the Semantic Middleware Configurator. If you are not sure whether your API key configuration in the Semantic Middleware Configurator is correct, please contact us.
It may happen that the external LLM service is not reachable or there are other connection problems. In such a case a corresponding error message will be displayed. If no connection can be established we recommend a retry after a couple of hours, or if the problem persists, contacting us.
A corresponding error message may appear if the LLM could not generate any valid suggestions. In this case you can retry without any delay. Should the problem persist after another three attempts, please contact us.