Agententools (Übersicht)

Agententools geben Ihrer KI benutzerdefinierte Fähigkeiten. Anstatt nur aus bekanntem Text zu antworten, kann die KI beim Entwerfen einer Antwort Ihre Systeme aufrufen — zum Beispiel um den „Bestellstatus nachzuschlagen" oder ein „Lieferdatum zu überprüfen" — und das Ergebnis in ihre Antwort einflechten. Dieser Leitfaden ist die konzeptionelle, aufgabenorientierte Übersicht: was Tools sind, die zwei Typen, wie Sie eines erstellen, wie Sie eine Beschreibung schreiben, die die KI tatsächlich gut nutzt, Import aus OpenAPI und die Zuweisung von Tools zu Kanälen. Für Endpunkt-, Sicherheits- und JSON Schema-Details siehe den im gesamten Dokument verlinkten Integrationsleitfaden.

Sie finden Tools unter Einstellungen → Agententools (Route /settings/agent-tools). Für die Verwaltung von Agententools ist die Rolle OWNER oder ADMIN erforderlich; Agenten und Betrachter können diese in der Regel einsehen.

Was ein Agentool ist#

Ein Tool ist eine benutzerdefinierte Fähigkeit, die Sie der KI geben. Wenn die Nachricht eines Kunden nach Live- oder kontospezifischen Informationen verlangt — zum Beispiel dem Status ihrer Bestellung — kann die KI das Tool aufrufen, echte Daten zurückbekommen und diese nutzen, um eine präzise Antwort zu verfassen. Damit wird die KI von etwas, das nur Ihre Dokumentation kennt, zu etwas, das in Ihrem Namen innerhalb der von Ihnen definierten Grenzen handeln kann.

Die zwei Tool-Typen#

Server-seitig (SERVER_SIDE)

HelpStack ruft einen HTTP-Endpunkt auf, den Sie bereitstellen. Sie definieren:

• Name
• Beschreibung (siehe Eine gute Beschreibung schreiben — dies ist das wichtigste Feld)
• URL Ihres Endpunkts
• HTTP-Methode
• Optionale Header
• Ein Parameter-JSON Schema, das die Eingaben beschreibt, die die KI liefern muss

Dies ist der häufigste Fall: HelpStack wendet sich an Ihr Backend, das die Daten zurückgibt.

Client-seitig (CLIENT_SIDE)

Das Tool läuft im Browser des Website-Besuchers und nicht auf Ihrem Server. Dies ist fortgeschritten — greifen Sie darauf zurück, wenn die Aktion wirklich im Browser-Kontext des Besuchers stattfinden muss.

Tools erstellen und verwalten#

Unter Einstellungen → Agententools können Sie:

• Ein Tool erstellen (wählen Sie seinen Typ, füllen Sie dann die Felder aus).
• Ein vorhandenes Tool bearbeiten.
• Ein Tool löschen.
• Ein Tool Aktiv / inaktiv schalten, ohne es zu löschen.

Tool-Aufrufe werden protokolliert, sodass Sie überprüfen können, was die KI aufgerufen hat.

Eine gute Beschreibung schreiben#

Die Beschreibung ist entscheidend — sie ist das, was die KI liest, um zu entscheiden, wann sie das Tool aufrufen soll. Schreiben Sie sie wie Anweisungen an einen neuen Kollegen, der Ihre Systeme noch nie gesehen hat:

• Sagen Sie wann man es verwendet und wofür es da ist.
• Sagen Sie, welche Informationen erforderlich sind, um es aufzurufen.

Ein gutes Beispiel:

„Verwenden Sie dies, wenn der Kunde nach dem Status einer bestehenden Bestellung fragt. Erfordert deren Bestellnummer."

Hier würde ORDER_NUMBER einer der im Parameter-JSON Schema des Tools definierten Parameter sein. Eine vage Beschreibung veranlasst die KI, das Tool zum falschen Zeitpunkt aufzurufen oder es ganz zu überspringen; eine klare macht es zuverlässig.

Import aus OpenAPI#

Wenn Ihre Systeme bereits über eine OpenAPI-Spezifikation verfügen, müssen Sie Tools nicht einzeln definieren. Verwenden Sie „Aus OpenAPI importieren" und stellen Sie Ihre Spezifikation bereit — HelpStack generiert Tools daraus. Dies ist der schnellste Weg, eine bestehende API für die KI zugänglich zu machen.

Organisationsweite vs. kanalspezifische Tools#

• Tools können organisationsweit definiert werden, sodass sie überall verfügbar sind.
• Tools können auch pro Kanal zugewiesen oder überschrieben werden unter Einstellungen → Kanäle → Kanal → Tools.

Das bedeutet, Sie können einen gemeinsamen Satz von Tools behalten und dennoch anpassen, welche Tools ein bestimmter Kanal verwenden kann — zum Beispiel, indem Sie ein Bestellnachschlage-Tool nur auf Ihrem Support-Kanal verfügbar machen.

Weiterführende Informationen#

Dieser Leitfaden bleibt absichtlich konzeptionell. Für die technischen Details — Endpunkt-Verträge, Authentifizierung und Sicherheit, Header und wie Sie das Parameter-JSON Schema schreiben — siehe den Integrationsleitfaden:

• Benutzerdefinierte Agententools (Integrationsleitfaden)

Verwandte Themen#

• Benutzerdefinierte Agententools (Integrationsleitfaden) — Endpunkt-, Sicherheits- und JSON Schema-Details.
• Kanäle — Tools pro Kanal in der Registerkarte Tools zuweisen oder überschreiben.
• KI-Anbieter — das Modell, das entscheidet, wann Ihre Tools aufgerufen werden.
• KI-Antworten — wie Tools in das Entwerfen einer Antwort einfließen.
• Wissensdatenbank — fundieren Sie Antworten in Ihren Inhalten (Tools liefern Live-Daten).
• Glossar — Definitionen von server-seitig, client-seitig, OpenAPI und mehr.