Skip to content
Docs

Tasks

Longer jobs your agents run in the background: research, lists, reports. Follow them, answer their questions, get the results.

A task is a job too long for a chat reply: "Find 200 dental clinics in Vilnius with their websites", "Summarise last month's support tickets by topic". An agent plans it, runs it step by step in the background and hands you the result.

Start a task

Ask an agent in chat to do something long and choose Run in background, or create one in Tasks. You see the plan before it starts; confirm it and the task joins the queue.

Each task runs in a project and environment, within a Credits budget you can set.

Statuses

StatusMeaning
DraftThe plan isn't confirmed yet.
QueuedWaiting for its turn.
RunningWorking through the steps.
Waiting for youIt needs an answer, a choice, or more budget.
Waiting for approvalAn action is held for a person; see Approvals.
PausedYou paused it.
CompletedDone, and the result passed its checks.
Partially completedDone with gaps: the target wasn't reached, fields are missing, or you finished early.
FailedStopped by an error. Results so far are kept.
CancelledYou cancelled it. Results so far are kept.

Failed, partially completed and cancelled tasks can be retried.

Results

Results come as a summary, a list of items and files you can download. Before a task is called complete, ORYVOX checks the result: the target count, required fields, duplicates, and that files open.

Limits

Whatever your plan, a task runs at most 24 hours and handles at most 5,000 items. You're notified when a task finishes, fails or needs you.

Was this page helpful?