# Deploy, pause and set autonomy (/docs/agents/agent-autonomy)

You decide how much an agent does without a person: whether it only drafts (Shadow), waits for approval on every reply (Approval) or sends on its own within its rules (Autonomous). You can pause it on every channel at once, and start it again whenever you're ready.

- **Who can use it:** Owners and admins, or anyone whose role can deploy and pause agents. Changing the level on the Settings tab needs permission to edit agents, and duplicating needs permission to create them. Without these, **Pause**, **Resume**, **Deploy** and **Duplicate** are left out of the menus, and a **Resume** or **Deploy** main button is disabled. See [Roles and permissions](/docs/settings/roles).
- **Before you start:** Nothing. For what each level means, see [Autonomy levels](/docs/agents/agents#autonomy-levels).

## Pause an agent [#pause-an-agent]

Pausing stops the agent on every channel: its live flows stop picking up new conversations. It's reversible.

<Steps>
<Step>

### Choose Pause [#choose-pause]

On the agent's page, click **⋯** (**More actions**), then **Pause**. You can also pause from the **⋯** menu on its card on the [Agents page](/docs/agents/agents).

</Step>
<Step>

### Confirm [#confirm]

The dialog says what pausing means for this agent. Actions already waiting for approval stay in your queue.

| Level | What the dialog says |
| --- | --- |
| Shadow | It stops drafting in shadow until you resume. Nothing was being sent, so no customer notices. |
| Approval | Its waiting actions stay in your approval queue. Live flows stop picking up new conversations until you resume. |
| Autonomous | Its waiting actions stay in your approval queue and nothing sends on its own until you resume. Live flows stop picking up new conversations. |

Click **Pause agent**, or **Keep running** (**Keep drafting** for a shadow agent) to cancel.

![The Pause Closer Agent dialog: 13 actions stay in your approval queue and nothing sends on its own until you resume, with Keep running and Pause agent](/screenshots/agent-autonomy/01-pause-dialog.webp)

</Step>
<Step>

### Check it's paused [#check-its-paused]

A message confirms it, with **Undo** if you paused by mistake. The agent's status changes to **Paused**, **Resume** becomes the main button, and a notice explains what the pause means.

![The message Closer Agent paused, Resume it from its page or the agent list when you're ready, with Undo](/screenshots/agent-autonomy/02-paused-toast.webp)

![The paused Closer Agent: status Paused, the Resume button and the notice Closer Agent is paused with a link to the 13 actions that still need approval](/screenshots/agent-autonomy/03-paused-agent.webp)

</Step>
</Steps>

<Callout title="Pause one flow instead">
To stop a single flow and leave the rest of the agent running, use **Pause flow** on the Flows tab. See [Manage an agent's flows](/docs/agents/agent-flows).
</Callout>

## Resume an agent [#resume-an-agent]

<Steps>
<Step>

### Click Resume [#click-resume]

On the agent's page, click **Resume**. On the Agents page, click **⋯** on a paused agent's card or row, then **Resume**. There's no dialog: it resumes at once.

![The menu of the paused Social Listener card with Open, Test run, Duplicate and Resume](/screenshots/agent-autonomy/04-resume-from-list.webp)

</Step>
<Step>

### Check it's running [#check-its-running]

A message such as **Closer Agent resumed** confirms it, with **Undo**. Live flows pick up new conversations again, and flows that were paused along with the agent go live again. An agent in shadow goes back to drafting; nothing sends.

</Step>
</Steps>

## Change the autonomy level [#change-the-autonomy-level]

<Steps>
<Step>

### Open the Autonomy panel [#open-the-autonomy-panel]

On the agent's page, click the **Settings** tab. The **Autonomy** panel applies to every flow of the agent; the current level is marked **Current**.

![The Autonomy panel with Shadow, Approval (Current) and Autonomous, and the note that rules hold and hand off at every level](/screenshots/agent-autonomy/05-autonomy-panel.webp)

</Step>
<Step>

### Pick a level and save [#pick-a-level-and-save]

Choose **Shadow**, **Approval** or **Autonomous**. A bar appears at the bottom of the page: click **Save settings**, or **Discard** to go back. The bar follows you if you switch tabs, so you don't lose the change.

![The unsaved changes bar: Unsaved changes to Onboarding Agent's settings, with Discard and Save settings](/screenshots/agent-autonomy/06-save-bar.webp)

</Step>
<Step>

### Confirm a move to Autonomous [#confirm-a-move-to-autonomous]

Raising the level to **Autonomous** asks first: replies inside your limits will go out without your approval. Click **Switch to Autonomous and save**, or **Keep Approval** (or your current level) to stay where you are. Lowering the level saves straight away.

A message confirms the new level, with **Undo**: for example, "It's in Approval now. Writes every reply in seconds. Each one waits for your approval."

![The dialog Let Onboarding Agent send on its own? with Keep Approval and Switch to Autonomous and save](/screenshots/agent-autonomy/07-autonomous-confirm.webp)

</Step>
</Steps>

<Callout title="Rules apply at every level">
Guardrails still hold, hand off or block anything they catch, even when an agent is Autonomous, and an agent never raises its own level. See [Guardrails and rules](/docs/agents/agent-guardrails).
</Callout>

## Duplicate and deploy a copy [#duplicate-and-deploy-a-copy]

A copy lets you try a change, such as a different level or channel, without touching the original.

<Steps>
<Step>

### Duplicate the agent [#duplicate-the-agent]

On the agent's page, click **⋯**, then **Duplicate** (or use **Duplicate** in its menu on the Agents page). The copy is named "Closer Agent copy" (then "copy 2", and so on) with a matching handle such as `@closer-copy`. It has the same channels, knowledge, rules and limits, its flows are copied as unpublished drafts, and it's set to start in shadow. From the agent's page, you go straight to the copy. A message confirms it, with **Undo**.

</Step>
<Step>

### Adjust it before it goes live [#adjust-it-before-it-goes-live]

The copy's page shows **Draft** and a notice that nothing runs until you deploy it. Change anything you like on its tabs first. The Deploy dialog starts on the level set on its Settings tab, where the **Autonomy** panel says "Applies once it's deployed"; you can also pick another level in the dialog.

</Step>
<Step>

### Deploy it [#deploy-it]

Click **Deploy** (or press <kbd>D</kbd>). You can also choose **Deploy** from the copy's menu on the Agents page. The dialog says how many draft flows go live with it and on how many channels. Under **Deploy in**, pick:

- **Shadow** (recommended): drafts every reply privately. Nothing is sent.
- **Approval:** writes every reply in seconds. Each one waits for your approval.
- **Autonomous:** sends on its own unless a rule holds it.

Then click **Deploy in shadow**, **Go live in Approval** or **Go live in Autonomous**.

![The Deploy Closer Agent copy dialog: its 5 draft flows go live with it on 6 channels, with Shadow (Recommended), Approval and Autonomous, and Deploy in shadow](/screenshots/agent-autonomy/08-deploy-dialog.webp)

</Step>
<Step>

### Check the result [#check-the-result]

A message such as **Closer Agent copy is in shadow** confirms it and says what that means: it drafts privately and sends nothing. The page now shows its status, and **New flow** replaces **Deploy**.

![The deployed Closer Agent copy: Shadow badge, status Shadow, Auto-sent 7d Drafts only and Last deploy Just now](/screenshots/agent-autonomy/09-deployed-copy.webp)

</Step>
</Steps>

To create an agent from scratch instead, see [Create an agent](/docs/agents/create-agent). To delete a copy you don't need, see [Agent settings](/docs/agents/agent-settings#delete-an-agent).

## Troubleshooting [#troubleshooting]

<Accordions type="single">
<Accordion title="Couldn't pause (or resume, or deploy) the agent">
The change didn't go through, so the agent is back the way it was. Click **Try again** in the message. If your role changed in the meantime, the message says what your role can't do.
</Accordion>
<Accordion title="There's no Pause or Resume in the menu">
Your role can't deploy and pause agents. Ask an owner or admin. Drafts can't be paused: deploy them first.
</Accordion>
<Accordion title="Undo didn't work">
Undo makes the opposite change, so it can fail the same way. The message reads "Couldn't undo" with the action; make the change again by hand.
</Accordion>
</Accordions>

## Next steps [#next-steps]

<Cards>
<Card title="Triage the approval queue" href="/docs/inbox/approval-queue" description="Approve what an agent in Approval is waiting on." />
<Card title="Auto-approve rules and auto-send" href="/docs/inbox/auto-approve-rules" description="Let routine approvals go through on their own." />
<Card title="Guardrails and rules" href="/docs/agents/agent-guardrails" description="Decide what's held, handed off or blocked." />
</Cards>
