Conversational text
Guide for conversation or thread-based text data.
When creating a project, select Conversations.
Conversational UI is used for annotating text in the context of a conversation.
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.
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.
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.
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.
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.
- 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.
- Add an optional subclassification to the relationship.
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. |