> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# Workflows

## Übersicht

Agent-Workflows bieten eine leistungsstarke visuelle Oberfläche, um komplexe Gesprächsabläufe in ElevenAgents zu entwerfen. Statt auf lineare Gesprächsverläufe angewiesen zu sein, ermöglichen Workflows anspruchsvolle, verzweigte Gesprächsgraphen, die sich dynamisch an die Bedürfnisse der Nutzer anpassen.

![Workflow-Übersicht](/docs/_fern-files/_img/0b5b2cf9754c67ef469c08af5d13786f70ca8e0018d10e92595861abb4ed32cb.webp)

## Workflows erstellen

Das Dashboard ist aufgrund des visuellen Graph-Editors die empfohlene Methode, um Workflows zu entwerfen. Workflows werden im übergeordneten Feld `workflow` des Agenten gespeichert. Sie können das JSON daher auch über die CLI abrufen, bearbeiten und hochladen oder über das SDK aktualisieren – nützlich für Versionskontrolle und CI/CD.

> **Tip**
>
> Um Workflows in Python oder JavaScript zu erstellen oder zu bearbeiten, ohne das JSON für Knoten und Kanten manuell zu schreiben,
> verwenden Sie den [`Workflow`-Builder](/docs/de/eleven-agents/customization/agent-workflows-as-code).

#### Über das Dashboard erstellen

Öffnen Sie Ihren Agenten im Dashboard, wechseln Sie zum Tab **Workflow** und verwenden Sie den visuellen Editor, um Knoten hinzuzufügen, das Verhalten von Subagenten zu konfigurieren und Kanten zu verbinden. Speichern Sie Ihre Änderungen.

#### Über die CLI aktualisieren

#### Agentenkonfiguration abrufen

```bash
elevenlabs agents pull --agent "<agent-name>"
```

#### \`agent_configs/\<agent-name>.json\` bearbeiten

Der Workflow-Graph befindet sich unter dem übergeordneten Schlüssel `workflow`. `nodes` und `edges` sind Objekte mit IDs als Schlüssel. Unten sehen Sie einen minimalen Workflow mit drei Knoten, der den Startknoten zu einem Support-Subagenten und dann zu einem Endknoten leitet:

```json
{
  "workflow": {
    "nodes": {
      "start_node": {
        "type": "start",
        "edge_order": ["start_to_support"]
      },
      "support_agent": {
        "type": "override_agent",
        "label": "Support agent",
        "additional_prompt": "Help the user with their support request, then transition to the end node when resolved.",
        "edge_order": ["support_to_end"]
      },
      "end_node": {
        "type": "end"
      }
    },
    "edges": {
      "start_to_support": {
        "source": "start_node",
        "target": "support_agent",
        "forward_condition": { "type": "unconditional" }
      },
      "support_to_end": {
        "source": "support_agent",
        "target": "end_node",
        "forward_condition": {
          "type": "llm",
          "condition": "The support request has been resolved."
        }
      }
    }
  }
}
```

Die meisten Teams entwerfen Workflows zuerst im Dashboard und übertragen das resultierende JSON dann in die Versionskontrolle.

#### Änderungen hochladen

```bash
elevenlabs agents push --agent "<agent-name>"
```

