Conversational Agents (Dialogflow CX) provides many system entities
to extract common types from end-user expressions.
For example, the @sys.color
type can be used
to extract values like "red" or "blue".
You can see the full list of system entities in the
System entity reference.
For most applications, the values provided by system entities 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 @sys.color
.
Some system entities can be extended for this purpose.
The
System entity reference
lists the system entities that can be extended.
System entity support differs for languages and regions. See the system entity limitations for details.
Extend a system entity
To extend a system entity:
Console
- Use the system entity in one of your parameters.
- Select the Manage tab.
- Click Entity Types.
- Select the System tab for system entities.
- 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.
- Provide entity entries using the values you want to extend the entity with.
API
Creating system entity extensions is similar to how you create custom 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.