Agents

Package, deploy, inspect, and operate durable Agent behavior on Constal.

An Agent is a stable, CRN-addressed workload authored with @constal/sdk. Deploying changed code updates that Agent; version labels are optional and reusable. The platform records each deployment's executable, mode, resolved Resources, Tool catalog, Policy attachments, Run budget, and turn limit. An accepted Run continues using its recorded deployment.

One language, seven primitives

Agent behavior is composed from turn, ledger, commit, await, spawn, map, and reduce. Start with ledger → turn → commit; introduce waiting, delegation, or volume only when the workflow requires them. Resources provide governed world capabilities without enlarging the Agent language.

Read The seven Agent primitives for their contracts and From primitives to production for ReAct, human approval, supervisor, planner, research, and data-intensive compositions.

Choose a path

Goal	Guide
Learn the Agent language	The seven Agent primitives
Write Agent behavior	Author an Agent
Judge one state with typed questions	Evaluate state with a Model
Deploy an existing Mastra project unchanged	Mastra projects
Design waits and long-running workflows	Durable Agent patterns
Publish an Agent package	Deploy an Agent
Inspect bindings, Tools, versions, or recent Runs	Operate Agents
Invoke an Agent with durable input	Start a Run
Route authenticated traffic to an Agent	Channels

Choose an interface

Interface	Use it for
Console	Interactive deployment, inspection, and low-volume operation
SDK	Authoring native Constal behavior that executes inside an Agent
Mastra	Keep the Mastra SDK and deploy its existing registry unchanged
CLI	Deployment automation, inventory, inspection, and invocation
Platform API	Embedding Agent invocation or operation in another application

Mental model

text

Agent package → immutable deployment → Agent CRN
Agent CRN + accepted event → pinned execution snapshot → Run
Run → Resource binding → governed operation

Use the Agent detail page to follow Resource references rather than copying display identifiers between screens. The canonical CRN is the stable authority name; the short Agent id is only a namespace-local label. The SDK authors behavior; the Console and Platform API deploy, invoke, inspect, and control it.

Next steps

Deploy a package, verify its bindings and Tools, then start a Run through the Console or canonical events API.