Tool Calls¶

Wenn ein Agent im Karli-Studio-Chat ein Tool aufruft, kann der Aufruf mit unterschiedlichem Detailgrad sichtbar gemacht werden. Agentlab bietet Flow-Designern zwei Stellschrauben pro Tool: einen menschenlesbaren Titel und einen Anzeige-Modus.

Anzeige-Modi¶

Jeder Tool-Aufruf lässt sich in einem von drei Modi darstellen:

Hidden (none) — der Aufruf erscheint nicht im Chat. Der Agent erhält das Ergebnis trotzdem; nur der Nutzer sieht nicht, dass das Tool gelaufen ist. Sinnvoll für interne oder häufig laufende Tools, die den Gesprächsfluss sonst unnötig unterbrechen.
Summary line (line) — eine einzelne Zeile mit Titel und Laufzeit. Der Standard. Unaufdringlich, bestätigt aber, dass etwas passiert ist.
Expandable line (expandable) — die Zusammenfassungs-Zeile plus ein Chevron, das Inputs und Outputs des Tools vollständig aufklappt. Nützlich, wenn Transparenz wichtig ist, oder zum Debuggen während der Entwicklung.

Tool konfigurieren¶

An jeder tool-fähigen Komponente das Actions-Modal öffnen, um die exponierten Tools zu sehen. Ein Klick auf eine Zeile öffnet eine Seitenleiste, die unter anderem zwei Felder enthält, mit denen die Darstellung der Tool-Aufrufe im Chat gesteuert wird:

Title shown in chat — Freitext, der beim Aufruf angezeigt wird (z. B. Datum wird ermittelt). Leerlassen, um auf den Komponenten-Default oder den Tool-Slug zurückzufallen.
Display in chat — der Anzeige-Modus aus der obigen Liste.

Änderungen werden mit dem nächsten Flow-Run wirksam.

Defaults pro Komponente (fortgeschritten)¶

Komponenten-Autoren können beide Werte direkt am Output(...) vorbelegen. Praktisch, wenn eine Komponente sich grundsätzlich mit einem bestimmten Titel oder Anzeige-Modus präsentieren soll, unabhängig vom konkreten Flow.

from lfx.io import Output
from lfx.custom.custom_component.component import Component

class CurrentDateComponent(Component):
    outputs = [
        Output(
            name="get_current_date",
            method="get_current_date",
            tool_title="Datum wird ermittelt",
            tool_display="line",
        ),
    ]

Diese Defaults erscheinen vorausgefüllt in der Actions-Seitenleiste. Flow-Designer können sie pro Flow weiterhin überschreiben.

Reihenfolge

Für jeden Tool-Aufruf werden die Werte in dieser Reihenfolge aufgelöst:

Nutzer-Override in der Actions-Seitenleiste (pro Flow)
Autoren-Default am Output(...)
Laufzeit-Fallback — Summary line als Anzeige-Modus und der Tool-Slug als Titel