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

# Formularfelder

> Konfiguriere Formular-Eingabefelder für deine Agenten, um strukturierte Informationen von Nutzern zu sammeln, bevor eine Konversation beginnt.

<Tip>
  Formulare helfen Nutzer zu führen, indem sie spezifische Informationen im Voraus sammeln, was Agent-Antworten von Anfang an genauer und relevanter macht.
</Tip>

## Überblick

Wenn du den Input-Typ deines Agenten auf **Formular** setzt, kannst du benutzerdefinierte Eingabefelder definieren, die Nutzer ausfüllen müssen, bevor sie chatten. Dieser strukturierte Ansatz stellt sicher, dass der Agent konsistente, gut organisierte Informationen für jede Konversation erhält.

Formulare sind ideal für:

* Standardisierung, wie Nutzer Kontext an den Agenten liefern
* Sicherstellen, dass alle erforderlichen Informationen im Voraus erfasst werden
* Reduzieren von Rückfragen zur Klärung
* Erstellen einer umfrageähnlichen Erfahrung für spezifische Anwendungsfälle

## Feldtypen

Jeder Feldtyp dient einem anderen Zweck. Wähle den richtigen Typ basierend darauf, welche Informationen du sammeln musst.

### Text

Einzeilige Texteingabe für kurze Antworten.

| Eigenschaft       | Beschreibung                                 |
| ----------------- | -------------------------------------------- |
| **Am besten für** | Namen, Titel, kurze Phrasen, Identifikatoren |

**Beispiel-Anwendungsfälle:**

* Kundenname
* Projekttitel
* Produkt-SKU
* Firmenname

### Mehrzeiliger Text

Mehrzeiliger Textbereich für längere Inhalte.

| Eigenschaft       | Beschreibung                                    |
| ----------------- | ----------------------------------------------- |
| **Am besten für** | Beschreibungen, Feedback, detaillierter Kontext |

**Beispiel-Anwendungsfälle:**

* Detaillierte Problembeschreibungen
* Feedback oder Vorschläge
* Meeting-Notizen zur Zusammenfassung
* Inhalte zur Analyse oder Umformulierung

### Zahl

Numerisches Eingabefeld.

| Eigenschaft       | Beschreibung                         |
| ----------------- | ------------------------------------ |
| **Am besten für** | Mengen, Beträge, Scores, Bewertungen |

**Beispiel-Anwendungsfälle:**

* Budgetbetrag
* Anzahl der Teilnehmer
* Prioritäts-Score (1-10)
* Bestellmenge

### Checkbox

Boolean-Toggle für Ja/Nein-Entscheidungen.

| Eigenschaft       | Beschreibung                       |
| ----------------- | ---------------------------------- |
| **Am besten für** | Zustimmungen, Präferenzen, Toggles |

**Beispiel-Anwendungsfälle:**

* "Ich stimme den Bedingungen zu"
* "Detaillierte Analyse einschließen"
* "Express-Bearbeitung benötigt"
* "E-Mail-Benachrichtigung senden"

### Datei

Datei-Upload-Feld für Dokumente und Anhänge.

| Eigenschaft       | Beschreibung                       |
| ----------------- | ---------------------------------- |
| **Am besten für** | Dokumente, Bilder, Datendateien    |
| **Validierung**   | Optionale Dateityp-Einschränkungen |
| **Limit**         | Ein Dateifeld pro Formular         |

**Beispiel-Anwendungsfälle:**

* Lebenslauf zur Analyse
* Dokument zur Zusammenfassung
* Bild zur Beschreibung
* Datendatei zur Verarbeitung

<Info>
  Für unterstützte Dateitypen und Größenlimits siehe [Unterstützte Dateitypen](/de/using-langdock/troubleshooting/faq/supported-file-types).
</Info>

### Auswahl

Dropdown-Menü mit vordefinierten Optionen.

