chat.gel.assistant.defs
Details · defs
| Kind | defs |
|---|---|
| Authority | assistant.gel.chat |
| Indexed |
#effort
stringThe model's reasoning effort.
knownValues: none | low | medium | high | max
#encryptedContent
objectA sealed plainContent, or the sealed fields of the enclosing record. All user content is sealed, metadata stays in the clear.
Properties
blobs
arrayEncrypted blobs the ciphertext refers to.
maxLength: 100
maxLength: 1000000
maxLength: 128
maxLength: 64
maxLength: 128
#extractedText
objectCache for text pulled from a file.
#filePart
objectAn attached file. If the app can extract text, it will be stored in 'extracted' for the model.
#generationRequest
objectProperties
attempt
integerThe reply is written as '{messageKey}.r{attempt}'. Increase by 1 to ask for a regeneration.
minimum: 0maximum: 1000default: 0
model
refModel used in generating the response. If empty falls back to previous response model, then the user's default.
tools
arrayThe tools the assistant may use for this reply, by name, such as 'web_search' or 'mcp_<server>_<tool>'. Leave it out to use the tools the user has switched on in their settings.
maxLength: 64
maxLength: 128
#imagePart
objectAn attached image.
#modelRef
objectThe model that wrote a reply, or that a request asks for.
#plainContent
objectThe pieces of a message, in order: text, attachments, the assistant's reasoning, and tool calls with their results.
Properties
maxLength: 1000
#providerData
stringJSON-encoded provider options for this part, such as reasoning signatures. Sent back unchanged when continuing with the same provider.
maxLength: 100000
#reasoningPart
objectThe model's thinking or reasoning text.
Properties
providerData
reftext
stringmaxLength: 500000
#sourcePart
objectURL source cited by the assistant.
#textPart
objectText written by the user or the assistant.
Properties
providerData
refmaxLength: 500000
#toolApprovalPart
objectThe user's approval state for a tool call that's waiting in the reply this message is responding to.
#toolCallPart
objectThe assistant asked to run a tool. If the message has no result for this call it means the tool never ran.
Properties
approval
string'pending' means the assistant stopped here and is waiting for user approval. When answering, write a user message with a toolApprovalPart for each waiting call. The reply to that message repeats each call, marked 'approved' or 'denied' and followed by its result, and replaces the waiting copy. Any waiting call the answer does not mention is treated as denied.
knownValues: pending | approved | denied
maxLength: 256
JSON-encoded arguments.
maxLength: 200000
providerData
refsource
stringThe tools source, such as the URL of an MCP server. Empty for the app's built-in tools.
maxLength: 1024
The app's name for the tool, such as 'web_search' or 'mcp_<server>_<tool>'.
maxLength: 128
#toolResultPart
objectWhat a tool returned. It belongs to the call with the same callId in the same message.
Properties
maxLength: 256
isError
booleandefault: false
Tool output as text or JSON-encoded data.
maxLength: 500000
outputBlob
blobUsed when the output is too long for the output record. Output will contain a summary in that case.
maxSize: 50000000accept: */*
#usage
objectToken counts for the reply.
Properties
Similar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
The model's reasoning effort.
-
chat.gel.assistant.message
recordOne message in a chat, from the user or the assistant. A reply's key is the user message's key plus '.r' and the attempt number, such as '.r0' or '.r1'. The app creates the reply with status 'pending' and no content, it fills it in when generation ends. Creating fails if the key is taken, so each attempt gets exactly one reply. Sort replies by attempt number rather than by key, since '.r10' sorts before '.r2'.
-
One turn in a conversation. A reply uses its parent's key plus '.r' and the generation attempt, e.g. '.r0', '.r1'.