Entities

Entities are the individuals communicating within the data set. They communicate by way of their aliases, which are most commonly full email addresses, user ids, short names, and appear within the documents being analyzed. By understanding what aliases belong to each entity, and the role each entity plays in the matter, you can determine scenarios where client-attorney privilege occurs across the documents.

During the Validate Entities pipeline step our AI will group the aliases in the data set under a specific entity and then make an AI prediction as to whether the entity is playing a Legal Role in the matter. This information is populated on the Entities (Priv) tab for you to annotate on the Annotator Decision field using the process outlined in Suggested annotation workflow, adjust aliases that belong to each entity using the Merge and Move operations, and populate more extensive entity information. Annotating each entity allows for the AI to understand who could be privilege conferring within the matter and what documents they communicated on driving client-attorney privilege predictions. Like other annotation workflows, you will perform one round of annotating entities and then perform the Apply Annotations Action as specified in Validate Entities.

Entity annotations should be performed by someone with the role of Annotator. For more information see Roles and security permissions.

Use the Suggested annotation workflow to complete annotations quickly and accurately. Not using the Suggested annotation workflow could result in errors.

Requirements

Entities can only be annotated when the Validate Entities pipeline step has a status of Ready to Apply Annotations or when the Confirm Privilege Status pipeline step has a status of Ready to Apply Annotations.

Annotate entities

To annotate entities:

Navigate to the Annotation (Priv)>Entities (Priv) tab.
Filter the list to show Entities that you have not annotated by setting Annotator Decision to (Not Set).
Follow the Suggested annotation workflow.
Select the first Entity in the list that you would like to annotate.
Review the Prediction and Rationale fields and Entity Information section.
Annotate the entity.
1. Verify the linked aliases. Use the Move and Create New Entity operations on the Alias list to move aliases from one entity to another.
  These actions are only currently available outside of Edit mode.
2. Select either Legal Role, Not Legal Role, or Spammer on the Annotator Decision field.
The Entity Information section only needs to be updated when the Annotator Decision field is Legal Role.
Consider reviewing the Email Signature column within the Alias list or navigating to documents they sent or received to better understand who the entity is and their role in the matter.

You can optionally select Final Privilege Status during Validate Entities as Privilege Conferring, Privilege Breaking, or Privilege Neutral, however, this may result in you completing more annotations than necessary. If you select Privilege Conferring as the Final Privilege Status, the First Name and Last Name fields are required.

Select Save and Next to annotate the next entity.
To successfully annotate distribution lists as "Legal Role", add GenericLegalSupportWithinEntity to both the First Name and Last Name fields.

You have completed this round of entity annotations when all entities that have a Prediction field value of Legal Role have been annotated on the Annotator Decision field.

See Validate Entities to complete the pipeline step once you have performed all annotations.

Mass entity annotation

To annotate Entities using the Mass Actions available:

Navigate to the Annotation (Priv)>Entities (Priv) tab.
Filter the list to show Entities that you have not annotated by setting Annotator Decision to (Not Set).
Scroll through the list of Entities and select all of the Entities you want to annotate as Legal Role.
See Suggested annotation workflow.
Use the Annotate as Legal Role mass action button at the bottom of the page.
Confirm that you want to Annotate these Entities as Legal Role. This will update the Annotator Decision field on the items selected.
Repeat steps 3-5 to mass annotate Entities as Spammer or Not Legal Role using the Annotate as Spammer and Annotate as Not Legal Role mass action.

All entities annotated as Legal Role require a First Name and Last Name fields populated on the Entity information. Legal Role Entities missing the First Name and Last Name fields will result in a failure during Apply Annotations.

Annotate entities fields

The following fields appear when annotating entities:

