The entity detection feature, which is part of agent copilot, allows you to define and detect unique information in tickets and messaging conversations. You can then use that information to populate associated custom ticket fields and power automated workflows and reports.
Entity detection is similar to intelligent triage in that it allows you to automate workflows based on information automatically detected within customer requests.
This article contains the following topics:
- About entity detection
- Creating an entity custom field
- Configuring values for an entity custom field
- Configuring ticket field update behavior and entity highlighting
- Turning off or deleting an entity custom field
- Taking action on a highlighted entity in a ticket or messaging conversation
Related articles:
About entity detection
Customer requests often contain specific pieces of information that your agents need to identify and act on in order to solve the request. Entity detection makes this process faster and easier by automatically identifying this critical information and making it available in automated workflows and reporting.
An entity is a piece of information that is meaningful for your business, such as a product name. To create an entity, you:
- Create a custom field to represent the piece of information (entity) you care about. For example, you might create an entity called Product Line.
- Associate values with that custom field to represent details about the entity. For example, you might associate the Product Line entity with the values Camera Model A, Camera Model B, and so on.
The custom field and its associated values can then be used in routing, automations, and reports to optimize your workflows.
Additionally, entity values are highlighted in blue in tickets, making it easier for agents to scan the ticket for important information.
Technical information about entity detection
When you create a custom field to represent an entity, the system adds that custom field to any tickets where a matching value has been detected. When tickets are created or updated, the custom field is populated based on the entity value detected in the ticket.
When the field is populated, a tag is also automatically added to the ticket to help you build triggers, automations, and reporting. These tags reflect the entity values you configure and are structured as entity_<entity custom field name>_<entity value>.
Also, note that an entity’s value can change over the course of a ticket’s lifecycle. For example, a ticket that starts out about one topic might evolve into another. Because of this, you can configure whether and how the custom field is automatically updated throughout the ticket’s lifecycle.
When configured, entity detection can detect entity values even when there are misspellings, including switched or missing letters. Detection of misspelled values:
- Works only when the first letter is the same as the entity value.
- Doesn’t work on patterns shorter than 6 letters.
- Allows for up to two errors in a word, including added, missing, misplaced, or replaced letters.
- Might not work in languages without spaces, or where a single character change results in a completely different meaning.
Entity detection works on all channels supported by intelligent triage. It’s not possible to turn entity detection on or off for only a subset of channels. Additionally, entity detection works on ticket subjects, public comments, and internal notes. Highlighting works only on public comments and internal notes.
Understanding AI-powered prediction: Intelligent triage vs. entity detection
Intelligent triage and entity detection are two AI-powered features that make predictions to help you automate your workflows. However, each feature accomplishes this goal in slightly different ways, and their predictions can be broken down into two types:
- Classifiers: Prebuilt by Zendesk and used in intelligent triage. Classify tickets into specific intent, language, and sentiment taxonomies based on our machine learning models.
- Extractors: Created by you and used in entity detection. Detect and extract specific information based on your configuration.
You can see and manage all predictions from the Intelligent triage settings page in Admin Center. Classifiers appear only if you have the Advanced AI add-on.
Creating an entity custom field
Admins can create an entity custom field in Admin Center.
To create an entity custom field
- In Admin Center, click Objects and rules in the sidebar, then select Business rules > Intelligent triage.
- Click Add prediction.
- In the Name field, enter a descriptive name and click Next.
- Under Select field type, select Drop-down.
- Click Create.
Configuring values for an entity custom field
After you’ve created an entity custom field, you must configure the values that correspond to the field. For example, if your entity custom field is Product line, the values might be Camera Model A, Camera Model B, and so on.
To configure values
If you just created an entity custom field, skip to step 3.
- In Admin Center, click Objects and rules in the sidebar, then select Business rules > Intelligent triage.
- Click the entity custom field you created above.
- On the settings page for the entity custom field, click the Values tab.
- Choose whether to manually add individual values or upload a CSV file of all
values:
- To add values manually:
- Click Add new.
- Enter the value that should be detected in tickets.
- Click the checkmark.
- To upload a CSV file:
- Click Upload CSV.
- Click Choose a file or drag and drop here to select a CSV file, or drag and drop the CSV file into the field.
- Click Upload.
- To add values manually:
- Click Save.
Configuring ticket field update behavior and entity highlighting
You can configure how the ticket field associated with the entity custom field is updated based on ticket comments or messages. You can also configure whether entity values are highlighted in tickets and messaging conversations.
To configure ticket field update behavior and entity highlighting
If you just configured the values for an entity custom field, skip to step 3.
- In Admin Center, click Objects and rules in the sidebar, then select Business rules > Intelligent triage.
- Click the entity custom field you created above.
- On the settings page for the entity custom field, click the General settings tab.
- Under Update ticket field with detected values, configure the
behavior of the ticket field associated with the entity custom field by
selecting one of the following options:
- Don’t update ticket fields: The ticket field is not automatically populated with any value. An agent must manually populate it by clicking Update.
- Values in first message only: The ticket field is populated with the value detected in the ticket’s first comment or conversation’s first message. Subsequent comments or messages do not automatically update the ticket field value.
- Values in subsequent messages only: The ticket field is initially populated and subsequently updated with the value detected in any ticket comment or message except for the first one.
- Values in all messages: The ticket field is initially populated and subsequently updated with the value detected in any ticket comment or message.
- If you selected any option except Don’t update ticket fields, select Replace existing ticket field value if the new value in the ticket field should overwrite the old value. Otherwise, the ticket field will not be updated if it already has a value.
- Under Agent tools, select Highlight entity values in all messages if you want entities to be highlighted in blue in tickets and messaging conversations. When this option is selected, agents will also be able to take action on highlighted entities.
- Under Detection settings, select Detect misspelled values if you want to allow the system to find misspelled entity values.
- Click Save.
Turning off or deleting an entity custom field
If you no longer want an entity to be detected in tickets, you can delete the entity custom field. When you do this, all entity-related highlighting is removed from all tickets, even tickets that were created while the entity was active.
If you don’t want to delete the custom field, but you don’t want it to be active for a while, you can turn it off instead. When you do this, all entity-related highlighting is removed from all tickets, just like when you delete an entity custom field.
To turn off entity detection for an entity custom field
- In Admin Center, click Objects and rules in the sidebar, then select Business rules > Intelligent triage.
- Click the entity custom field you want to turn off.
- Deselect Turn on <entity name>.
- Click Save.
To delete an entity custom field
- In Admin Center, click Objects and rules in the sidebar, then select Business rules > Intelligent triage.
- Hover your mouse over the entity custom field you want to delete.
Taking action on a highlighted entity in a ticket or messaging conversation
When the Highlight entity values in all messages option is selected, entities are highlighted in blue in tickets and messaging conversations. Agents can click a highlighted entity and quickly update the associated custom field with the highlighted value or else copy the value to the clipboard.
When a highlighted value is completely shaded in blue, it means the associated entity custom field on the ticket has already been populated with that value. The only action available to the agent is Copy.
When a highlighted value is only outlined in blue (not shaded), it means the value hasn’t yet populated the entity custom field. The actions available to the agent are Update and Copy.
To take an action on a highlighted entity
- In Agent Workspace, open a ticket or messaging conversation.
- Click a highlighted entity value.
- Select from the following options:
- Update: (Available only if the highlighted value hasn't already populated the entity custom field) Updates the value of the associated custom field with the highlighted value.
- Copy: Copies the highlighted value to the clipboard.
9 comments
Yaniv Dayan
Hi, nice feature!
Can we have synonym names for the same product/dropdown field value? For example, the product name is called TerraExplorer Pro, but some clients call it TEP or TerraExplorerPro.
Or per your example, Camera Model A or CMA should point to the same Product Line dropdown field value.
1
Yaniv Dayan
Hi, nice feature!
Can we have synonym names for the same product/dropdown field value? For example, the product name is called TerraExplorer Pro, but some clients call it TEP or TerraExplorerPro.
Or per your example, Camera Model A or CMA should point to the same Product Line dropdown field value.
0
Yaniv Dayan
The Dropdown field should be Multiple Selection for multiple products.
Some requests can be relevant to multiple products, for example, Camera Model A and Camera Model B. However, the drop-down field allows only one product.
1
John Tieu
Two questions about taxonomy:
0
Anton Maslov
Erin O'Callaghan any plans to add the same functionality for the Regex field type? It would be nice to automatically add like order ID or license number.
0
Tatiana Christensen
As Anton writes, yes, please, to Regex field type!
It'd be very valuable for us to capture e.g. what order no or invoice no the inquiry is about in tickets via email. It seems that it's not possible at the moment. So the regex extractor would highlight the recognized order id and there'd be an optional rule to add it to an order id custom field?
I also wonder how e.g. multiple order references in one ticket would be handled. Unsupported? In the same field with preferred separators?
For the time being, we are happy to test the existing capabilities of this functionality. Just need to identify some use cases… My initial testing suggests that the entity recognition works straight away.
1
Andrew Lee
+1 to Yaniv, looking for the entity detection to be able to catch on synonyms or slight misspellings.
Example
- entity: Nikon D7500
- variation that should still classify with the same entity: nikoond7500, d7500, nd7500, etc.
1
Erin O'Callaghan
Hi Anton Maslov and Tatiana Christensen, regarding plans to add this functionality for the Regex field type, that enhancement is something the team is investigating for future implementation!
1
Elsa Aguilera
Erin O'Callaghan Any idea on when Regex fields or dates fields will be available to complete? Also, are you planning to include the possibility to create a definition of the information to extract from the ticket. (Exemple : Extract the date of the event the customer wants to attend / Result : Complete a date field on the form). Thanks
0