Docs »

Records »

Types »

Behavior

Moved to an optional plugin in 12.0, and deprecated. Legacy bot behaviors now live in the cerb.behaviors.legacy plugin. On upgrade it is enabled automatically only if active behaviors exist, so installations without them stay clean. They will not be retired during 12.x, and gained improvements in 12.0. New work should use automations.

Change history

Legacy behaviors now track a change history the way automations do. From a behavior tree, click the event and choose Edit History to compare any two revisions in the diff viewer.

Name (singular): Behavior
Name (plural): Behaviors
Alias (uri): behavior
Identifier (ID): cerberusweb.contexts.behavior

Usage tracking

Behavior worklists offer a 'Usage' sparklines column charting runs and duration, with a 2h/1d/30d range toggle. A matching usage: quick search filter queries the same data – for instance, usage:(since:today).

Records API

These fields are available in the Records API and packages:

Req'd Field Type Notes
x bot_id number Bot
x event_point text The event of the behavior
  is_disabled boolean Is this behavior disabled?
  is_private boolean Is this behavior only visible to the parent bot?
  links links An array of record type:id tuples to link to. Prefix with - to unlink.
x name text The behavior's name
  priority number Any positive number; 0 is highest priority
  updated_at timestamp The date/time when this record was last modified
  uri text  

Dictionary Placeholders

These placeholders are available in dictionaries for automations, snippets, and API responses:

Field Type Description
_context text Record type extension ID
_label text Label
_type text Record type alias
bot_ record Bot
bot_owner_ record Bot Owner
event_point text Event
event_point_name text Event
id number Id
is_disabled boolean Is Disabled
is_private boolean Is Private
name text Name
priority number Priority
record_url text Record Url
updated_at date Updated
uri text Uri

These optional placeholders are also available with key expansion in dictionaries and the API:

Field Type Description
comment_count number Comment count on the record
comments comments Comments
custom_<id> mixed Custom Fields
links links Links
watchers watchers Watchers

Search Query Fields

These filters are available in behavior search queries:

Field Type Description
bot: record Bot
bot.id: chooser Bot
disabled: boolean Is Disabled
event: text Event
fieldset: record Fieldset
id: number Id
links: links Record Links
name: text Title
priority: number Priority
private: boolean Is Private
updated: date Updated
uri: text Uri
usableBy.bot: chooser Usableby Bot

Worklist Columns

These columns are available on behavior worklists:

Column Description
*_has_fieldset Fieldset
*_workers Watchers
cf_<id> Custom Field
t_bot_id Bot
t_event_point Event
t_id Id
t_is_disabled Is Disabled
t_is_private Is Private
t_priority Priority
t_title Title
t_updated_at Updated
t_uri Uri