Agents
An Aleph agent is a stable identity around a versioned set of instructions and capabilities. It connects immutable bundle versions to ownership, configuration, conversations, memory, schedules, and channels.
Identity and versions
The agent keeps its name, description, placement, visibility, and lifecycle state. Publishing creates a new immutable version under that identity; it does not overwrite earlier versions.
An enabled agent runs one pinned version. This makes a turn repeatable and prevents a new upload from changing live behavior unexpectedly.
Ownership and placement
An agent is personal or belongs to an organization. A team can further narrow participation inside an organization. Placement determines who governs the agent, where configuration is resolved, and which billing account receives usage.
Lifecycle
| State | Behavior |
|---|---|
| Disabled | Stored and inspectable, but cannot chat or run schedules |
| Enabled | A version is pinned; chat, schedules, channels, and memory writes can run |
Visibility answers who may discover or access an agent; enabled state answers whether it may run. They are separate controls.