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

# Aussprache

> Lege fest, wie dein Agent bestimmte Wörter ausspricht

export const Screenshot = ({lightSrc, darkSrc, alt, caption, maxWidth = "880px"}) => {
  return <div style={{
    margin: "1rem auto",
    maxWidth,
    width: "100%"
  }}>
      <Frame>
        <img className="block dark:hidden" src={lightSrc} alt={alt} />
        <img className="hidden dark:block" src={darkSrc} alt={alt} />
      </Frame>
      {caption ? <p style={{
    marginTop: "0.5rem",
    fontSize: "0.875rem",
    color: "inherit",
    opacity: 0.8
  }}>
          {caption}
        </p> : null}
    </div>;
};

**Zugriff:** Öffne einen Agenten und gehe zu **Allgemein** → **Sprechen**.

## Wie benutzerdefinierte Aussprachen funktionieren

<Badge>Profi</Badge>

Mit der Einstellung **Aussprache** legst du fest, wie bestimmte Wörter klingen sollen, damit dein Agent Markennamen, technische Begriffe und Akronyme immer korrekt ausspricht. Diese Regeln wirken zusammen mit deiner [Stimmauswahl](/de/build/voice-speech/select-voice) und den [Spracheinstellungen](/de/build/voice-speech/voice-settings), um den Klang deines Agenten zu formen.

<Screenshot lightSrc="/images/voice-speech__pronunciation-manager_DE-light.png" darkSrc="/images/voice-speech__pronunciation-manager_DE-dark.png" alt="Aussprache-Manager mit vorhandenen Einträgen, Hinzufügen-Formular und Import-Export-Aktionen" caption="Im Aussprache-Manager fügst du Einzelwort-Ersetzungen hinzu, prüfst vorhandene Einträge und importierst oder exportierst CSV-Dateien." />

## Aussprachen hinzufügen

### Einzelersetzung

1. Klicke auf **Eintrag hinzufügen**
2. Gib das Feld **Wort** ein
3. Gib das Feld **Aussprache** ein
4. Klicke auf **Hinzufügen**

**Beispiele:**

* **Wort:** Nike → **Aussprache:** Nai-key
* **Wort:** API → **Aussprache:** A-P-I
* **Wort:** 24/7 → **Aussprache:** twenty-four seven
* **Wort:** EST → **Aussprache:** Eastern Time

<Warning>
  Wörter müssen einzelne Wörter sein. Leerzeichen sind nicht erlaubt. Verwende vollständige Wörter wie `Nike` oder `API`, nicht Phrasen wie `customer service`.
</Warning>

### Massenimport per CSV

Wenn du viele Aussprachen auf einmal importieren willst:

1. Klicke auf **CSV importieren**
2. Lade bei Bedarf die Vorlage herunter
3. Bereite deine CSV mit zwei Spalten vor: `target`, `replacement`
4. Ziehe deine CSV-Datei per Drag-and-drop hinein oder klicke zum Auswählen
5. Prüfe die Vorschau und klicke auf **Einträge importieren**

<Note>
  Die UI zeigt die Felder als **Wort** und **Aussprache** an. In der CSV heißen die technischen Spalten weiterhin `target` und `replacement`.
</Note>

**CSV-Format:**

```csv theme={null}
target,replacement
Nike,Nai-key
EST,Eastern Time
24/7,twenty-four seven
API,A-P-I
```

**Limits:**

* Maximal 500 Aussprachen pro Agent
* Maximale CSV-Dateigröße: 5MB

***

## Tipps für phonetische Schreibweise

### Einfache phonetische Schreibweise

Schreibe Ersetzungen als einfachen, lesbaren phonetischen Text:

**Gute Beispiele:**

* Nike → Nai-key
* SQL → sequel (oder) S-Q-L
* Wi-Fi → why-figh
* iOS → eye-oh-ess

**Tipps:**

* Nutze Bindestriche, um Silben zu trennen: Nai-key, A-P-I
* Schreib es so, wie du die Aussprache jemandem erklären würdest
* Teste mit deiner Stimme, wie es klingt

### Häufige Muster

**Akronyme (jeden Buchstaben einzeln sprechen):**

* API → A-P-I
* URL → U-R-L
* HTTP → H-T-T-P
* AWS → A-W-S

**Markennamen (phonetische Schreibweise):**

* Nike → Nai-key
* Adidas → ah-dee-dahs
* Chipotle → chih-poht-lay

**Zahlen und Uhrzeiten:**

* 24/7 → twenty-four seven
* 9am → nine A-M
* EST → Eastern Time
* 5pm → five P-M

**Technische Begriffe:**

* SQL → sequel (oder) S-Q-L
* API → A-P-I
* URL → you-are-ell
* WiFi → why-figh

