Managing Jobs

Monitor, control, and troubleshoot background jobs — run history, status, and manual execution.

Once jobs are created, manage them in Settings → Jobs.

Job List

The Jobs page shows all configured jobs with:

  • Name and assigned agent
  • Schedule (human-readable)
  • Status — Enabled or disabled
  • Last run — When it last executed and the result
  • Next run — When it's scheduled to run next

Enable / Disable

Toggle a job on or off without deleting it. Disabled jobs keep their configuration but won't execute until re-enabled.

Run Now

Click Run Now to execute a job immediately, regardless of its schedule. Useful for:

  • Testing a new job
  • Running a report on demand
  • Triggering a task outside its normal schedule

Run History

Each job tracks its execution history:

FieldDescription
Run timeWhen the run started and ended
DurationHow long the run took
StatusSuccess, failed, timed out, or skipped
SessionLink to the session where the job ran

Click any run to see the full session and conversation.

Troubleshooting

Job not running

  • Check that the job is enabled
  • Verify the cron expression is correct
  • Check the timezone setting
  • Look at the run history for errors

Job failing

  • Open the session from the run history to see what happened
  • Check that the agent has the required skills assigned
  • Verify any external services (APIs, databases) are accessible
  • Check the timeout setting — increase if the job needs more time

Overlapping runs

If a job takes longer than its interval, you may get overlapping runs. Enable skip if running to prevent this.

Deleting Jobs

Delete a job to remove it entirely. Run history is preserved for reference. This action cannot be undone.