tool_registry

Anzeigename: Tool Registry

Hinweise:

Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins ALBERT | AI Agents. Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.
Wie Sie die KI-Tools in Ihren KI-Voreinstellungen verwenden, erfahren Sie hier: ALBERT | AI Agents KI-Tools einrichten

Was macht das Tool?

Das Tool tool_registry dient zur dynamischen Verwaltung der in einem Preset (KI-Voreinstellung) verfügbaren Tools und ist die Grundlage für Lazy Tool Loading in chatWithToolCalls. Sobald dieses Tool einem Preset zugewiesen ist, wechselt das System automatisch in den Lazy-Modus: An die KI werden pro Nachricht nur tool_registry selbst und die von der KI explizit aktivierten Tools übertragen. Dadurch sinkt der Kontext (Tokens) deutlich, insbesondere bei Presets mit vielen Tools.

Über Aktionen kann die KI eine kompakte Liste aller Tools im Preset abrufen, Details (inkl. Parameter-Schema) zu einzelnen Tools anfordern und Tools für die nächste Nachricht aktivieren oder wieder deaktivieren. Die Aktivliste wird als INFO-Eintrag in der Chat-Historie gepflegt und vor jedem KI-Aufruf neu ausgelesen. Im Lazy-Modus wird zusätzlich das Argument _activeTools mit der aktuellen Aktivliste an tool_registry durchgereicht.

Empfohlener Einsatzzweck

Verwenden Sie tool_registry, wenn ein Preset sehr viele Tools enthält und die Übertragung aller Tool-Schemas zu teuer ist.
Das Tool ist ideal, um:

Tokens zu sparen, indem Tools erst bei Bedarf geladen/aktiviert werden
die Tool-Auswahl in der KI-Interaktion transparent zu machen (Liste + Details)
Tools nach der Nutzung wieder zu deaktivieren, um den Kontext schlank zu halten

Funktionsbeschreibung

Parameter Beschreibung

Parameter	Beschreibung
action (Pflicht)	Aktion, die ausgeführt werden soll. list: Liefert eine kompakte Liste aller im Preset verfügbaren Tools (ohne `tool_registry`) inkl. Kurzbeschreibung. details: Liefert das vollständige Tool-Schema (Parameter, Beschreibung) für ein oder mehrere Tools. activate: Aktiviert Tools. Die Tools sind ab der nächsten KI-Nachricht direkt aufrufbar. deactivate: Deaktiviert Tools. Die Tools sind ab der nächsten KI-Nachricht nicht mehr verfügbar. Standard: –
names (Optional)	Liste von Tool-Namen (Funktionsnamen), auf die sich die Aktion bezieht. Erforderlich für: `details`, `activate`, `deactivate` Wird ignoriert für: `list` Maximal 10 Tool-Namen pro Aufruf Wichtig: Es werden die internen Tool-Funktionsnamen verwendet (z. B. die Namen aus den Schemas). Die Lazy-Mode-Detektion erfolgt über `tool.fnName === 'tool_registry'` und ist damit unabhängig vom Tool-Konfigurationsnamen. Standard: []
aiContextToolPrompt (Optional, nur Konfiguration)	Ein Freitext-Prompt, der beim Laden des Tools automatisch in den System-Kontext des Chats eingefügt wird. Über diesen Parameter können Sie dem Tool feste Arbeitsanweisungen, Regeln oder zusätzlichen Kontext mitgeben, ohne dass die KI den Parameter selbst sieht oder setzen kann. Der Wert wird nicht an die KI als Tool-Parameter übertragen. Stattdessen wird der Text vor jedem KI-Aufruf gesammelt und dem System-Prompt vorangestellt. Wenn mehrere Tools einen `aiContextToolPrompt` definieren, werden alle Texte zusammengeführt. Der Wert kann in der Tool-Konfiguration gesetzt werden. Dieser Parameter steht auf allen KI-Tools automatisch zur Verfügung. Typische Anwendungsfälle: Feste Regeln für ein Tool vorgeben (z. B. „Erstelle Dateien immer im PDF-Format“), zusätzlichen Kontext liefern (z. B. Firmenrichtlinien) oder das Verhalten der KI bei der Nutzung des Tools steuern. Standard: – (kein Prompt)

action
(Pflicht)

Aktion, die ausgeführt werden soll.

list: Liefert eine kompakte Liste aller im Preset verfügbaren Tools (ohne tool_registry) inkl. Kurzbeschreibung.
details: Liefert das vollständige Tool-Schema (Parameter, Beschreibung) für ein oder mehrere Tools.
activate: Aktiviert Tools. Die Tools sind ab der nächsten KI-Nachricht direkt aufrufbar.
deactivate: Deaktiviert Tools. Die Tools sind ab der nächsten KI-Nachricht nicht mehr verfügbar.

Standard: –

names
(Optional)

Liste von Tool-Namen (Funktionsnamen), auf die sich die Aktion bezieht.

Erforderlich für: details, activate, deactivate
Wird ignoriert für: list
Maximal 10 Tool-Namen pro Aufruf

Wichtig: Es werden die internen Tool-Funktionsnamen verwendet (z. B. die Namen aus den Schemas). Die Lazy-Mode-Detektion erfolgt über tool.fnName === 'tool_registry' und ist damit unabhängig vom Tool-Konfigurationsnamen.

Standard: []

aiContextToolPrompt
(Optional, nur Konfiguration)

Ein Freitext-Prompt, der beim Laden des Tools automatisch in den System-Kontext des Chats eingefügt wird. Über diesen Parameter können Sie dem Tool feste Arbeitsanweisungen, Regeln oder zusätzlichen Kontext mitgeben, ohne dass die KI den Parameter selbst sieht oder setzen kann.

Der Wert wird nicht an die KI als Tool-Parameter übertragen.
Stattdessen wird der Text vor jedem KI-Aufruf gesammelt und dem System-Prompt vorangestellt.
Wenn mehrere Tools einen aiContextToolPrompt definieren, werden alle Texte zusammengeführt.
Der Wert kann in der Tool-Konfiguration gesetzt werden.

Dieser Parameter steht auf allen KI-Tools automatisch zur Verfügung.

Typische Anwendungsfälle: Feste Regeln für ein Tool vorgeben (z. B. „Erstelle Dateien immer im PDF-Format“), zusätzlichen Kontext liefern (z. B. Firmenrichtlinien) oder das Verhalten der KI bei der Nutzung des Tools steuern.

Standard: – (kein Prompt)

Tipps und Tricks

Tipp: Aktivieren Sie nur die Tools, die Sie wirklich brauchen, und deaktivieren Sie sie danach wieder. So bleibt der Kontext klein und die KI-Antworten werden stabiler und günstiger. Beachten Sie außerdem: Nach einem activate-Aufruf sind die Tools bereits im nächsten Durchlauf des bestehenden Tool-Loops sichtbar. Es ist keine zusätzliche Benutzer-Nachricht erforderlich.