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

# Voice Agent bauen

> Den Agent beschreiben, die Anweisungen prüfen, die Sprechweise feinjustieren.

Dein Token braucht `voice_agents:read` und `voice_agents:write`. Du rufst nie
selbst MCP-Tools auf: Du beschreibst, was du willst, der Assistent wählt das
Tool, und du prüfst, bevor es läuft. Die Tool-Namen unten helfen dir nur, sie
in deinem Client wiederzuerkennen.

## 1. Den Agent beschreiben

Sag, wer anruft, was der Agent erledigen soll, was er übergeben muss und wie er
klingen soll:

> Lege einen Voice Agent „Empfang“ für unsere Kfz-Werkstatt an. Anrufer buchen
> Servicetermine oder fragen nach Öffnungszeiten. Alles zu Rechnungen geht an
> einen Menschen. Sie-Form, freundlich und knapp.

Der Assistent prüft bestehende Agents (`list_voice_agents`) und legt den neuen
an (`deploy_voice_agent`). Trotz des Namens verbindet das keine Rufnummer; das
passiert später im Dashboard. Erwarte, dass er dir die ID des neuen Agents
nennt.

## 2. Die Anweisungen prüfen

Die Anweisungen sind der Prompt des Agents. Der Assistent entwirft sie nach dem
[Prompting Guide](https://aipro.placetel.de/docs/de/ai-prompts.md) und sollte sie dir vor dem Speichern zeigen
(`set_agent_prompt`). Prüfe:

* Identität und Ton entsprechen deiner Beschreibung.
* Jede Aufgabe sagt, welche Informationen erfasst werden.
* Übergabe- und „Niemals“-Regeln sind ausdrücklich formuliert.
* Die gesprochene Sprache stimmt: Zahlen, Daten, Uhrzeiten so, wie ein Mensch
  sie sagt.

Sag, was zu ändern ist; der Assistent passt den Entwurf an und speichert erneut.

## 3. Die Sprechweise feinjustieren

Einstellungen gibt es in drei Gruppen: `prompts` (Begrüßung und Verhalten),
`voice_config` (Stimme, Sprache, Sprechen) und `knowledge_base`. Frag in
einfachen Worten:

> Begrüße mit „Guten Tag, Autohaus Berger, wie kann ich helfen?“, sprich etwas
> langsamer und nimm eine weibliche Stimme.

Der Assistent liest zuerst das Einstellungsschema
(`get_voice_agent_concern_schema`), ändert dann **eine Einstellung pro Aufruf**
(`update_voice_agent_concern`) und meldet jedes Ergebnis. Zwei Dinge, auf die du
in seinen Antworten achten solltest:

* Bei Auswahlfeldern muss er den exakten Wert aus dem Schema senden, nicht die
  Bezeichnung, die du im Dashboard siehst.
* Manche Änderungen haben Nebenwirkungen: Ein Wechsel des Gesprächsmodus setzt
  abhängige Einstellungen zurück. Die Antwort listet sie unter `effects`; der
  Assistent sollte sie nennen und das Schema erneut lesen, bevor er weitermacht.

## 4. Abschließen

Verbinde eine [Rufnummer](https://aipro.placetel.de/docs/de/ai-numbers.md) im Dashboard und
[überwache die ersten Anrufe](https://aipro.placetel.de/docs/de/mcp/monitoring.md). Spätere Änderungen laufen genauso:
fragen, prüfen, bestätigen. Umbenennen geht über `update_voice_agent`;
`delete_voice_agent` entfernt einen Agent und sollte nur laufen, nachdem du es
ausdrücklich bestätigt hast.

Weiter: [Tools hinzufügen](https://aipro.placetel.de/docs/de/mcp/tools.md), damit der Agent nachschlagen oder
buchen kann.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.