| Eigenschaft       | Beschreibung                               |
| ----------------- | ------------------------------------------ |
| **Am besten für** | Kategorien, Auswahl aus einer festen Liste |
| **Validierung**   | Nutzer muss eine Option auswählen          |

**Beispiel-Anwendungsfälle:**

* Abteilungsauswahl
* Prioritätsstufe (Niedrig, Mittel, Hoch)
* Sprachpräferenz
* Produktkategorie

### Datum

Datumsauswahl für die Auswahl spezifischer Daten.

| Eigenschaft       | Beschreibung                                     |
| ----------------- | ------------------------------------------------ |
| **Am besten für** | Deadlines, Veranstaltungstermine, Zeitreferenzen |
| **Validierung**   | Standard-Datumsformat                            |

**Beispiel-Anwendungsfälle:**

* Projekt-Deadline
* Veranstaltungsdatum
* Berichtszeitraum
* Meeting-Datum

### E-Mail

E-Mail-Adresse-Eingabe mit integrierter Formatvalidierung.

| Eigenschaft       | Beschreibung                                                    |
| ----------------- | --------------------------------------------------------------- |
| **Am besten für** | Kontakt-E-Mails, Nutzeridentifikation, Benachrichtigungsrouting |
| **Validierung**   | Muss ein gültiges E-Mail-Format sein                            |

**Beispiel-Anwendungsfälle:**

* Kontakt-E-Mail des Kunden
* Benachrichtigungsempfänger
* Konto-E-Mail zur Suche
* Berichts-Zustelladresse

## Feldeigenschaften

Jedes Feld teilt gemeinsame Eigenschaften, die sein Verhalten und Erscheinungsbild steuern.

### Gemeinsame Eigenschaften

| Eigenschaft      | Beschreibung                               | Erforderlich |
| ---------------- | ------------------------------------------ | ------------ |
| **Label**        | Anzeigename für Nutzer                     | Ja           |
| **Beschreibung** | Hilfetext, der erklärt, was einzugeben ist | Nein         |
| **Erforderlich** | Ob das Feld ausgefüllt werden muss         | Nein         |

### Limits

| Eigenschaft                     | Limit       |
| ------------------------------- | ----------- |
| Maximale Felder pro Agent       | 25          |
| Feld-Label                      | 255 Zeichen |
| Feldbeschreibung                | 512 Zeichen |
| Optionstext (für Auswahlfelder) | 255 Zeichen |
| Dateitypen-String               | 255 Zeichen |

### Typspezifische Eigenschaften

**Datei:**

| Eigenschaft    | Beschreibung                                                            |
| -------------- | ----------------------------------------------------------------------- |
| **Dateitypen** | Kommagetrennte Liste erlaubter Erweiterungen (z.B. `.pdf, .docx, .txt`) |

**Auswahl:**

| Eigenschaft  | Beschreibung                                      |
| ------------ | ------------------------------------------------- |
| **Optionen** | Liste verfügbarer Auswahlmöglichkeiten für Nutzer |

**E-Mail:**

| Eigenschaft              | Beschreibung                                                                  |
| ------------------------ | ----------------------------------------------------------------------------- |
| **Domain-Einschränkung** | Akzeptierte Adressen auf bestimmte Domains einschränken (z.B. `langdock.com`) |

## Einen Formular-Input-Agenten erstellen

Folge diesen Schritten, um einen Agenten mit Formular-Inputs zu erstellen. Alternativ beschreibst du das Formular im [Agent Builder Chat](/de/using-langdock/agents/agent-builder) und er generiert die Felder für dich.

### Schritt 1: Neuen Agenten erstellen

1. Navigiere zu **Agenten** in der Seitenleiste
2. Klicke auf **Agent erstellen**
3. Gib deinem Agenten einen Namen und eine Beschreibung

### Schritt 2: Input-Typ auf Formular setzen

1. Finde in der Agenten-Konfiguration **Input-Typ**
2. Wähle **Formular** anstelle der Standard-Option Prompt

