Conversational text
Guide for conversation or thread-based text data.
When creating a project, select Conversations.
![](https://files.readme.io/4c0c5b1-image.png)
![Screenshot.png 2436](https://files.readme.io/6d1316b-Screenshot.png)
Conversational UI is used for annotating text in the context of a conversation.
![Screenshot - Thread.png 2356](https://files.readme.io/c63693d-Screenshot_-_Thread.png)
Thread-based UI is used for annotating text in the context of a multi-user thread.
Import conversational text
To learn how to import conversational text data, visit our documentation on importing conversational text.
Data row size limit
To view the maximum size allowed for a data row, visit our limits page.
Supported annotation types
Below are all of the annotation types you may include in your ontology when you are labeling conversational or thread data. Classification-type annotations can be applied globally and/or nested within an object-type annotation.
Feature | Import annotations | Export annotations |
---|---|---|
Entity | See payload | See payload |
Relationships | See payload | See payload |
Radio classification (Global or message-based) | See payload | See payload |
Checklist classification (Global) | See payload | See payload |
Free-form text classification (Global) | See payload | See payload |
Entity
To create an entity, simply choose the entity tool in your ontology and select the text string by clicking the desired starting character and dragging to select a sequence of characters in the unstructured text.
![Entity.gif 1408](https://files.readme.io/152cdf0-Entity.gif)
Note that the labeler cannot annotate the text with a grey background.
Please note that in both the conversational and thread-based UI, the annotator will only be able to label messages that have been marked as canLabel
in the import file. The messages that can be annotated will have a white background while those that cannot be annotated will have a grey background.
Message-based radio classifications
One unique feature of our conversation editor is the ability to label specific messages in a conversation with a radio classification value. This enables you to annotate messages with values such as intent or user sentiment.
![Message Classification.gif 1668](https://files.readme.io/2a66195-Message_Classification.gif)
In order to configure your radio classification as a message-based classification, you must configure your radio classification task as a Frame/pixel-based classification value during ontology configuration. If this value is not configured correctly, the radio classification will apply to the entire conversation rather than a single message.
![Message Settings.png 804](https://files.readme.io/2cde233-Message_Settings.png)
Relationship
With annotation relationships, you can create and define relationships between entity annotations in the conversational text editor. You can then use these annotation relationships to consolidate labeling workflows and potentially reduce the number of language models needed.
Follow these steps to create a relationship between two entity annotations:
- In the editor, create two entity annotations.
![](https://files.readme.io/410b8dc-create-relationship-1.png)
- Select the relationship annotation from the Tools menu, then click on one of the entity annotations. To create the relationship, move your cursor to another entity and click to create the relationship.
![](https://files.readme.io/3b7137a-create-relationship-2.png)
- Add an optional subclassification to the relationship.
![](https://files.readme.io/a5c4f5a-create-relationship-3.png)
Text-specific hotkeys
Function | Hotkey | Description |
---|---|---|
Create a relationship | Option + Click (source) + Click (target) | Select an entity to be the source of a relationship, then connect it to another entity to be the target. |
Updated about 2 months ago