> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inboxmate.psquared.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools & Integrationen

> Werkzeuge geben dem Agenten die Möglichkeit zu handeln — Kataloge abfragen, Karten zeigen, fremde Schnittstellen aufrufen.

Mit Werkzeugen kann der Chatbot mehr als antworten. Er kann zum Beispiel Ihren Katalog durchsuchen. Er ruft sie von sich aus auf, wenn das Gespräch es verlangt.

Wann ein Werkzeug passt, entscheidet der Agent anhand seiner **Beschreibung**. Eine vage Beschreibung führt zu falschen Aufrufen.

<Note>
  Eigene Werkzeuge und MCP-Server gibt es ab dem Pro-Tarif. Einige Werkzeuge aus dem Marktplatz stehen in allen Tarifen zur Verfügung.
</Note>

## Karten im Chat

Diese Werkzeuge zeigen etwas an, statt Daten zu holen. Sie warten auf keine Antwort — der Agent zeigt die Karte und spricht weiter.

| Karte            | Inhalt                                                                               |
| ---------------- | ------------------------------------------------------------------------------------ |
| **Produktkarte** | Bild, Titel, Preis, Verfügbarkeit und eine Schaltfläche zur Produktseite             |
| **Seitenkarte**  | Verweis auf eine Seite Ihrer Website, mit einem Satz, was den Besucher dort erwartet |
| **Kontaktkarte** | WhatsApp, Telefon oder E-Mail. Die ganze Karte ist anklickbar                        |

<Tip>
  Schreiben Sie in die Anweisungen ausdrücklich, dass Produkte **immer** als Karte gezeigt werden und nie als Text oder Link. Ohne diese Regel zählen viele Modelle die Produkte lieber als Liste auf — das sieht deutlich schlechter aus und der Besucher kann nichts anklicken.
</Tip>

Die Werte auf einer Produktkarte übernimmt der Agent aus der Antwort des Katalogwerkzeugs. Erfundene Titel oder Preise sind damit ausgeschlossen, solange Sie ihn nicht ausdrücklich zum Schätzen einladen.

## Eingebaute Werkzeuge

### Wissenssuche

Ist dem Agenten eine Wissens-Sammlung zugeordnet, bekommt er automatisch eine Suche darauf. Er stellt mehrere kurze Suchanfragen gleichzeitig und führt die Treffer zusammen.

### Websuche

Sucht im Internet, wenn das eigene Wissen nicht reicht. Zu aktivieren unter **Tools & Integrationen → Marktplatz**.

## Marktplatz

Fertige Anbindungen, die Sie mit wenigen Klicks aktivieren: **Tools & Integrationen → Marktplatz**.

| Bereich           | Werkzeuge                                                             |
| ----------------- | --------------------------------------------------------------------- |
| **Produktivität** | Jira, Twenty CRM                                                      |
| **Kommunikation** | Gmail (Beta)                                                          |
| **KI-Verwaltung** | Agenten, Kontakte, Wissen, Erinnerungen, geplante Aufgaben, Werkzeuge |
| **Recherche**     | Websuche                                                              |

## Eigene Werkzeuge

Sie können jede REST-Schnittstelle anbinden.

<Steps>
  <Step title="Werkzeug anlegen">
    **Tools & Integrationen → Neues Tool**
  </Step>

  <Step title="Adresse festlegen">
    Methode und Adresse eintragen. Bewegliche Teile in geschweiften Klammern:

    ```
    https://api.example.at/bestellungen/{bestellId}
    ```
  </Step>

  <Step title="Anmeldung hinterlegen">
    API-Schlüssel, Bearer-Token oder Basic Auth. Die Zugangsdaten werden verschlüsselt gespeichert.
  </Step>

  <Step title="Parameter beschreiben">
    Welche Angaben braucht das Werkzeug, welche sind Pflicht? Werte in doppelten geschweiften Klammern füllt der Agent aus dem Gespräch.
  </Step>

  <Step title="Beschreibung schreiben">
    Der wichtigste Teil. Sagen Sie klar, **wann** das Werkzeug zu benutzen ist:

    ```text theme={null}
    Nutze dieses Werkzeug, wenn ein Kunde nach dem Stand seiner
    Bestellung, der Sendungsverfolgung oder dem Liefertermin fragt.
    Erfordert die Bestellnummer.
    ```
  </Step>

  <Step title="Testen">
    Über den Testknopf eine Beispielanfrage schicken und die Antwort prüfen.
  </Step>
</Steps>

### Hinweise in der Antwort

Sie können in die Antwort Ihres Werkzeugs Hinweise für den Agenten legen — etwa *„Zeige höchstens drei Produkte als Karte und stelle danach genau eine Frage"* oder bei null Treffern *„Keine Treffer. Frage nach einer anderen Farbe. Erfinde kein Produkt."*

<Tip>
  Solche Hinweise wirken stärker als dieselbe Regel in den Anweisungen. Sie erreichen den Agenten genau in dem Moment, in dem er entscheidet — und nicht zwanzig Nachrichten vorher.
</Tip>

### Antworten klein halten

Eine Katalogantwort mit allen Feldern kann Hunderte Kilobyte groß sein. Das kostet Geld, macht den Agenten langsam und verschlechtert seine Antworten, weil das Wesentliche im Rauschen untergeht.

Geben Sie pro Treffer nur zurück, was die Karte braucht: Titel, Adresse, Bild, Preis, Verfügbarkeit, Kennung. Alles Weitere holt ein zweites Werkzeug für genau ein Produkt.

## MCP-Server

Für komplexere Anbindungen lässt sich ein MCP-Server verbinden. InboxMate findet die dort angebotenen Werkzeuge selbst.

<Info>
  MCP steht ab dem Pro-Tarif zur Verfügung.
</Info>

## Gute Praxis

* **Ein Werkzeug, eine Aufgabe.** Kein Alleskönner
* **Klare Beschreibung.** Danach entscheidet der Agent
* **Mit echten Daten testen**, nicht mit Wunschbeispielen
* **Fehler abfangen.** Legen Sie fest, was der Agent sagt, wenn die Schnittstelle nicht antwortet — sonst erfindet er etwas