#### Über die API aktualisieren

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.conversational_ai.agents.update(
    agent_id="agent_7101k5zvyjhmfg983brhmhkd98n6",
    workflow={
        "nodes": {
            "start_node": {
                "type": "start",
                "edge_order": ["start_to_support"],
            },
            "support_agent": {
                "type": "override_agent",
                "label": "Support agent",
                "additional_prompt": "Help the user with their support request, then transition to the end node when resolved.",
                "edge_order": ["support_to_end"],
            },
            "end_node": {"type": "end"},
        },
        "edges": {
            "start_to_support": {
                "source": "start_node",
                "target": "support_agent",
                "forward_condition": {"type": "unconditional"},
            },
            "support_to_end": {
                "source": "support_agent",
                "target": "end_node",
                "forward_condition": {
                    "type": "llm",
                    "condition": "The support request has been resolved.",
                },
            },
        },
    },
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.conversationalAi.agents.update("agent_7101k5zvyjhmfg983brhmhkd98n6", {
  workflow: {
    nodes: {
      start_node: {
        type: "start",
        edgeOrder: ["start_to_support"],
      },
      support_agent: {
        type: "override_agent",
        label: "Support agent",
        additionalPrompt:
          "Help the user with their support request, then transition to the end node when resolved.",
        edgeOrder: ["support_to_end"],
      },
      end_node: { type: "end" },
    },
    edges: {
      start_to_support: {
        source: "start_node",
        target: "support_agent",
        forwardCondition: { type: "unconditional" },
      },
      support_to_end: {
        source: "support_agent",
        target: "end_node",
        forwardCondition: {
          type: "llm",
          condition: "The support request has been resolved.",
        },
      },
    },
  },
});
```

## Knotentypen

Workflows bestehen aus verschiedenen Knotentypen, die jeweils einen bestimmten Zweck in Ihrem Gesprächsablauf erfüllen.

![Knotentypen](/docs/_fern-files/_img/b169065e0f229623a4cd57861802fa30ecd463a142599f5fd60f6fc1b8a6223e.webp)

### Subagentenknoten

Subagentenknoten ermöglichen es Ihnen, das Agentenverhalten an bestimmten Punkten Ihres Workflows anzupassen. Diese Änderungen werden zusätzlich zur Basiskonfiguration des Agenten angewendet oder können die Konfiguration des aktuellen Agenten vollständig überschreiben. So erhalten Sie präzise Kontrolle über jede Gesprächsphase.
Jede Agentenkonfiguration, verfügbare Tools und angehängte Wissensdatenbankelemente können aktualisiert oder überschrieben werden.

#### Allgemein

![Zusätzliche Agentenkonfiguration für Subagenten](/docs/_fern-files/_img/8ca72df8768a03adc0064281c906ab0f5710153249d17f7e7d51f465da7e9e94.webp)

Passen Sie zentrale Agenteneinstellungen für diesen Knoten an:

* **System-Prompt**: Systemanweisungen ergänzen oder überschreiben, um das Agentenverhalten zu steuern
* **LLM-Auswahl**: Ein anderes Sprachmodell wählen, z. B. von Gemini 2.0 Flash zu einem leistungsstärkeren Modell für komplexe Schlussfolgerungsaufgaben wechseln
* **Stimmkonfiguration**: Stimmeinstellungen wie Geschwindigkeit oder Tonfall ändern oder zu einer anderen Stimme wechseln

**Anwendungsfälle:**

* Ein leistungsstärkeres LLM für Knoten mit komplexen Entscheidungen verwenden
* Strengere Gesprächsrichtlinien beim Erfassen sensibler Informationen anwenden
* Stimmeigenschaften für verschiedene Gesprächsphasen ändern
* Die Persönlichkeit des Agenten für bestimmte Interaktionsarten anpassen

#### Wissensdatenbank

![Zusätzliche Wissensdatenbank für Subagenten](/docs/_fern-files/_img/168a56fc316596983275999c53bbbe391c4c30a05abedc17cb6a4566eff7773f.webp)

Fügen Sie knotenspezifisches Wissen hinzu, ohne die globale Wissensdatenbank zu beeinflussen:

* **Globale Wissensdatenbank einbeziehen**: Festlegen, ob die Hauptwissensdatenbank des Agenten einbezogen wird
* **Zusätzliche Dokumente**: Dokumente speziell für diese Gesprächsphase hinzufügen
* **Dynamisches Wissen**: Kontextinformationen basierend auf dem Workflow-Status einfügen

**Anwendungsfälle:**

* Produktspezifische Dokumentation während Verkaufsgesprächen hinzufügen
* Compliance-Richtlinien bei der Authentifizierung einbeziehen
* Anleitungen zur Fehlerbehebung für Support-Abläufe bereitstellen
* Preisinformationen erst nach der Qualifizierung hinzufügen

#### Tools

![Zusätzliche Tools für Subagenten](/docs/_fern-files/_img/9af53c3227661fd88bec57cb21197eb289760d33a874b56152d507373e51bac1.webp)

Verwalten Sie, welche Tools dem Agenten an diesem Knoten zur Verfügung stehen:

* **Globale Tools einbeziehen**: Festlegen, ob Tools aus der Hauptkonfiguration des Agenten einbezogen werden
* **Zusätzliche Tools**: Tools speziell für diesen Workflow-Knoten hinzufügen, z. B. Webhook-Tools wie `book_meeting`
* **Tool-Typ**: Festlegen, ob Tools Webhooks, API-Aufrufe oder andere Integrationen sind

**Anwendungsfälle:**

* Authentifizierungstools erst nach der ersten Qualifizierung hinzufügen
* Tools zur Zahlungsabwicklung an Checkout-Knoten aktivieren
* CRM-Zugriff nach der Nutzerverifizierung bereitstellen
* Planungstools für Phasen der Terminbuchung hinzufügen
* Webhook-Tools für bestimmte Aktionen wie Terminbuchungen einbeziehen

### Say-Knoten

Ein Say-Knoten lässt den Agenten an einer bestimmten Stelle im Workflow eine Nachricht sprechen und setzt den Ablauf dann entlang seiner ausgehenden Kanten fort. Verwenden Sie ihn, wenn die Formulierung einer Nachricht wichtig ist und nicht einem Subagenten überlassen werden soll, etwa bei einer Begrüßung, einem rechtlichen Hinweis oder einer dem Nutzer vorgelesenen Bestätigung.

Jeder Say-Knoten sendet seine Nachricht in einem von zwei Modi:

* **Wörtlich**: Der Agent spricht genau den Text, den Sie eingeben, mit einer optionalen Übersetzung für jede konfigurierte Sprache.
* **Prompt**: Das LLM generiert die Nachricht aus einer von Ihnen verfassten Beschreibung.

### Tool-Dispatch-Knoten

Tool-Knoten führen während des Gesprächsablaufs einen bestimmten Tool-Aufruf aus. Anders als Tools innerhalb von Subagenten sind Tool-Knoten dedizierte Ausführungspunkte, die garantieren, dass das Tool aufgerufen wird.

![Ergebniskanten des Tool-Knotens](/docs/_fern-files/_img/6b60603e56dfb25e89cdfe4223826f635af874e034af8936d74d3b428611e17b.webp)

**Spezielle Kantenkonfiguration:**
Tool-Knoten haben einen einzigartigen Kantentyp, mit dem Sie basierend auf dem Tool-Ausführungsergebnis zu einem neuen Knoten leiten können. Sie können Folgendes definieren:

* **Erfolgspfad**: Wohin geleitet wird, wenn das Tool erfolgreich ausgeführt wird
* **Fehlerpfad**: Wohin geleitet wird, wenn das Tool fehlschlägt oder einen Fehler zurückgibt

Künftig werden weitere Verzweigungsbedingungen bereitgestellt.

### Statusaktualisierungsknoten

Ein Statusaktualisierungsknoten weist bei jedem Durchlauf des Workflows eine oder mehrere [dynamische Variablen](/docs/de/eleven-agents/customization/personalization/dynamic-variables) zu. Dabei verwendet er dieselben Ausdrücke wie das Tool zur Statusaktualisierung. Anders als das Tool, das ausgeführt wird, wenn das LLM entscheidet, es aufzurufen, wendet der Knoten seine Aktualisierungen an dieser Stelle im Graphen immer an und setzt den Ablauf dann entlang seiner ausgehenden Kanten fort.

Erfahren Sie [hier](/docs/de/eleven-agents/customization/tools/system-tools/update-state) mehr.

### Agentenübergabeknoten

Agentenübergabeknoten ermöglichen die Übergabe eines Gesprächs zwischen verschiedenen Gesprächsagenten. Erfahren Sie [hier](/docs/de/eleven-agents/customization/tools/system-tools/agent-transfer) mehr.

### An-Nummer-weiterleiten-Knoten

An-Nummer-weiterleiten-Knoten übergeben ein Gespräch mit einem KI-Agenten über Telefonsysteme an einen menschlichen Agenten. Erfahren Sie [hier](/docs/de/eleven-agents/customization/tools/system-tools/transfer-to-number) mehr.

### Endknoten

Knoten zum Beenden von Anrufen beenden den Gesprächsablauf kontrolliert. Erfahren Sie [hier](/docs/de/eleven-agents/customization/tools/system-tools/transfer-to-number#:~:text=System%20tools-,End%20call,-Language%20detection) mehr.

## Kanten und Ablaufsteuerung

Kanten definieren, wie Gespräche zwischen Knoten in Ihrem Workflow verlaufen. Sie unterstützen anspruchsvolle Routing-Logik für dynamische, kontextbezogene Gesprächspfade.

![Workflow-Kanten](/docs/_fern-files/_img/02d664c9211bb8cf5452b80ab865f26b8d0b723a6acff75141ea1e9c43f7dbab.webp)

#### Vorwärtskanten

Vorwärtskanten verschieben das Gespräch zu nachfolgenden Knoten im Workflow. Sie stellen den primären Ablauf Ihres Gesprächs dar.

![Konfiguration der Vorwärtskante](/docs/_fern-files/_img/2400c66bf6f60b0d4262ecd828dea93847197f7cc00d9c8964e6486419bc90be.webp)

#### Rückwärtskanten

Rückwärtskanten ermöglichen es Gesprächen, zu vorherigen Knoten zurückzukehren. Das erlaubt iterative Interaktionen und Wiederholungslogik.

![Konfiguration der Rückwärtskante](/docs/_fern-files/_img/e211da75e56c826fd763ae4d8149604a866d3ec63271c572e177d52bb9a80e14.webp)

**Anwendungsfälle:**

* Fehlgeschlagene Authentifizierungsversuche wiederholen
* Zurückkehren, um weitere Informationen zu erfassen
* Erneute Qualifizierung nach Änderungen der Nutzeranforderungen
* Iterative Fehlerbehebungsprozesse

#### LLM-Bedingung

Verwenden Sie LLM-Bedingungen, um dynamische Gesprächsabläufe auf Basis der Auswertung natürlicher Sprache zu erstellen. Das LLM wertet Bedingungen in Echtzeit aus, um den passenden Pfad zu bestimmen.

![LLM-Bedingung für Agentenübergabe](/docs/_fern-files/_img/507885879d781f291ab35b7dda84e760767a5544ffb6bf7b455e7a1cc19b78b7.webp)

**Konfigurationsoptionen:**

* **Label**: Lesbare Beschreibung der Kantenbedingung (wird nicht vom LLM verarbeitet)
* **LLM-Bedingung**: Vom LLM ausgewertete Bedingung in natürlicher Sprache

#### Ausdruck

Verwenden Sie Ausdrücke, um bedingte Logik auf Grundlage von Variablen und strukturierten Daten zu erstellen.

![Ausdruck für Agentenübergabe](/docs/_fern-files/_img/712fc40d707906a7c6ccb4b0a76f0fd3857278176606d441bfb5245f5f6e0ffe.webp)

**Konfigurationsoptionen:**

* **Label**: Lesbare Beschreibung der Kantenbedingung (wird nicht vom LLM verarbeitet)
* **Ausdruck**: Deterministische Auswertungskriterien auf Basis der Datenstruktur

#### Keine

Bedingungslose Übergänge verschieben das Gespräch ohne Bedingungen automatisch zum nächsten Knoten.

![Bedingungslose Agentenübergabe](/docs/_fern-files/_img/73b70ce7c783277e64ba533f6d69c84e2ed3120f1fd03dbdebcd4d4f5358eb5b.webp)

**Anwendungsfälle:**

* Aufeinanderfolgende Schritte, die immer nacheinander ausgeführt werden
* Automatischer Fortgang nach Abschluss einer Aktion
* Standard-Ausweichpfade

## Analysen

![Tab für Workflow-Analysen mit Eintritten, Dauer, Beendigungen und Kantenverläufen pro Knoten, über dem Workflow-Graphen dargestellt](/docs/_fern-files/_img/a758029a005f0327c1e6319708577efd617399c72cec63d5c342d3af2f0db2a3.webp)

Sobald ein Workflow live ist, legt der Tab **Workflow** im [Analyse-Dashboard](/docs/de/eleven-agents/dashboard#workflow-analytics) Nutzungsdaten über den Graphen: Eintritte pro Knoten, durchschnittliche Verweildauer und Beendigungen sowie die Verteilung eingehender und ausgehender Kanten für jeden Knoten. Im Knoteninspektor können Sie über den Filter **Knoten betreten** auch direkt zu den entsprechenden Gesprächen im Verlauf springen.