Tools

Mit Tools wird der Agent zu jemandem, der Dinge erledigt: Jedes Tool ist eine Funktion, die die KI mitten im Gespräch aufrufen kann — Ihr eigener Webhook oder ein Tool, das Happ mitliefert.

Tool hinzufügen

1. Öffnen Sie im Agenten den Tab Tools.
2. Webhook — HTTP-Anfrage an Ihre API. Legen Sie Name, Beschreibung, Parameterschema, URL, Methode und ein gemeinsames Secret fest. Beispiele: create_reservation (POST), lookup_customer (GET).
3. Integriert — ohne Einrichtung, jeder Agent hat sie: searchKnowledge (Vektorsuche in der verknüpften Wissensdatenbank), turnOffAiMode (übergibt das Gespräch mit vollständigem Kontext an einen Mitarbeiter), searchPreviousConversations (schlägt nach, worüber dieser Kunde früher gesprochen hat) und sendImage (sendet ein Bild aus der Wissensdatenbank in den Chat).
4. Beschreiben Sie, wann das Tool aufgerufen werden soll, nicht nur, was es tut — die KI sieht Name, Beschreibung und Parameterschema in ihrem Prompt.
5. Klicken Sie bei einem Tool auf Überprüfen, um einen Testaufruf auszulösen und die Antwort zu kontrollieren.

Die KI füllt Pflichtparameter aus dem Kontext (und fragt beim Kunden nach, wenn Angaben fehlen). Tool-Aufrufe sind rekursiv — Ergebnisse fließen in den nächsten Schritt ein, sodass die KI mehrere Tools in einer Antwort verketten kann.

Beispiel für einen Webhook-Aufruf

POST an Ihren Endpunkt mit den gesammelten Parametern plus chatId:

{ "table_id": "T-12", "time": "2026-05-18T19:30:00Z", "guests": 4, "phone": "+380501234567", "chatId": "chat-uuid" }

Geben Sie kurzes JSON zurück, das die KI in eigenen Worten wiedergeben kann:

{ "result": "Booking confirmed. Confirmation number #12345." }

Hinterlegen Sie für das Tool ein Secret, enthält jeder Aufruf den Header Authorization: Basic <secret>. Aufrufe mit Body (POST, PUT, PATCH) enthalten zusätzlich X-Signature: sha256=<hex> — einen HMAC-SHA256 des unveränderten Bodys; berechnen Sie ihn vor der Verarbeitung selbst nach. Ein GET-Tool sendet seine Parameter im Query-String und hat keine Signatur.

API: api.happ.tools/reference

Weiter

• Wissensdatenbank — vor dem Handeln Informationen nachschlagen lassen
• KI-Steuerung — wie turnOffAiMode übergibt und wann die KI wieder aktiviert wird
• Kanäle — wo Tool-Aufrufe stattfinden: Telegram, Instagram, WhatsApp, Telefonie