Skip to main content
POST
Mid-Call-Tool erstellen
Dieser Endpunkt ermöglicht es Ihnen, ein neues Mid-Call-Tool zu erstellen, das Ihre KI-Assistenten verwenden können, um während Anrufen mit externen APIs zu interagieren.

Anfragekörper-Parameter

string
erforderlich
Tool-Name - darf nur Kleinbuchstaben und Unterstriche enthalten und muss mit einem Buchstaben beginnen (z.B. get_weather, book_appointment)
string
erforderlich
Detaillierte Erklärung, wann und wie die KI dieses Tool verwenden soll (max. 255 Zeichen)
string
erforderlich
Gültige URL des aufzurufenden API-Endpunkts
string
erforderlich
HTTP-Methode: GET, POST, PUT, PATCH oder DELETE
integer
Anfrage-Timeout in Sekunden (1-30, Standard: 10)
array
Mit der Anfrage zu sendende HTTP-Header
array
Parameter, die die KI aus der Konversation extrahiert und an den Endpunkt sendet

Antwortfelder

string
Erfolgsmeldung
object
Das erstellte Tool-Objekt

Tools an Assistenten anhängen

Nach dem Erstellen eines Tools müssen Sie es an einen Assistenten anhängen, um es während Anrufen zu verwenden. Tools werden über die Assistant-API verwaltet:
  • Assistenten erstellen - Verwenden Sie den Parameter tool_ids, um Tools beim Erstellen eines Assistenten anzuhängen
  • Assistenten aktualisieren - Verwenden Sie den Parameter tool_ids, um Tools bei einem vorhandenen Assistenten hinzuzufügen, zu entfernen oder zu ersetzen