***

## Fortgeschritten: anbieterspezifisches Markup

Ausspracheeinträge sind einfache Text-Ersetzungen, bevor Sprache synthetisiert wird. Einfache phonetische Schreibweise funktioniert anbieterübergreifend und ist die sicherste Standardwahl.

Einige TTS-Anbieter unterstützen anbieterspezifisches Markup wie SSML-Phonem-Tags. Wenn du Markup verwendest, teste es mit genau dem Voice-Anbieter, den du für den Agenten ausgewählt hast.

**Beispiel:**

```
espresso → ess-press-oh
```

<Note>
  Rohes IPA und SSML-Markup hängen vom Anbieter ab. Verwende zuerst lesbaren phonetischen Text und gehe nur dann zu anbieterspezifischem Markup über, wenn Tests zeigen, dass es mit deiner gewählten Stimme funktioniert.
</Note>

***

## Aussprachen verwalten

### Bestehende Ersetzungen bearbeiten

1. Klicke auf einen beliebigen Eintrags-Chip in der Liste
2. Ändere Wort oder Aussprache
3. Klicke auf **Speichern**

### Ersetzungen löschen

* Klicke auf das **Papierkorb-Symbol** bei einem Eintrags-Chip, um ihn zu löschen
* Oder klicke auf **Alle Einträge löschen**, um alle Aussprachen zu entfernen (Bestätigung erforderlich)

### Aussprachen exportieren

1. Klicke auf **CSV exportieren**
2. Die CSV-Datei wird mit allen aktuellen Aussprachen heruntergeladen
3. Dateinamen-Format: `{agent_name}_pronunciations.csv`

Nutze exportierte CSV-Dateien, um deine Aussprachen zu sichern oder auf andere Agenten zu übertragen.

***

## Aussprachen testen

Nachdem du Aussprachen hinzugefügt hast:

1. Führe einen Test-Call mit deinem Agenten durch
2. Löse Antworten aus, die die Zielwörter enthalten
3. Höre zu, ob die Aussprache korrekt klingt
4. Passe die phonetische Schreibweise bei Bedarf an

**Test-Tipps:**

* Teste im Kontext, nicht isoliert
* Lass Teammitglieder mithören
* Passe Silbentrennung oder Schreibweise an, wenn es nicht richtig klingt

***

## Best Practices

<AccordionGroup>
  <Accordion title="Mit häufigen Problemen beginnen" icon="bullseye">
    Füge Aussprachen für Wörter hinzu, von denen du weißt, dass sie in echten Calls falsch ausgesprochen werden. Prüfe Call-Transkripte, um wiederkehrende Probleme zu finden.
  </Accordion>

  <Accordion title="Einfach bleiben" icon="sparkles">
    Verwende phonetische Schreibweise (Nai-key) statt komplexem IPA, außer wenn es nötig ist. Einfache phonetische Texte sind leichter zu pflegen und funktionieren in den meisten Fällen gut.
  </Accordion>

  <Accordion title="Vor dem Deployment testen" icon="vial">
    Teste Aussprachen immer mit echten Calls, bevor du live gehst. Mach einen Test-Call und löse Antworten mit den Zielwörtern aus, um zu prüfen, ob sie korrekt klingen.
  </Accordion>

  <Accordion title="Regeln dokumentieren" icon="file-arrow-down">
    Exportiere dein CSV regelmäßig als Backup. Nutze den Button **CSV exportieren**, um deine Aussprachen zu sichern und versioniert neben deiner Agentenkonfiguration aufzubewahren.
  </Accordion>

  <Accordion title="Einheitliche Schreibweise verwenden" icon="check">
    Wenn du "API" als "A-P-I" ausschreibst, verwende dieses Format konsequent in allen Aussprachen. Konsistenz verbessert die Wartbarkeit.
  </Accordion>

  <Accordion title="Nur einzelne Wörter" icon="letter-a">
    Denk daran, dass Wörter keine Leerzeichen enthalten dürfen. Nutze `Nike` oder `API`, nicht Phrasen wie `customer service`.
  </Accordion>
</AccordionGroup>

***

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Spracheinstellungen" icon="sliders" href="/de/build/voice-speech/voice-settings">
    Voice-Parameter feinjustieren
  </Card>

  <Card title="Stimme auswählen" icon="microphone" href="/de/build/voice-speech/select-voice">
    Eine andere Stimme wählen
  </Card>

  <Card title="Hintergrundgeräusche" icon="volume" href="/de/build/voice-speech/ambient-sound">
    Hintergrundgeräusche hinzufügen
  </Card>

  <Card title="Agent testen" icon="vial" href="/de/test/web-simulator">
    Aussprache im Browser testen
  </Card>
</CardGroup>