Docs Navigation

Core Model

Session, Behavior, Actor, Action, Target, Content, Variables, and Evaluations.

The Core Model defines the conceptual building blocks of ABS. It is intentionally abstract — the formal grammar and conformance rules are in the Specification.

Rendering diagram…

Session

A Session is the top-level container. It models a single coherent interaction — a conversation, a task execution, a workflow — from start to finish.

  • Named with a human-readable session field.
  • Contains an ordered list of behaviors.
  • May carry session-level evaluations that check the whole trace.

Behavior

A Behavior is a single observable action performed by an Actor. The five key fields are:

actor + action + target + content + (capture | with | evaluations)

Not every field applies to every Behavior. A user saying something needs actor, action, and content. An assistant calling a tool needs actor, action, target, and with. The combination of fields that makes sense depends on the action category.

Actor

An Actor is who or what performs the Behavior:

ActorDescription
userThe human user interacting with the agent.
assistantThe AI agent under test.
<any string>A named sub-agent, tool, or system component.

Action

An Action is what the Actor does. ABS defines a standard vocabulary organized by category:

CategoryActionsSemantic
Communicationsays, asks, informs, shows, prompts, confirmsInformation exchange between actors.
Executioncalls, submits, retrieves, stores, updatesInvoking external systems or tools.
Delegationhands_offTransferring control to another agent or human.
Interactionselects, uploads, approvesActing on UI elements.

The full vocabulary with definitions is in Vocabulary.

Target

Target is the object or destination of the action. Its meaning depends on the action category — see the Specification §4 for the normative rules.

Content

Content is the payload of a Behavior — text, structured data, or displayed information. It can contain {{variable}} references.

Variables

Variables let you capture values at runtime and reuse them later. See Variables for the full rules on capture, reuse, and runtime binding.

Evaluations

Evaluations make a descriptive spec executable. They can be:

  • Step-level: attached to a single Behavior, checking it in isolation.
  • Session-level: at the top of the document, checking the whole trace (ordering, consistency, invariants).

See Evaluations for all evaluator types and semantics.