AIOperator

Represents an AI operator instance: a perpetual adaptive monitoring loop executed by the server AI assistant. Objects of this class are read-only and can be obtained with the GetAIOperator and GetAIOperators functions.

Instance attributes

consecutiveFailures: int

Number of consecutive failed iterations. Reset to 0 after a successful iteration.

creationTime: int64

UNIX timestamp of instance creation.

currentFocus: String

Short description of what the operator is currently focusing on, set by the operator itself on each iteration.

dailyTokenBudget: int

Daily LLM token budget (0 means unlimited).

description: String

Instance description.

enabled: bool

true if the instance is enabled.

executing: bool

true if an iteration is currently being executed.

id: int

Unique instance ID.

iteration: int

Iteration counter (reset when accumulated state is reset).

lastExecutionTime: int64

UNIX timestamp of last executed iteration (0 if never executed).

lastExplanation: String

Explanation of results or error message from the last iteration.

maxInterval: int

Maximum interval between iterations in seconds.

memento: String

Operator’s persistent memory carried between iterations (usually a JSON document, can be parsed with JsonParse).

minInterval: int

Minimum interval between iterations in seconds.

modelSlot: String

LLM provider slot used by this instance (empty string if default slot is used).

modificationTime: int64

UNIX timestamp of last configuration change.

name: String

Instance name.

nextExecutionTime: int64

UNIX timestamp of next scheduled iteration.

ownerUserId: int

ID of the user account the operator runs as.

personaPrompt: String

Additional persona instructions appended to the operator system prompt.

scopeFilter: String

Description of the monitoring scope given to the operator.

tokensUsedToday: int64

Number of LLM tokens used within the current day (UTC). The counter is reset by the first iteration after a UTC day boundary, so until then it still shows the previous day’s usage.

watchList: String

List of entities the operator is currently watching, set by the operator itself on each iteration (usually a JSON document, can be parsed with JsonParse).