Zum Hauptinhalt springen
Ein Tool ist eine Funktion, die der Telefonassistent mitten im Anruf aufrufen kann: einen Termin nachschlagen, ein Ticket anlegen, eine Bestellung prüfen. Dein Token braucht tools:read und tools:write; ein Tool zum Test auszuführen braucht zusätzlich tools:execute.

​
1. Sehen, was möglich ist

Welche Tool-Typen können wir erstellen, und welche Tools gibt es schon?
Der Assistent listet die Typen (list_tool_types) und deine bestehenden Tools (list_tools). Nur Typen, die als per API erstellbar markiert sind, lassen sich hier einrichten. Kalender- und andere Integrationstools brauchen zuerst eine im Dashboard verbundene Integration.

​
2. Das Tool beschreiben

Gib dem Assistenten die API-Dokumentation oder eine Beispielanfrage:
Erstelle ein Tool, das die nächsten freien Werkstatttermine holt. GET https://api.example.com/slots?date=YYYY-MM-DD, Header X-Api-Key. Der Agent soll es aufrufen, wenn ein Anrufer nach einem Termin fragt.
Der Assistent entwirft die Funktionsdefinition (Name, Beschreibung, Parameter, Anfrage) und erstellt sie (create_tool). Bevor du bestätigst, prüfe:
  • URL und Methode stimmen, und das Zugangsdatum ist ein Platzhalter, nicht in den Chat eingefügt.
  • Die Beschreibung sagt, wann der Agent das Tool aufrufen soll und was es zurückgibt.
  • Parameter, die der Anrufer liefern muss, sind markiert, mit einem Hinweis, wie danach zu fragen ist.
Die Anleitung Externe API-Integration erklärt, wie sich diese Funktionen im laufenden Gespräch verhalten.

​
3. Aktivieren und dem Agent sagen

Der Assistent aktiviert das Tool für deinen Agent (enable_tool) und bestätigt mit list_tools, dass is_active gesetzt ist. Lass ihn dann eine Zeile in die Anweisungen aufnehmen, wann das Tool zu nutzen ist; ein Tool, das der Prompt nie erwähnt, wird selten aufgerufen. disable_tool schaltet es wieder aus, ohne es zu löschen.

​
4. Vorsichtig testen

Führe das Termin-Tool für morgen aus und zeig mir die Rohantwort.
execute_tool ruft den echten Endpunkt auf.
Das ist kein Probelauf. Ein Test kann echte Termine anlegen, Nachrichten senden oder Daten im verbundenen System ändern.
Spätere Änderungen an einem Tool laufen über update_tool. Nur Tools vom Typ external:api lassen sich löschen (delete_tool); Integrationstools verwaltest du im Dashboard. Weiter: Überwachen und verbessern anhand echter Anrufe.