> ## Documentation Index
> Fetch the complete documentation index at: https://agent-docs.magicwebs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent editor

> Configure an agent's identity, routing, tone, rules, knowledge and tools, and read the exact prompt it receives.

Open an agent from **Build → Agents → Configure**. The header shows the agent's name (click it to switch agents), its status (**Active**, **Paused** or **Draft**), **Test in chat** and **Save**.

> [!NOTE]
>
> Changes take effect on the agent's next reply after you press **Save**.

## Identity

![The Identity tab for Priya, the residential sales consultant](https://mintcdn.com/magicwebs/Y5otz65o1vDClhV_/images/console/agent-editor.png?fit=max\&auto=format\&n=Y5otz65o1vDClhV_\&q=85\&s=53bb3fceda32ac878cff618e57746472)

| Field | What to write |
| - | - |
| **Gender** | Sets the agent's face and the voice of spoken replies |
| **Internal name** | Your name for it, for example "Residential sales". Customers never see it |
| **Name customers see** | A first name reads better than a job title, for example "Priya" |
| **Role** | For example "Residential Sales Consultant" |
| **Objective** | What a successful conversation achieves |
| **Job description** | The work step by step: how it opens, what it collects, how it closes |
| **Opening line** | The first message customers see |

The **Voice** card turns on a microphone and **Listen** button in the website chat, and picks the voice.

## Routing

![The Routing tab with the handover condition and the routing switch](https://mintcdn.com/magicwebs/Y5otz65o1vDClhV_/images/console/agent-editor-routing.png?fit=max\&auto=format\&n=Y5otz65o1vDClhV_\&q=85\&s=5bd9d1c6afaa48453a4675ca825d8dfb)

* **Hand over to this agent when…**: the one line the front desk reads when choosing an agent. Write a condition, not a job description.
* **Available for routing**: turn it off to take the agent out of every roster. It still answers on any channel pointed straight at it.
* **Who this agent can hand on to**: the other agents it may pass a conversation to.

For the front desk, this tab lists who it can hand over to. The front desk is never handed a conversation and always stays active.

## Tone

![The Tone tab with sound, formality, emoji, reply length and languages](https://mintcdn.com/magicwebs/Y5otz65o1vDClhV_/images/console/agent-editor-tone.png?fit=max\&auto=format\&n=Y5otz65o1vDClhV_\&q=85\&s=9952e42fa1a3d8ae668e62711ddfc155)

* **Should sound** and **Should never sound**: traits such as *warm*, *clear*, *pushy*, *robotic*.
* **Formality** (Casual, Neutral, Formal), **Emoji** (Never, Sparing, Expressive), **Reply length** (Short, Medium, Detailed).
* **Languages**, and **Mirror the customer's language**, which also handles mixes such as Hinglish.
* **Human voice**: short, unpolished replies that read as if a colleague typed them. Asked directly, the agent still says it is an AI.

## Rules

![The Rules tab with Always and Never lists](https://mintcdn.com/magicwebs/Y5otz65o1vDClhV_/images/console/agent-editor-rules.png?fit=max\&auto=format\&n=Y5otz65o1vDClhV_\&q=85\&s=54f056cb5c3489ab1941cc5ff33bde0d)

* **Always**: hard instructions, for example "Always offer a free site visit once the customer shows interest in a project."
* **Never**: hard limits, for example "Never promise a discount" or "Never guarantee loan approval."
* **Escalation policy**: when to hand over to a person.
* **Additional instructions**: appended to the agent's instructions word for word.

Universal safety rules are added for you.

## Knowledge & tools

![The Knowledge & tools tab with retrieval settings and built-in tools](https://mintcdn.com/magicwebs/Y5otz65o1vDClhV_/images/console/agent-editor-tools.png?fit=max\&auto=format\&n=Y5otz65o1vDClhV_\&q=85\&s=1b2a51c757f8886deabbba41ae783f91)

* **Knowledge retrieval**: whether the agent searches the knowledge base automatically, and how many passages it reads per lookup.
* **Built-in tools**: switch each on or off.
  * *Search knowledge base*
  * *Search catalogue*
  * *Get product requirements*
  * *Save contact detail*
  * *Escalate to human*
  * *Rich messages*: buttons, lists, media and contact cards on WhatsApp and web
  * *Transfer to another agent*
* **What this agent records**: one switch per [record book](https://agent-docs.magicwebs.ai/build/record-books.md). Turning one on gives the agent the tools to file, find and update that kind of record.
* **Integration tools**: Razorpay payment links, Magic Forms, Magic Reward and Google tools. Each is off until you turn it on here.
* **Custom tools available here**: the [custom tools](https://agent-docs.magicwebs.ai/build/custom-tools.md) this agent can call.

## Compiled prompt

![The Compiled prompt tab showing the full instructions](https://mintcdn.com/magicwebs/Y5otz65o1vDClhV_/images/console/agent-editor-prompt.png?fit=max\&auto=format\&n=Y5otz65o1vDClhV_\&q=85\&s=f335ec10c21b33bbc6ac7c3f694ed647)

This is exactly what the agent receives, built from everything you saved: identity, company profile, facts, rules and tools. Use it to check what an agent knows. Save your changes to refresh it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.