Field	Field type	Required	Description	Notes
Artifact ID	Fixed-length text	N	A unique identifier for this specific entity. This value will never change and is not editable.	By clicking on this value from a list, you will be directed to that Entity page where you can find more metadata on the included entity. This field can be used when trying to find a specific entity.
Full Name	Fixed-length text	N	A combination of the entity’s First Name, Last Name, and Reference ID (to always create uniqueness). This field is not directly editable but will update once saved if a change is made to the First Name or Last Name fields.	Multiple entities may have the same First Name and Last Name, but the Full Name will always be unique due to the addition of the Reference ID.
First Name	Fixed-length text	N	The entity’s first name. This field is editable.	If you select Legal Role as the Annotator Decision and/or Privilege Conferring as the as the Final Privilege Status, this field is required.
Last Name	Fixed-length text	N	The entity’s last name. This field is editable.	If you select Legal Role as the Annotator Decision and/or Privilege Conferring as the as the Final Privilege Status, this field is required.
Aliases	Multiple object	N	This field links all aliases belonging to the entity. This field is not directly editable but can be changed using the Move or Merge operations.	An alias may only be linked to one entity, but an entity may have multiple aliases.
Alias – Email Signature	Fixed-length text	N	This field will show in the Alias list and is populated for each alias. It contains the longest email signature belonging to the alias that was found in the data set. This value will never change and is not editable.	Use this field to help populate the Annotator Decision field and Entity Information section while performing entity annotations.
Alias - Sent	Whole number	N	This field will show in the Alias list and is populated for each alias. The number of documents sent by this alias. This value will never change and is not editable.
Alias - Received	Whole number	N	This field will show in the Alias list and is populated for each alias. The number of documents received by this alias. This value will never change and is not editable.
Cluster	Fixed-length text	N	An ID generated to group similar entities that our AI suspects should be merged but require a user’s input. If you believe entities with the same Cluster need to be merged, you can use the Merge mass action to accomplish this. This value will never change and is not editable.	Not all entities will have a value in this field. If you decide not to Merge entities with the same Cluster, ignore this field as it is not editable.
Source	Single choice	N	The origin of the entity’s creation. Entities with a Client Brain or Known Attorney source should already be marked as annotated. Annotation focus should be on entities marked as By Way of Domain or Newly Discovered. This value will never change and is not editable.	Client Brain—this entity existed in a previous project that was run through aiR for Privilege. Known Attorney—this entity was added at the start of this project to the Known Attorney list. By Way of Domain—this entity has a Domain that was annotated as Law Firm in the Classify Domains step. Newly Discovered—this entity has a prediction value generated by our model.
Prediction	Single choice	N	The prediction by the AI model as to whether the entity is playing a Legal Role, Not a Legal Role, or Spammer in this matter. This value will never change and is not editable.	Annotation efforts should be focused on and prioritize those predicted as Legal Role.
Rationale	Long text	N	A description for why the entity received the prediction it did. This value will never change and is not editable.
Annotator Decision	Single choice	Y	This field is the most important annotation field and allows for you to confirm or deny the Prediction of Legal Role, Not Legal Role, or Spammer.	Your selection on this field will change what other fields require annotation.
Job Title	Fixed-length text	N	Populate this with the title of the individual within their organization. This information is used to provide more details for determining the entity’s privilege status in later steps.
LinkedIn URL	Fixed-length text	N	A web address found that supports your findings that the entity is in a Legal Role.	This is an optional field and is used by a Lead to QC the work before submitting.
Job Category	Single choice	N	Populate this with the legal job category of the individual within their organization. This information is used to provide more details for determining the entity’s privilege status in later steps. Choice of Compliance, Contracts, Counsel (External), Counsel (In- House/Internal), Legal Group Alias/Distribution List, Mergers & Acquisitions, Paralegal/Litigation & Legal Support, Patent/IP, Regulatory/Government Affairs & Relations, and Unspecified/Other Legal Role.
Maiden Name	Fixed-length text	N	The entity’s maiden name. This information is used to find all the ways this entity may have communicated or may have been mentioned in this data set.
Middle Name	Fixed-length text	N	The entity’s middle name. This information is used to find all the ways this entity may have communicated or may have been mentioned in this data set.
Nicknames (Comma-delimited)	Fixed-length text	N	Any nicknames or other names the entity might have been referred to as in the data set. This information is used to find all the ways this entity may have communicated or may have been mentioned in this data set.	Separate multiple nicknames by a comma.
Sent Documents	Multiple object	N	This field links to the documents that this specific entity sent. This field is not editable.	This information can be used to inform annotations. The documents linked will change when a Merge or Move operation is performed. This field links to the documents that this specific entity sent. It includes all email segments.
Received Documents	Multiple object	N	This field links to the documents that this specific entity received. This field is not editable.	This information can be used to inform annotations. The documents linked will change when a Merge or Move operation is performed. This field links to the documents that this specific entity received. It includes all email segments.
Annotated	Yes/No	N	Upon annotating and saving an entity this field will be populated with a checkmark. This field is not editable.	This field can be used in searches to quickly find entities you have or have not annotated . This field can also drive dashboard widgets for visual representation of your annotation progress.
Impacted by Merge/Move	Yes/No	N	This field is used to indicate if a Merge or Move operation was performed on this entity. When entities are merged, the resulting entity will have this field as Yes. When an alias is moved from one entity to another, both entities will have this field as Yes.	Our AI will no longer make changes on entities that have this field set as Yes.
Privilege Project	Multiple object	N	This field links to the project that found this specific entity. This field is not editable.	An entity may link to multiple projects if it appeared in multiple analyzed data sets.
Reference ID	Fixed-length text	N	A unique identifier used by the system. This value will never change and is not editable.
Final Privilege Status	Single choice	N	A field used during the Privilege Status pipeline step. Select Privilege Conferring, Privilege Neutral, or Privilege Breaking.	If you select Privilege Conferring as the Final Privilege Status, the First Name and Last Name fields are required. Annotators can ignore this field.
Total Sent Count	Whole number	N	This field is the number of documents sent by this Entity.
Total Received Count	Whole number	N	This field is the number of documents received by this Entity.

