Skip to main content
Every task has a durable task_id. To refine, expand, or fix results, continue the same task: the agent keeps the plan, the output rows, and the task-local files.

When to continue vs. start fresh

Continue when the user references previous work: “add a column”, “find more”, “narrow to US-only”, “fix the empty fields”. Start a new task only for unrelated work. When you continue, rewrite the user’s request into a clear instruction stating the current goal, not just their raw words.

Execute and stop

  • tasks.execute(task_id) pushes an existing task toward producing output from its current plan.
  • tasks.stop(task_id) stops a run and returns the task to plan.

Human in the loop

Let the agent ask a clarifying question first.

Live messages

Watch each turn as it happens.