Agent Activity Schema

The Activity schema tab shows the schema versions defined for an agent and the validation rules applied to its spans.

Schema versions

A list of all schema versions for the agent. Each entry shows the schema identifier and when it was created. The (current) label indicates the schema Prefactor is actively using to validate spans.

Selecting a schema version shows:

• Schema version – the human-readable identifier.
• Schema version number – the version string.
• Created – when this schema version was created.

Span types

For the selected schema version, the page lists the span kinds Prefactor expects. Common types include:

• agent – top-level agent orchestration.
• chain – chained operations or workflows.
• llm – language model calls.
• tool – tool or function invocations.

Payload and result schemas

Each span type has two JSON Schema definitions:

• Payload schema – validates the input payload for that span.
• Result payload schema – validates the output payload for that span.

Schemas are shown inline. The UI displays a Valid indicator when the JSON Schema definition itself is well-formed.

Example payload schema (permissive):

{
  "additionalProperties": true,
  "type": "object"
}

Example result payload schema (strict):

{
  "additionalProperties": false,
  "type": "object"
}