Zum Hauptinhalt springen
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 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 im Dashboard und überwache die ersten Anrufe. 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, damit der Agent nachschlagen oder buchen kann.