Tools: den Agenten mit Ihren eigenen Systemen verbinden

Wofür ein Tool da ist

Ein Tool ist eine HTTPS-Adresse auf Ihrem System (ein API-Endpunkt). Der Agent ruft sie bei Bedarf im Gespräch auf, zum Beispiel um Terminverfügbarkeit, Versandstatus oder das Guthaben eines Kunden aus Ihrem System zu lesen.

Nutzen Sie ein Tool für jedes System ohne fertige Integration. Öffnen Sie „Tools“ im Menü; Hinzufügen, Bearbeiten, Löschen und Testen von Tools erfordern die Rolle Inhaber oder Administrator.

Ein neues Tool hinzufügen

1. Drücken Sie „Neues Tool“.
2. Schreiben Sie den „Tool-Name“ in Kleinbuchstaben mit Unterstrichen, zum Beispiel check_availability.
3. Beschreiben Sie unter „Wann soll es genutzt werden?“ klar, was das Tool tut und bei welchen Fragen es aufgerufen werden soll. Aus dieser Beschreibung entscheidet der Agent, wann er das Tool aufruft.
4. Tragen Sie die Methode (GET oder POST) und die Adresse ein. Die Adresse muss mit https beginnen; lokale und private Netzwerkadressen werden abgelehnt.
5. Definieren Sie mit „Feld hinzufügen“ die Felder, die das Tool erwartet: Name, Typ, Beschreibung und ob es Pflicht ist. Der Agent füllt diese Felder aus dem Gespräch. Die Typen werden unten erklärt.
6. Wählen Sie die „Authentifizierung“: keine, Bearer-Token oder ein eigener Header (mit Header-Namen). Das Geheimnis wird auf dem Server gespeichert und nie wieder angezeigt; lassen Sie das Feld beim Bearbeiten leer, um den gespeicherten Wert zu behalten.
7. Testen Sie vor dem Speichern mit Beispielwerten über „Testaufruf“; Sie sehen sofort die Antwort oder den Fehler.

Feldtypen und verschachtelte Felder

Jedes Feld hat einen Typ, und der Wert wird in diesem Typ an Ihren Endpunkt gesendet. Ein Feld „Ja/Nein“ wird zum Beispiel als true gesendet, nicht als Text „true“, und ein Feld „Zahl“ mit der Eingabe 1,234.5 als 1234.5.

• Text, Zahl, Ja/Nein: ein einzelner Wert. Ein Ja/Nein-Feld versteht yes, no, true, false, 1 und 0.
• Datum: Sie können 06.10.2026 (Tag zuerst) oder 2026-10-06 schreiben; gesendet wird 2026-10-06. Datum und Uhrzeit: zum Beispiel 06.10.2026 14:30; gesendet wird 2026-10-06T14:30:00.
• Objekt: eine Gruppe mit eigenen Unterfeldern, zum Beispiel ein Kunde (Name, E-Mail). Ohne Unterfelder wird der Wert unverändert als freies JSON gesendet.
• Liste: mehrere Werte. Wählen Sie den „Elementtyp“; ist das Element ein Objekt, definieren Sie seine Felder, zum Beispiel Bestellzeilen (Produkt-ID, Menge).

Felder lassen sich bis zu 5 Ebenen tief verschachteln. Objekt und Liste sind nur bei POST-Tools wählbar; eine GET-Anfrage kann keine verschachtelten Daten tragen.

Bei POST-Tools erscheint unter den Feldern ein „Beispiel-Body“: die Form des JSON-Bodys, den Ihr Endpunkt bekommt. Sie können ihn mit dem vergleichen, was Ihr Endpunkt erwartet. Im „Testaufruf“ hat jedes Feld eine passende Eingabe; Objekt- und Listenfelder öffnen sich mit dem Beispiel-Body vorausgefüllt.

Passt ein Wert nicht zum Typ seines Felds (zum Beispiel „viele“ in einem Feld Zahl) oder ist ein Pflichtfeld leer, wird die Anfrage nicht gesendet; der Fehler nennt das Feld, zum Beispiel items[1].id (das Feld id des zweiten Eintrags).

Tools, die Daten ändern

Ändert das Tool etwas in Ihrem System (einen Datensatz erstellen, eine Stornierung usw.), haken Sie „Dieses Tool ändert Daten“ an. Solche Tools werden nie mit anderen Werten wiederholt, und jeder Aufruf wird protokolliert. In der Liste tragen sie das Abzeichen „Ändert Daten“.

Ein Tool in einem Agenten nutzen

• Wählen Sie im Tab „Tools“ des Schritts KI-Assistent, welche Tools der Agent erreichen kann: alle (auch später hinzugefügte) oder die gewählten.
• Ein Schritt „Auswahl“ kann seine Optionen aus einem Tool laden; zum Beispiel werden freie Terminzeiten als Karten aufgelistet.
• Ein Schritt „Tool-Aufruf“ ruft das Tool an einer bestimmten Stelle im Flow auf, ohne KI, und speichert die Antwort in einer Variable.

Siehe die Artikel Schritt KI-Assistent, Schritt Auswahl und Schritt Tool-Aufruf.

Die Liste verwalten

Suchen Sie Tools nach Name oder Beschreibung und filtern Sie nach Methode und Authentifizierungsart. Fehlerhafte Tools tragen das Abzeichen „Fällt aus“. Löschen Sie ein Tool, ruft der Agent es nicht mehr auf.