# Tools

Den Agenten in den Systemen Ihres Kunden handeln lassen — buchen, nachschlagen, übergeben — statt nur zu reden

> Full REST + WebSocket API reference: https://api.happ.tools/reference

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.

<ToolsPageDemo />

## Tool hinzufügen [#add-a-tool]

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 [#example-webhook-call]

POST an Ihren Endpunkt mit den gesammelten Parametern plus `chatId`:

```json
{ "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:

```json
{ "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](https://api.happ.tools/reference)

## Weiter [#next]

* [Wissensdatenbank](/docs/agents/knowledge) — vor dem Handeln Informationen nachschlagen lassen
* [KI-Steuerung](/docs/workspace/ai-control) — wie `turnOffAiMode` übergibt und wann die KI wieder aktiviert wird
* [Kanäle](/docs/integrations/messengers) — wo Tool-Aufrufe stattfinden: Telegram, Instagram, WhatsApp, Telefonie