One turn in a conversation. A reply uses its parent's key plus '.r' and the generation attempt, e.g. '.r0', '.r1'.
Record Key
any
Any valid record key
Properties
content
union
Required
No description available.
createdAt
string
datetime
Required
An RFC 3339 formatted timestamp.
effort
ref
network.sharedcomputer.chat.defs#effort
Optional
The reasoning effort (assistant message).
error
string
Optional
No description available.
maxLength: 3000 bytesgeneration
ref
network.sharedcomputer.chat.defs#generationRequest
Optional
Asks the assistant to reply (user message).
model
ref
network.sharedcomputer.chat.defs#modelRef
Optional
The model that generated the response (assistant message).
parent
string
record-key
Optional
The key of the previous message. Siblings are edits or regenerations.
role
string
Required
No description available.
Known values:
user, assistantstatus
string
Optional
Generation completion status (assistant message).
Known values:
pending, complete, error, cancelledusage
ref
network.sharedcomputer.chat.defs#usage
Optional
No description available.
View raw schema
{
"description": "One turn in a conversation. A reply uses its parent's key plus '.r' and the generation attempt, e.g. '.r0', '.r1'.",
"key": "any",
"record": {
"properties": {
"content": {
"refs": [
"network.sharedcomputer.chat.defs#plainContent",
"network.sharedcomputer.chat.defs#encryptedContent"
],
"type": "union"
},
"createdAt": {
"format": "datetime",
"type": "string"
},
"effort": {
"description": "The reasoning effort (assistant message).",
"ref": "network.sharedcomputer.chat.defs#effort",
"type": "ref"
},
"error": {
"maxLength": 3000,
"type": "string"
},
"generation": {
"description": "Asks the assistant to reply (user message).",
"ref": "network.sharedcomputer.chat.defs#generationRequest",
"type": "ref"
},
"model": {
"description": "The model that generated the response (assistant message).",
"ref": "network.sharedcomputer.chat.defs#modelRef",
"type": "ref"
},
"parent": {
"description": "The key of the previous message. Siblings are edits or regenerations.",
"format": "record-key",
"type": "string"
},
"role": {
"knownValues": [
"user",
"assistant"
],
"type": "string"
},
"status": {
"description": "Generation completion status (assistant message).",
"knownValues": [
"pending",
"complete",
"error",
"cancelled"
],
"type": "string"
},
"usage": {
"ref": "network.sharedcomputer.chat.defs#usage",
"type": "ref"
}
},
"required": [
"role",
"content",
"createdAt"
],
"type": "object"
},
"type": "record"
}