Merge mass operation

The Merge mass operation exists on the Entity tab and lets you select multiple entities and move their linked aliases to a single entity. This will be used when the AI is conservative and creates multiple separate entities when there should have been a single entity.

To perform a Merge mass operation:

Navigate to the Annotation (Priv)>Entities (Priv) tab.
Identify and select the entities you’d like to merge using the check boxes on the left side of the Entity list.
Beneath the Entities list select the Merge operation within the Mass Operation drop-down menu.
A modal will appear with the list of entities you selected.
Select the entity you want all aliases merged into.
All non-selected entities will be deleted after their aliases are moved over to the selected entity.
When entities are merged the system will append the Privilege Project field values across all entities being merged so that no connection to a privilege project will be lost.
Select the Merge button to perform the operation.

Upon successful completion only one entity will remain with all aliases linked to it. All documents that were linked to the entities included in this operation will now be linked to the single resulting entity. That resulting entity will have a value of Yes on the Impacted by Merge/Move field and will no longer be editable by the AI during future Apply Annotation actions.

You can only include Entities that are connected to your In-Progress project in the Merge mass action. Including Entities from previous projects in this workspace will error out.

Move and Create New Entity operations

The Move and Create New Entity operations exists on an individual entity page and allow you to select multiple aliases linked to that entity and move them to a different entity. If you are unable to find an existing entity to move the aliases to, the Move modal has a button that allows you to Create a New Entity. These operations will be used when the AI links an alias to the wrong entity.

The Create New Entity button is found on the Move modal. We recommend trying to find an existing Entity to move the Aliases to before creating a new entity in order to limit duplicates.

The Move and Create New Entity operations are not available in Edit mode. Exit Edit mode to find those buttons and perform those operations.

To perform a Move or Create New Entity operation:

