Zum Hauptinhalt springen
POST
https://app.autocalls.ai/api/
/
user
/
tools
Mid-Call-Tool erstellen
curl --request POST \
  --url https://app.autocalls.ai/api/user/tools \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "endpoint": "<string>",
  "method": "<string>",
  "timeout": 123,
  "headers": [
    {
      "name": "<string>",
      "value": "<string>"
    }
  ],
  "schema": [
    {
      "name": "<string>",
      "type": "<string>",
      "description": "<string>"
    }
  ]
}
'
{
  "message": "Tool erfolgreich erstellt",
  "data": {
    "id": 1,
    "name": "check_order_status",
    "description": "Verwenden Sie dieses Tool, um den Status einer Kundenbestellung zu überprüfen.",
    "endpoint": "https://api.yourstore.com/orders/status",
    "method": "GET",
    "timeout": 10,
    "headers": [
      {
        "name": "Content-Type",
        "value": "application/json"
      },
      {
        "name": "Authorization",
        "value": "Bearer sk_..."
      }
    ],
    "schema": [
      {
        "name": "order_id",
        "type": "string",
        "description": "Die Bestellungs-ID des Kunden"
      },
      {
        "name": "order_number",
        "type": "number",
        "description": "Die numerische Bestellnummer"
      },
      {
        "name": "priority_order",
        "type": "boolean",
        "description": "Ob dies eine Prioritätsbestellung ist"
      }
    ],
    "created_at": "2025-10-10T12:00:00.000000Z",
    "updated_at": "2025-10-10T12:00:00.000000Z"
  }
}
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

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

​
Antwortfelder

​
message
string
Erfolgsmeldung
​
data
object
Das erstellte Tool-Objekt
{
  "message": "Tool erfolgreich erstellt",
  "data": {
    "id": 1,
    "name": "check_order_status",
    "description": "Verwenden Sie dieses Tool, um den Status einer Kundenbestellung zu überprüfen.",
    "endpoint": "https://api.yourstore.com/orders/status",
    "method": "GET",
    "timeout": 10,
    "headers": [
      {
        "name": "Content-Type",
        "value": "application/json"
      },
      {
        "name": "Authorization",
        "value": "Bearer sk_..."
      }
    ],
    "schema": [
      {
        "name": "order_id",
        "type": "string",
        "description": "Die Bestellungs-ID des Kunden"
      },
      {
        "name": "order_number",
        "type": "number",
        "description": "Die numerische Bestellnummer"
      },
      {
        "name": "priority_order",
        "type": "boolean",
        "description": "Ob dies eine Prioritätsbestellung ist"
      }
    ],
    "created_at": "2025-10-10T12:00:00.000000Z",
    "updated_at": "2025-10-10T12:00:00.000000Z"
  }
}

​
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