MitDesk docs
Digital employees

Pause, hand over, retrain, fire

3 min read Odoo 20.0

This page explains the buttons on the digital employee form and what each one does to the work that is already running or waiting.

Who this is for: supervisors of digital employees.

You need: Edition: Business. See Editions.

The four states

An employee is always in one of these states:

State Meaning
Draft Hired but not started. No schedule runs.
Active Works on its schedule.
Paused Scheduled work is off. Nothing is lost.
Fired Stopped for good. History stays.

An employee form with the buttons Talk, Pause, Run now, Assign a task, Retrain, Handover and Fire

Who may press the buttons: Workforce managers, and a person who both supervises the employee and is the account it runs as. Assign a task, Retrain and Handover are for Workforce managers and administrators.

Activate

Activate starts a Draft employee. It switches the schedule on and opens the employee's chat again. A person without the manager role can only activate their own employees, up to the limit described in Hiring. A fired employee can never be activated again.

Pause and Resume

Pause stops the work in a safe way:

  • The schedule is switched off.
  • Queued jobs are held, not failed.
  • A run in progress is asked to stop at its next safe point. What it already wrote stays.
  • You cannot start a run or chat with a paused employee.

Resume switches the schedule on and releases the held jobs.

A paused employee with a request waiting for you and the Resume button

An employee can also pause itself. If three scheduled runs in a row meet the same obstacle, for example a missing API key or an unusable account, it pauses, writes the reason on its form, and tells its supervisor. Repeating the run would not help. Fix the problem and press Resume.

If a conversation stops after repeated errors, the form shows Stopped after repeated failures. Check the reason and press Resume after failures.

Run now

Run now starts one run of the mission at once. The schedule does not change. It works for an active employee that has budget left and no run in progress or waiting for a decision. It ignores the working-hours calendar and records that the run was outside the hours. A paused employee cannot Run now, because its first change would only stop and wait. Resume it first.

Assign a task

Assign a task gives an active employee one piece of work, up to 8,000 characters. The standing mission does not change. The task runs with the same account, autonomy and budget as other work. The employee must have no decision waiting.

Retrain

Retrain opens the employee's agent, so that you can review the mission and the skills. Every change of the mission is saved in the Mission history with who changed it, the old text and the new text. You can restore an earlier text. See also Teaching an employee.

Handover

Use Handover when someone else must take over the open items of an employee, for example before you fire it, or when a supervisor leaves.

  1. Press Handover.
  2. Choose the person who takes over.
  3. Write a note about what they should pick up.
  4. Check the list of open items: requests that wait for approval, and follow-ups the employee planned. For a follow-up you choose Adopt / route or Cancel. Approvals are always routed.
  5. Press Apply handover.

Each routed item becomes a to-do for that person. The person must be a MitDesk approver if approvals are handed over, and cannot be the account the employee runs as. The handover is saved on the employee. The new owner can also see the employee.

Fire

Fire ends the employee for good. Conversations and the audit history stay. MitDesk first checks these things:

  • Open approvals must be handed over.
  • Planned follow-ups must be resolved or handed over.
  • A run in progress must be finished. Pause the employee first, then fire it.

When you fire, MitDesk switches off the schedule and archives the agent, unless another employee uses it. Queued jobs that were never approved fail. Jobs that wait for a decision are held, so the person can still decide. The employee moves to the state Fired. Find it with the filter Former employees.

If it does not work

If a digital employee stops running, see Troubleshooting.