---
app: agent
audience:
  - owner
since: 0.1.0
ui_only: false
agent_actions:
  - tool: app_roles_list
    permission: auto
    example: which roles fit a warehouse admin?
  - tool: app_agent_create
    permission: confirm
    example: hire a marketing agent named Maya
  - tool: app_agent_reprovision
    permission: auto
    example: Maya says Needs attention, fix her
agent_examples:
  - create an agent for Sales called Dina
  - how many agents can I still add?
llm_weight: normal
title: Add an agent
description: Hire an agent into a room — name, role — and what happens during
  the minute it takes to set up.
editUrl: true
head: []
template: doc
sidebar:
  order: 2
  hidden: false
  attrs: {}
pagefind: true
draft: false
---

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

**Who this is for:** an owner adding one agent by hand (the [wizard](/agent/start/first-office-wizard/) adds a whole team).

## Steps

<Steps>

1. Click an empty desk in a room, or the **+** on the room's name plate. The **Add an agent** dialog opens. <Shot src="agent/office/agent-01-dialog.png" alt="The Add an agent dialog" />

2. Type a **Name** or press the ✦ button beside it for a suggestion. Names are first names: they become the agent's profile and appear in chats, so keep them short.

3. Pick the **Room** (pre-filled from where you clicked) and a **Role**. The role list is the room's: every role shows a one-line summary and a badge with how many ERP tools it holds. See [Choosing a role](/agent/roles/choosing-a-role/).

4. Press **Add agent**. The agent appears at its desk as *provisioning* and turns *awake* after about a minute: its profile is created, it inherits your model and key, gets its role brief and its room's automations, and connects to Bakulai.

</Steps>

The dialog's subtitle shows the seats (**9 of 15 used on the Max plan**); when they are used up, **Add agent** is disabled until you remove an agent or upgrade.

## What a new agent knows

- Your **company brief** (Settings → Company) and its **room's brief** — who it works with, who it reports to.
- The **ERP tools of its role** — a Bookkeeper can create a draft Journal Entry, a Social Media Manager cannot.
- Its room's **automations**, switched on immediately (payroll drafts and social-media jobs stay off until you enable them).
- Nothing about previous conversations: memory is per agent and starts empty.

<Aside type="note">
  Every agent that is awake uses 300–500 MB of memory. The app warns when you exceed **Agents awake at once** (Settings → Office) but never refuses.
</Aside>

## Ask your agent

<AgentAsk />

## Limits & safety

- One agent per WhatsApp number, Telegram bot or mailbox — an agent cannot share a number with another (see [One number per room](/agent/channels/one-number-per-room/) for the workaround).
- Removing an agent deletes its profile and memory — a desktop action, never an agent's.

## Troubleshooting

- **"Needs attention"** after adding — open the agent and press **Retry setup**; it resumes from the failed step.
- **"an agent named … already exists"** — names are unique per room; pick another.
- **The agent answers "no model"** — your own desk has no provider yet (Owner's Office → **Settings → Model**), or the key was added after the agent; open the agent → Model tab.

## Related

[Rooms](/agent/office/rooms/) · [Awake and asleep](/agent/office/awake-and-sleeping/) · [Move or remove an agent](/agent/office/move-or-remove-an-agent/)