Track background jobs
Scout requests, import preparation, file scanning and reading, document extraction, intake, connection downloads, knowledge file reading and indexing run through the processing queue. Accepted work stays saved while it waits or runs.
Open a job
Open Configure → Background jobs, or follow View processing progress from an import. The list shows work names, status, completed and failed items and queued work. Filter by status and use Previous and Next for older jobs. The list refreshes every 15 seconds; the refresh button updates it immediately.
Select a job for its items, attempt counts, progress, errors and event history. Scout progress includes its stage, completed rounds and tools. A queued Scout request has not started its execution budget yet. Cancelling in the conversation stops further tools; a lost final worker attempt is shown as interrupted. Completed requests show their final work counts. Interrupted requests retain their last saved progress.
Understand the status
- Queued: saved and waiting to start.
- Running: a worker is processing it.
- Completed: its items finished.
- Failed: one or more items failed; inspect their reasons.
- Cancelled: stopped before completion.
Preparing a plan first queues a Scout turn. The import page shows when that turn has saved a ready plan. A completed preparation job alone does not mean an import was approved.
Open a job to see each item’s attempts, elapsed time and saved progress. Scout responses also show how many steps and actions finished. Completed results stay available after reloading the page; failed responses appear as failed processing.
Recover failed work
Retry failed only requeues failed items that have attempts left. Successful items are not repeated. Repeating the same retry request does not enqueue work twice. A paid Scout turn has one attempt; follow up in the conversation or use Try again on the import plan to request new work explicitly.
Your Scout job details remain private to your conversation. The saved import plan is visible to members allowed to review that import. Staff can inspect the cross-business Work queue under Configure → Admin, with business, status and test-business filters. Its scope filter also includes public Help answers, which run separately from any business and have one paid attempt. Question text is private and never appears in the processing queue.
Background jobs does not require Inbox. Business effects appear in record Activity and the audit log. If processing cannot recover, ask for help with the displayed reference.