← Schema index / Config Reference

operator schema

Canonical generated docsThis section is generated from caco config schema --json. The table below preserves the runtime field path, type, required/default markers, and canonical description for every value in this slice.

Operator metadata so managed agents can refer to the operator by name. Substituted into profile bodies via {{operator.<field>}} placeholders.

Field pathTypeRequiredDefaultCanonical description
operatorsectionoptionalOperator metadata so managed agents can refer to the operator by name. Substituted into profile bodies via {{operator.<field>}} placeholders.
└ operator.namestringoptionalOperator's full name (e.g. 'Harry Tuttle').
└ operator.preferred_namestringoptionalPreferred form of address used in conversation (e.g. 'Harry'). Personalization mixins prefer this over name.
└ operator.short_namestringoptionalShort handle / nickname (e.g. 'hjt').
└ operator.emailstringoptionalOperator's email address.
└ operator.pronounsstringoptionalPreferred pronouns (e.g. 'they/them').
└ operator.timezonestringoptionalIANA timezone identifier (e.g. 'Europe/Helsinki').
└ operator.notesstringoptionalFree-form notes the operator wants exposed to managed agents (preferences, working hours, communication style).