Zum Hauptinhalt springen

Tools

Tools sind externe Funktionen oder Dienste, die ein Agent aufrufen kann, um Aufgaben auszuführen, die über das reine Beantworten von Fragen hinausgehen. Beispiele sind das Abrufen von Live-Daten aus einer API, das Ausführen von Berechnungen oder das Auslösen von Prozessen in angebundenen Systemen.

Vordefinierte Tools

Bubble Chat enthält vordefinierte Tools (PREBUILT), die nicht bearbeitet oder gelöscht werden können. Eigene Tools erweitern diese um unternehmensspezifische Integrationen.

Toolübersicht

Die Listenansicht zeigt alle vorhandenen Tools. Über das Suchfeld kann die Liste gefiltert werden. Ein Klick auf ein Tool öffnet die Detailansicht.

Neues Tool erstellen

Ein neues Tool wird über den +-Button erstellt. Im Erstellungsdialog werden folgende Informationen erfasst:

FeldBeschreibung
NameEindeutiger Name des Tools (mind. 2 Zeichen)
BeschreibungErklärt dem Agenten, was das Tool tut
VerwendungshinweiseGibt dem Agenten Hinweise, wann und wie das Tool eingesetzt werden soll
Eingabe-SchemaOptionales JSON-Schema zur Validierung der Eingabeparameter

Tools bearbeiten

In der Detailansicht eines Tools stehen folgende Felder zur Verfügung:

FeldBeschreibung
NameEindeutiger Name (mind. 2 Zeichen)
BeschreibungErklärt dem Agenten den Zweck des Tools
VerwendungshinweiseAnleitung für den Agenten zum Einsatz des Tools
Eingabe-Schema verwendenAktiviert oder deaktiviert die Validierung von Eingabeparametern
Eingabe-SchemaJSON-Schema-Definition der erwarteten Eingabeparameter (Code-Editor)

Alle Änderungen werden automatisch gespeichert.

Tool-Implementierungen

Jedes Tool kann mehrere Implementierungen haben – zum Beispiel für verschiedene Umgebungen (Entwicklung, Produktion) oder unterschiedliche Ausführungskontexte.

Eine Implementierung definiert:

FeldBeschreibung
ProviderDer Dienst oder die Technologie, welche die Funktion ausführt
UmgebungenUmgebungen, in denen diese Implementierung aktiv ist
KontexteAusführungskontexte, für die diese Implementierung gilt
KonfigurationJSON-Konfiguration für den gewählten Provider

Implementierungen können direkt im Detailbereich eines Tools hinzugefügt, bearbeitet und gelöscht werden.

Tools löschen

Ein benutzerdefiniertes Tool kann über die Aktionsleiste im Detailbereich gelöscht werden. Vordefinierte Tools (PREBUILT) können nicht gelöscht werden.

warnung

Beim Löschen eines Tools wird dieses automatisch aus allen Agenten entfernt, die es verwenden. Prüfen Sie beforehand, ob Agenten von diesem Tool abhängig sind.