1. Eigene Funktion (Task-Definition) anlegen

Damit dein Agent eigene Aufgaben ausführen kann, kannst du eine neue Funktion bei Callana registrieren – das ist eine Beschreibung dafür, welche Parameter der Agent dafür abfragen und wie er auf bestimmte Aufträge reagieren soll.

1. API‑Schlüssel besorgen
   Stelle sicher, dass du einen gültigen API‑Token im Header deiner Anfrage mitsendest:

Authorization: Bearer <DEIN_API_TOKEN

2. Funktion definieren
   Erstelle eine neue Funktion mit Name, Beschreibung und Parameter-Template:

POST /api/functions
Content-Type: application/json
Authorization: Bearer <DEIN_API_TOKEN>

3. Antwort prüfen
   Achte auf den HTTP‑Status 201 Created und das zurückgegebene JSON mit function_id:

2. Aufgabe (Task) an einen Agenten übergeben

Hast du eine Funktion angelegt, kannst du dem Agenten jetzt einen konkreten Auftrag erteilen.

1. Agenten‑ID ermitteln
   Rufe /api/agents auf, um die Liste deiner Agenten zu sehen, und notiere dir die passende agent_id.

2. Task anlegen
   Sende eine Anfrage mit function_id und den benötigten Parametern an deinen Agenten:

   POST /api/agents/{agent_id}/tasks
   Content-Type: application/json
   Authorization: Bearer <DEIN_API_TOKEN>
   
   

   
   

3. Task‑Bestätigung
   Bei Erfolg erhältst du HTTP 202 Accepted mit:

3. Aufgabe aktualisieren

Wenn du Parameter oder Priorität ändern möchtest, kannst du einen Task anpassen:

PATCH /api/tasks/{task_id}
Content-Type: application/json
Authorization: Bearer <DEIN_API_TOKEN>

– Antwort: HTTP 200 OK und das aktualisierte Task‑Objekt.

4. Aufgabe als abgeschlossen markieren

Ist der Task erledigt (z. B. nach erfolgreicher Ausführung durch den Agenten), kannst du ihn schließen:

PATCH /api/tasks/{task_id}/complete
Content-Type: application/json
Authorization: Bearer <DEIN_API_TOKEN>

– Antwort: HTTP 200 OK und "status":"completed".

Mit diesen API‑Endpunkten definierst du eigene Funktionen, übergibst Aufgaben an deinen KI‑Telefonagenten und verwaltest sie bis zur abschließenden Ausführung. Viel Erfolg beim Automatisieren!