> ## 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.

# Agenten verwalten

> Agenten anlegen, konfigurieren und ihre Grundeinstellungen pflegen.

Ein **Agent** ist ein konfigurierter Voice-Agent, der an eine Rufnummer gebunden ist. Alles, was einen Anruf steuert – Verhalten, Sprache, Anbindungen – hängt am Agenten.

## Agenten-Übersicht

Die Agentenliste zeigt alle Agenten deines Mandanten mit ihrem Veröffentlichungsstatus (aktive Live-Version oder „noch keine Version"). Von hier legst du neue Agenten an oder löschst bestehende.

Öffne die Liste über **Agents** in der Seitenleiste.

<Frame caption="Die Agentenliste mit der Karte „Neuer Agent“ und bestehenden Agenten.">
  <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="Agentenliste mit der Karte Neuer Agent und bestehenden Agenten" width="2013" height="974" data-path="images/agenten/01-agents-leer.png" />
</Frame>

## Neuen Agenten anlegen

Klicke auf die Karte **Neuer Agent**. Der **Agenten-Assistent** führt in fünf Schritten durch die Grundkonfiguration. Nur der Name ist Pflicht – alle weiteren Einstellungen sind optional und lassen sich später anpassen.

<Frame caption="Schritt 1 des Agenten-Assistenten: Grundeinstellungen mit Name, Beschreibung und Rufnummer.">
  <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="Agenten-Assistent – Schritt Grundeinstellungen" width="2013" height="974" data-path="images/agenten/Agents_Grundeinstellungen.png" />
</Frame>

<Steps>
  <Step title="Grundeinstellungen">
    **Name** und **Beschreibung** des Agenten sowie die **Telefonnummer**, unter
    der er erreichbar ist. Der Name muss eindeutig sein; die Rufnummer muss bei
    unserem Provider registriert sein.
  </Step>

  <Step title="Basis-Instructions">
    Die grundlegende Anweisung an den Agenten: **Systemrolle** (wer er ist und
    wie er kommuniziert), **globale Regeln** für alle Gespräche und **kritische
    Regeln** mit höchster Priorität. Wie du diese Felder gut formulierst, zeigt
    der [Prompting-Guide](/prompting-guide).
  </Step>

  <Step title="Anrufparameter">
    Zeitliche Grenzen des Gesprächs: **maximale Wartezeit** auf eine
    Nutzereingabe und **maximale Anrufdauer**. Beide sind standardmäßig
    unbegrenzt und werden über einen Schalter aktiviert.
  </Step>

  <Step title="KI-Modell-Parameter">
    **Stimme**, **Transkriptsprache**, **Geräuschunterdrückung** und
    **Barge-in** (ob der Anrufer den Agenten unterbrechen darf).
  </Step>

  <Step title="Connectoren">
    Optionale Anbindung an deine Fachsysteme. Verfügbare Connectoren stehen
    rechts, aktivierte links. Details im Kapitel [Connectoren
    einrichten](/connectoren). Zum Abschluss speicherst du den Agenten mit
    **Erstellen**.
  </Step>
</Steps>

Nach **Erstellen** erscheint der neue Agent in der Liste – zunächst ohne Live-Version und ohne Rufnummer. Von der Karte aus öffnest du den **Entwurf** (Flow-Editor), die **Versionen** oder die **Einstellungen**.

## Versionen und Livegang

Ein Agent arbeitet mit **Versionen** seines Flows:

* Du bearbeitest den **Entwurf (Draft)**.
* Beim **Veröffentlichen** wird der Entwurf geprüft und als unveränderliche, nummerierte **Version** gespeichert.
* Du **aktivierst** eine Version als Live-Version. Neue Anrufe nutzen diese; laufende Anrufe bleiben auf ihrer Version.
* Aus einer Version kannst du jederzeit wieder einen bearbeitbaren Entwurf öffnen.

Mehr dazu im Kapitel [Gesprächs-Flows bauen](/flows-bauen#versionierung).