Adding entities and managing synonyms

Plan requirement

Subscription Suite Growth or higher
Also required Copilot
Access Admin

Defining what to extract and every way customers name it. The synonym list is where this succeeds or fails.

Add one

  1. Open the entities in the intelligent triage settings.
  2. Add an entity and name it.
  3. List its values.
  4. Add the synonyms for each value.
  5. Watch what gets extracted from new tickets.

Get the synonyms from tickets, not from marketing

Search your tickets for a product and read how customers refer to it. You will find the abbreviation your team uses internally, the name from two versions ago, three misspellings, and a description by colour.

That list is the entity. The official product name is one entry in it.

Include the wrong versions

Common misspellings, missing hyphens, the name run together. Customers type quickly on phones, and an entity that only matches the correct spelling misses a substantial share.

Cover each language

Synonyms are language-specific, and a list built in English extracts nothing from Dutch tickets. Where you support several languages, each needs its own entries.

Watch for values that overlap

Two products with similar names, or a synonym that belongs to both, produce confident wrong extractions. Where that happens, make the synonyms more specific rather than adding more of them.

Review after a launch

A new product arrives with no synonyms and gets extracted as nothing, or as its predecessor. Adding entity values belongs in the launch checklist alongside the article.

Check what is being missed

Tickets that clearly mention a product and have no entity are your synonym gaps, and reading ten of them fills most of them.

See also

Was this article helpful?

0

Still stuck?

Our support team will take a look with you.

Comments

0 comments

Article is closed for comments.