### Schritt 3: Formularfelder hinzufügen

1. Klicke auf **Feld hinzufügen**, um ein neues Eingabefeld zu erstellen

2. Wähle den Feldtyp aus dem Dropdown

3. Konfiguriere die Feldeigenschaften:
   * Gib ein klares, beschreibendes **Label** ein
   * Füge hilfreichen **Beschreibungs**-Text hinzu, wenn nötig
   * Aktiviere **Erforderlich**, wenn das Feld ausgefüllt werden muss
   * Setze typspezifische Optionen (Dateitypen für Dateifelder, Optionen für Auswahlfelder)

4. Wiederhole für jedes benötigte Feld

### Schritt 4: Felder ordnen

Ziehe Felder per Drag & Drop, um sie in einer logischen Reihenfolge anzuordnen. Platziere die wichtigsten oder kontextuell ersten Felder oben.

### Schritt 5: Anweisungen schreiben

Verweise in den **Anweisungen** deines Agenten auf die Formularfelder, um dem Agenten zu sagen, wie er die gesammelten Informationen verwenden soll:

```
Du bist ein Kundensupport-Spezialist. Nutze die folgenden Informationen, die der Nutzer bereitgestellt hat:

- Kundenname: Nutze dies, um deine Antworten zu personalisieren
- Problem-Kategorie: Konzentriere deine Fehlerbehebung auf diesen spezifischen Bereich
- Problembeschreibung: Analysiere dies, um das Kernproblem zu verstehen
- Prioritätsstufe: Passe die Dringlichkeit deiner Antwort entsprechend an

Sprich den Kunden immer mit Namen an und biete Lösungen an, die für seine ausgewählte Kategorie relevant sind.
```

### Schritt 6: Formular testen

1. Klicke auf **Mit Agent chatten**, um das Formular in der Vorschau zu sehen
2. Fülle das Formular aus, wie ein Nutzer es tun würde
3. Überprüfe, ob der Agent die Informationen korrekt erhält und verwendet
4. Passe Feld-Labels oder Anweisungen bei Bedarf an

## Beispielkonfigurationen

### Kundensupport-Aufnahme

```
Felder:
1. Name (Text, erforderlich)
   - Label: "Dein Name"

2. E-Mail (Text, erforderlich)
   - Label: "E-Mail-Adresse"

3. Kategorie (Auswahl, erforderlich)
   - Label: "Problem-Kategorie"
   - Optionen: Abrechnung, Technisch, Konto, Sonstiges

4. Beschreibung (Mehrzeiliger Text, erforderlich)
   - Label: "Beschreibe dein Problem"
   - Beschreibung: "Bitte gib so viele Details wie möglich an"

5. Dringlichkeit (Auswahl)
   - Label: "Wie dringend ist das?"
   - Optionen: Niedrig, Mittel, Hoch, Kritisch
```

### Dokumentenanalyse

```
Felder:
1. Dokument (Datei, erforderlich)
   - Label: "Dokument hochladen"
   - Dateitypen: .pdf, .docx, .txt

2. Analysetyp (Auswahl, erforderlich)
   - Label: "Welche Art von Analyse?"
   - Optionen: Zusammenfassung, Kernpunkte, Sentiment, Übersetzung

3. Zusätzlicher Kontext (Mehrzeiliger Text)
   - Label: "Spezifische Schwerpunkte?"
   - Beschreibung: "Optional: Sag uns, auf welche Aspekte wir uns konzentrieren sollen"
```

## Best Practices