Navigate to the Annotation (Priv)>Entities (Priv) tab.
Select an individual entity that you want to move aliases from.
Locate the Alias list on the Entity page.
Identify and select the aliases you want to move using the checkboxes on the left side of the Alias list.
Above the alias list select the Move button.
A modal will appear with the list of all entities in the workspace.
Select the entity you want to move these aliases to.
Select the Move button to perform the operation.
If you do not find an existing entity you want to move the alias to, use the Create New Entity button on the modal.
Input the new entity’s First Name and Last Name. If you have the context, input the Annotator Decision and/or the Final Privilege Status.

Upon successful completion the aliases you selected will no longer be linked to this entity. All documents that were linked to this entity by way of those aliases will also be unlinked to this entity. Both the entities that you moved aliases from and to will have a value of Yes on the Impacted by Merge/Move field.

Suggested annotation workflow

Following is the suggested annotation workflow for Validate Entities. These steps should be completed in priority order.

If you've previously run a Privilege project in this workspace, you should also add a search condition of Privilege Project = current project to focus annotations on entities that are relevant to the current project.

Following is the suggested workflow for entity annotation:

Step	Expected annotation	Content type	Example	How to locate
1	Merge (Priv) Mass Action	Clusters of Entities that should be merged	John Doe jd@domain.com John Do John.doe@domain.com	Perform the following search across entities: Review items that have the same Cluster ID and use the Merge (Priv) action to merge them if they are the same entity.
2	Legal Role	By way of domain	Jane Doe janedoe@lawfirm.com	Perform the following search across entities:
3	Legal Role	Likely Legal Email Signatures	Jane Doe jd@client.com Email signature: General Counsel John Doe john.doe@client.com Email signature: Head of Compliance Jim Doe jim.doe@client.com Email signature: Regulatory Affairs	Perform the following search across entities:
4	Not Legal Role	Email Signatures	Jane Doe jd@client.com Email signature: Project Manager John Doe john.doe@client.com Email signature: Sales Associate Jim Doe jim.doe@client.com Email signature: Engineering	Perform the following search across entities:
5	Legal Role	Top Communicators	Jane Doe jd@lawfirm.com Sent: 20	Perform the following search across entities: This image is an example of how Search Conditions should look. Document count varies depending on the size of your data set. Adjust the value of n until you get roughly 100 entities returned.
6	Legal Role	AI Predicted Legal Role	Jane Doe jd@lawfirm.com Prediction: Legal Role	Perform the following search across entities:
7	Not Legal Role	Top AI Predicted Not Legal Role	Jane Doe jd@lawfirm.com Prediction: Not Legal Role	Perform the following search across entities: This image is an example of how Search Conditions should look. Document count varies depending on the size of your data set.
8	Legal Role	Document Check	We are trying to find documents that include legal terms but where no Legal Roles we’ve identified is participating. This is a method for finding missed entities. You are reviewing these documents not to make a Privilege call, but to catch missed Entities and annotate the entities as Legal Role.	Navigate to the Document Tab and perform the following search across documents: It helps to create a view with the following fields, so you can jump into an entity and annotate them: · Control Number · Priv Sender Entities (all email segments) · Priv Sender Entities (all email segments)::Annotator Decision It helps to add the following field to your coding layout, so you can jump into an entity and annotate them: · Priv Sender Entities (all email segments) · Priv Recipient Entities (all email segments)
9	Merge (Priv) Mass Action	Spot Check Aliases	We are trying to find entities that should be merged into Entities that have been annotated with Legal Role.	Perform the following search across entities (remove the Annotator Decision IS NOT SET search conditions): Cluster IS SET, AND then SORT by the Cluster field Scroll down the page and check the Annotator Decision field for entities that have an Annotator Decision = "Legal Role". For each of these entities, look at the other entities with the same Cluster Id (if they exist, they might have already been merged) and decide whether a merge should occur or not. Then remove all conditions, AND then SORT by the Full Name field. Perform the same action and scroll down the page checking the Annotator Decision field for entities that have an Annotator Decision = "Legal Role". This time look for the entities above and below these entities to see if they have similar Full Names and should be merged.