---
app: agent
audience:
  - owner
since: 0.1.0
ui_only: false
agent_actions:
  - tool: app_agent_update
    permission: confirm
    example: move Maya to Sales as a Quotation Officer
  - tool: app_ui_open
    permission: auto
    example: open Maya's settings
agent_examples:
  - rename Tono to Budi
  - remove the agent Nina
llm_weight: normal
title: Move or remove an agent
description: Rename an agent, change its role, move it to another room, or
  remove it for good.
editUrl: true
head: []
template: doc
sidebar:
  order: 4
  hidden: false
  attrs: {}
pagefind: true
draft: false
---

import { Steps, Aside } from "@astrojs/starlight/components";
import { AgentAsk, UiOnly, Shot } from "@components";

**Who this is for:** an owner reorganising the office.

## Change name, role or room

<Steps>

1. Click the agent, then **Settings** in the panel header. The agent dialog opens on **General**. <Shot src="agent/office/agent-settings-general.png" alt="The agent dialog, General tab" />

2. Change the **Name**, the **Role** or the **Room** and press **Save**. Moving to another room offers that room's roles.

</Steps>

Changing the role or the room **rewrites the agent's brief**: its tools, skills and instructions follow the new role from the next conversation. Its memory stays.

## Remove an agent

<UiOnly>
Removing is permanent and done only from the desktop: the agent dialog → **General** → **Remove agent**. Its profile, memory, channel links and conversations are deleted; a linked WhatsApp number is unlinked first.
</UiOnly>

<Aside type="tip">
  Prefer putting an agent to sleep or switching its automations off when you only want it quiet for a while.
</Aside>

## Ask your agent

<AgentAsk />

## Limits & safety

- An agent cannot remove another agent, or itself.
- Rename carefully: colleagues address each other by name in the office (tasks, inbox, meetings).

## Troubleshooting

- **"move the agents out before changing the room type"** — you are changing the room, not the agent; move the agents first.
- **The panel still shows the old room** — it follows the agent; press the reload arrow in the panel header.

## Related

[Add an agent](/agent/office/add-an-agent/) · [Choosing a role](/agent/roles/choosing-a-role/)