Dialogflow provides many
to extract common types from end-user expressions.
For example, the
@sys.color type can be used to extract values like "red" or "blue".
For most applications, the values provided by Dialogflow work well.
However, your application may need to add additional values for system entities.
For example, you may want to add "blue-green" to the list of values for
Some system entities can be extended for this purpose.
For the complete list of extendable system entities, see the
system entities reference.
Where to find this data
- Go to the Dialogflow Console.
- Select an agent.
- Select Intents or Entities in the left sidebar menu.
If you are building an agent using the API instead of the console, see the Intents reference and EntityTypes reference. The API field names are similar to the console field names. The instructions below highlight any important differences between the console and the API.
Extend a system entity while annotating a training phrase
From the intent page's training phrase section, you can extend a system entity while annotating a training phrase. If you manually annotate a training phrase part with an extendable system entity that does not include the selected value, you will be prompted to add this value to the system entity.
Extend a system entity from the entities page
From the entities page, you can extend a system entity by following these steps:
- Create an entity.
- Use the name of the system entity you want to extend. For example:
- Provide entity entries using the values you want to extend the entity with.
If you are using the API to extend system entities, create system entity extensions similar to how you create developer entities. Provide the name of the system entity you wish to extend, and provide the values you want to extend it with. If you attempt to extend a system entity that is not extendable, you will receive an error.
View and update extended system entities
The top of the entities page has Custom and System tabs. Select the System tab, and the system entities currently used by your agent are listed. Entities shown in a grey font color are not extendable, and entities shown in a normal font color are extendable. You can select an extendable entity and update the extended values.