<AccordionGroup>
  <Accordion title="Formulare fokussiert halten">
    Frage nur nach Informationen, die der Agent tatsächlich braucht. Jedes zusätzliche Feld erhöht die Reibung und die Chance, dass Nutzer das Formular abbrechen.
  </Accordion>

  <Accordion title="Klare Labels verwenden">
    Labels sollten klar anzeigen, welche Informationen erwartet werden. Vermeide Fachjargon oder interne Begriffe, die Nutzer möglicherweise nicht verstehen.
  </Accordion>

  <Accordion title="Hilfreiche Beschreibungen hinzufügen">
    Nutze das Beschreibungsfeld, um Beispiele zu geben oder Erwartungen zu klären. Das reduziert Fehler und verbessert die Qualität der Eingaben.
  </Accordion>

  <Accordion title="Erforderliche Felder mit Bedacht nutzen">
    Markiere Felder nur als erforderlich, wenn absolut notwendig. Zu viele erforderliche Felder frustrieren Nutzer; zu wenige können zu unvollständigen Informationen führen.
  </Accordion>

  <Accordion title="Felder logisch ordnen">
    Ordne Felder in einem natürlichen Fluss an. Beginne mit identifizierenden Informationen, dann zu Spezifika, und ende mit optionalen Feldern.
  </Accordion>

  <Accordion title="Felder in Anweisungen referenzieren">
    Erkläre dem Agenten explizit in deinen Anweisungen, wie er jedes Formularfeld verwenden soll. Das stellt sicher, dass die gesammelten Informationen tatsächlich effektiv genutzt werden.
  </Accordion>
</AccordionGroup>

## Vergleich: Formular vs. Prompt-Input

| Aspekt                   | Formular-Input              | Prompt-Input              |
| ------------------------ | --------------------------- | ------------------------- |
| **User Experience**      | Strukturiert, geführt       | Offen, flexibel           |
| **Informationsqualität** | Konsistentes Format         | Variiert je nach Nutzer   |
| **Setup-Aufwand**        | Mehr Konfiguration          | Minimales Setup           |
| **Am besten für**        | Spezifische Anwendungsfälle | Allgemeine Konversationen |
| **Lernkurve**            | Niedriger für Nutzer        | Kann Anleitung brauchen   |

<Info>
  Wähle Formular-Input, wenn du spezifische Informationen in einem konsistenten Format brauchst. Wähle Prompt-Input, wenn Nutzer Flexibilität brauchen, wie sie mit dem Agenten kommunizieren. Fehlen Details, kann der Agent während der Unterhaltung Rückfragen stellen.
</Info>

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Agenten-Konfiguration" icon="gear" href="/de/using-langdock/agents/configuration">
    Lerne alle Agenten-Konfigurationsoptionen kennen
  </Card>

  <Card title="Agenten-Templates" icon="copy" href="/de/using-langdock/agents/templates">
    Durchstöbere vorgefertigte Agenten-Konfigurationen
  </Card>

  <Card title="Agenten-Erstellungsguide" icon="book" href="/de/using-langdock/guides/agents/agent-creation">
    Detaillierter Guide zum Erstellen effektiver Agenten
  </Card>

  <Card title="Prompting-Guide" icon="lightbulb" href="/de/using-langdock/guides/prompt-engineering/basics/prompt-elements">
    Schreibe bessere Agenten-Anweisungen
  </Card>
</CardGroup>

## FAQ

<AccordionGroup>
  <Accordion title="Wann sollte ich Formularfelder in einem Agenten nutzen?">
    Nutze Formularfelder, wenn ein Agent strukturierte Eingaben braucht, bevor die Unterhaltung beginnt. Sie eignen sich für Intake-Workflows, standardisierte Anfragen und Fälle, in denen Pflichtangaben nicht in einem Freitext-Prompt untergehen sollen.
  </Accordion>

  <Accordion title="Was sollte ich prüfen, wenn Formularwerte nicht richtig verwendet werden?">
    Prüfe Feldnamen, Pflichtfelder, Eingabetypen und ob die Agenten-Anweisungen explizit auf die Formularwerte verweisen. Teste mit repräsentativen Eingaben und passe die Anweisungen an, wenn der Agent ein Feld ignoriert oder falsch interpretiert.
  </Accordion>
</AccordionGroup>