Agent Task
A single unit of work submitted to one Agenhood agent, with a free text or schema validated output.
An agent task is a single unit of work submitted to a specific agent in Agenhood, either through a form based submission or a streaming chat thread, that runs to completion, or cancellation, and produces an output governed by an output contract.
How it works in Agenhood
A user starts a task by sending a prompt to a chosen agent, either by filling in a plain submission form or by typing into that agent's chat thread. The agent then works through the request, calling tools, editing files in its workspace, and producing output, all inside its own sandboxed container. While the task runs, its progress is available as a task event stream, and the console's live task viewer can display that stream as it happens. A task ends when the agent finishes, hits an iteration or time limit, or is cancelled mid-flight by the user.
Output contracts
Each agent task can specify what kind of output it should produce. This can be free text, suitable for open-ended writing or explanation, or a schema validated JSON object, where the task's result is checked against a defined schema before it is considered complete. A schema validated contract is useful when a task's output feeds into another system, such as the next step of a task workflow, since the receiving step can rely on the shape of the data rather than parsing free text.
Why it matters
Treating each request as a discrete, trackable task, rather than an open-ended session, gives every run a clear start, end, and result that can be logged, replayed, scheduled, or chained. This mirrors how job or run abstractions work in general task and workflow infrastructure: a task is the smallest addressable unit of execution, and larger constructs such as workflows and cron schedules are built by composing tasks together. It also makes it straightforward to measure duration, token usage, and outcome for a single task, independent of any workflow or schedule that may have triggered it.
Related concepts
An agent task is the basic building block behind Agenhood's task workflow and cron schedule features: a workflow chains multiple tasks together across one or more agents, and a cron schedule triggers a task, or a workflow, on a recurring or one-time basis.