Turn
A Turn is a series of Messages and Annotations that are relevant to the Turn.
Turns are distinct breaks between messages in a Thread. Turns contain a user message and any LLM response(s) to that user message.
Annotations at the Turn level apply to group of Messages in that turn. For example, the annotation for message preference is at the turn level.
A unique identifier for the turn.
A list of messages associated with this turn.
The role of the sender in the conversation (e.g., user, assistant).
system, user, assistant, function The content of the message, including text and any attachments.
The textual content of the message.
Any files or attachments included with the message.
The base64-encoded content of the file.
The MIME type of the file, indicating its format.
A URL pointing to the location of the file in Scale's storage.
A URL pointing to the source location of the file.
The ID of the source system or user that sent the message.
Annotations specific to this message.
Represents a generic annotation.
Unique identifier for the annotation.
Key for the annotation.
The type of the value and the possible_values, if they exist.
Title of the annotation.
Further details about the question.
String representation of the possible options.
A string representation of the annotation.
Unique identifier for an annotation.
Integer type annotation value.
The possible values for this annotation.
Integer type annotation value.
Annotations applied to the entire turn.
Represents a generic annotation.
Unique identifier for the annotation.
Key for the annotation.
The type of the value and the possible_values, if they exist.
Title of the annotation.
Further details about the question.
String representation of the possible options.
A string representation of the annotation.
Integer type annotation value.
The possible values for this annotation.
Integer type annotation value.
{
"id": "turn_abc123",
"messages": [
{
"role": "system",
"content": {
"text": "<string>",
"reference_texts": [
{
"content": "<string>",
"category": "<string>",
"url": "<string>"
}
],
"attachments": [
{
"content": "aSDinaTvuI8gbWludGxpZnk=",
"mime_type": "text/plain",
"scale_url": "<string>",
"url": "<string>"
}
]
},
"source_id": "source_abc123",
"model_parameters": {
"model": "my-model-123",
"temperature": 0.9,
"max_completion_tokens": 1000
},
"annotations": [
{
"id": "an_abc123efg456",
"key": "formatting",
"type": "<string>",
"title": "Response Formatting",
"description": "Does the response contain issues with formatting?",
"labels": [
"Major Issues",
"Minor Issues",
"No Issues"
],
"metadata": {
"criteria": "overall_quality"
},
"value": 3,
"possible_values": [
[
1,
2,
3
]
]
}
]
}
],
"annotations": [
{
"id": "an_abc123efg456",
"key": "formatting",
"type": "<string>",
"title": "Response Formatting",
"description": "Does the response contain issues with formatting?",
"labels": [
"Major Issues",
"Minor Issues",
"No Issues"
],
"metadata": {
"criteria": "overall_quality"
},
"value": 3,
"possible_values": [
[
1,
2,
3
]
]
}
]
}