ixp
latest
false
Important :
Communications Mining is now part of UiPath IXP. Check the Introduction in the Overview Guide for more details.
UiPath logo, featuring letters U and I in white

Communications Mining user guide

Last updated Aug 1, 2025

Understanding labels, general fields, and metadata

Before designing your taxonomy, you need to understand what labels, general fields, and metadata should capture to meet your objectives. There should be minimal overlaps as they all complement each other.

Labels capture concepts, themes, and intents. For example, change of address request, urgent, status update request, and so on. You should not use labels to capture information that is present in the metadata.

General fields capture structured data points extracted from the text. For example, policy numbers, trade IDs, URLs, dates, monetary quantities, and so on.

Metadata provides additional structured information associated with each message. Metadata properties can be:
  • User properties - Defined and added pre-upload, such as NPS score.
  • Email properties - Captured from emails, such as sender, recipients, domains, and so on.
  • Thread properties - The platform automatically derives them for threaded data, such as emails and chats. For example, the number of messages in a thread, thread duration, and so on.

Comparing labels and general fields

This section lists the key distinctions and similarities between labels and general fields. The two are typically used in combination for automation, but individually they serve different purposes:

Labels

  • Captures intents, themes, and concepts.
  • Normalizes varied expressions into one structured data point, for example, determining whether a concept applies or not.
  • Assigned at the message level.
  • Learns from all of the communication text, as well as certain metadata properties.
  • Structured in hierarchies to add levels of specificity.

General fields

  • Captures specific values of a certain type, such as the date, extracted from the text.
  • Can be entirely rules-based and follow a very specific format.
  • Some types can be normalized into a structured format from varied expressions.
  • Communications Mining™ learns from the value of the general fields and the context of the paragraph it is in, as well as the surrounding text.
  • Assigned at the paragraph level.

Common to both labels and general fields

  • You can pre-train or train them from scratch.
  • Pre-trained labels and general fields are predicted as soon as you enable them, and the platform automatically retrains.
  • You can accept and reject label and general field predictions, and assign them when they are not predicted.
  • You can use both for analytics and automation use cases.

What the platform can learn during training

The platform makes label predictions based on the text of the message, as well as some metadata properties. For example, for emails, this means the subject and body of the email. For general fields, it learns from the assigned span of text, and the context of the text surrounding that span.

You can find the in following image:
  1. Subject line
  2. Body of the text - For threaded data, Communications Mining™ makes predictions based on the latest email only, not the full thread, which a thread ID links them.
  3. Some metadata - Communications Mining learns from some properties where themes can be identified, such as the sender or recipient domains, NPS scores, and so on. It does not learn from the specific senders and recipients of emails, that is, the full email addresses, and unique properties such as IDs.



Using labels, general fields, and metadata together

The following image contains an example of a message that shows how labels, general fields, and metadata are distinct, but complementary to one another. To automate this inbound request, you may require each of them for a specific purpose:

  • Labels - The Address change label is required to identify the nature of the request, that is, the intent.
  • General fields - The address line, town or city, and postcode are used to capture the new values that the address would be updated to. Labels would not capture the specific values.
  • Metadata - This process may only be implemented for certain clients, identifiable through sender domain. There is no need to create labels for specific clients as it is captured in the metadata.



Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo
Trust and Security
© 2005-2025 UiPath. All rights reserved.