Agents
An agent is the core execution context in Hoziron. It wraps an LLM conversation with a persistent identity, a set of competencies, memory, and a lifecycle you control. Agents are the unit you deploy, monitor, and scale — every task your platform handles runs inside one.
You create agents when you need a stable, addressable AI worker: a claims processor that handles incoming documents, a compliance reviewer that checks policy updates, or a customer-facing assistant that lives behind a channel integration.
Agents don't do much on their own — they gain capabilities through competencies (what they can do) and connect to the outside world through skills and data integrations (what they can access).
What you'll find here
| Guide | Description |
|---|---|
| Creating agents | Author an agent as a package (AGENT.md + MANIFEST.toml) and install it — the only supported creation path |
| Lifecycle | The two-state machine that governs agent execution: Suspended ⇄ Running |
| Sending messages | Interact with agents through chat, one-shot invocations, the REST API, or channel bridges |
| Scheduling | Trigger agents on cron schedules or in response to external events |
Common tasks
- Author and install a new agent → Creating agents § From a template package
- Pause an agent without losing context, then bring it back → Lifecycle § Suspend is gated only one way
- Send a one-shot prompt and get a structured response → Sending messages § One-shot messages
- Run an agent every morning at 8 AM → Scheduling § Cron schedules
- Remove an agent completely → Lifecycle § There is no stop or delete verb
How agents relate to other concepts
Related
- Competencies — what gives agents the ability to act
- Workflows — orchestrating multiple agents together
- Providers — the LLMs that power agent reasoning
- Data integration — connecting agents to external systems