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

# Manage agents

> Create and configure agents and maintain their basic settings.

An **agent** is a configured voice agent that is bound to a phone number. Everything that controls a call – behavior, language, connections – hangs off the agent.

## Agent overview

The agent list shows all agents of your tenant with their publication status (active live version or "no version yet"). From here you create new agents or delete existing ones.

Open the list via **Agents** in the sidebar.

<Frame caption="The agent list with the New agent card and existing agents.">
  <img src="https://mintcdn.com/msg-hello/N3O-B12QNjCabj-J/images/agenten/01-agents-leer.png?fit=max&auto=format&n=N3O-B12QNjCabj-J&q=85&s=60b1c93c3e9eac7cde7b7858d87d1b84" alt="Agent list with the New agent card and existing agents" width="2013" height="974" data-path="images/agenten/01-agents-leer.png" />
</Frame>

## Create a new agent

Click the **New agent** card. The **agent wizard** guides you through the basic configuration in five steps. Only the name is required – all other settings are optional and can be adjusted later.

<Frame caption="Step 1 of the agent wizard: basic settings with name, description and phone number.">
  <img src="https://mintcdn.com/msg-hello/N3O-B12QNjCabj-J/images/agenten/Agents_Grundeinstellungen.png?fit=max&auto=format&n=N3O-B12QNjCabj-J&q=85&s=330118de03e94b541afaaa7ffd6af527" alt="Agent wizard – basic settings step" width="2013" height="974" data-path="images/agenten/Agents_Grundeinstellungen.png" />
</Frame>

<Steps>
  <Step title="Basic settings">
    **Name** and **description** of the agent as well as the **phone number**
    at which it is reachable. The name must be unique; the phone number must be
    registered with our provider.
  </Step>

  <Step title="Base instructions">
    The fundamental instruction to the agent: **system role** (who it is and
    how it communicates), **global rules** for all conversations and **critical
    rules** with the highest priority. How to word these fields well is shown in
    the [prompting guide](/en/prompting-guide).
  </Step>

  <Step title="Call parameters">
    Time limits of the conversation: **maximum wait time** for a user input
    and **maximum call duration**. Both are unlimited by default and are
    enabled via a toggle.
  </Step>

  <Step title="AI model parameters">
    **Voice**, **transcription language**, **noise suppression** and
    **barge-in** (whether the caller may interrupt the agent).
  </Step>

  <Step title="Connectors">
    Optional connection to your business systems. Available connectors are on
    the right, activated ones on the left. Details in the chapter [Set up
    connectors](/en/connectoren). To finish, save the agent with
    **Create**.
  </Step>
</Steps>

After **Create**, the new agent appears in the list – initially without a live version and without a phone number. From the card you open the **draft** (flow editor), the **versions** or the **settings**.

## Versions and going live

An agent works with **versions** of its flow:

* You edit the **draft**.
* On **publishing**, the draft is validated and stored as an immutable, numbered **version**.
* You **activate** a version as the live version. New calls use it; ongoing calls stay on their version.
* From a version you can reopen an editable draft at any time.

More on this in the chapter [Build conversation flows](/en/flows-bauen#versionierung).