configurator_list – Bausteine des Konfigurators auflisten (ALBERT | AI Tool)

Anzeigename: Configurator: list what can be configured

Interner Name: agorum_ai_dev_configurator_list (über MCP: configurator_list)

Was macht das Tool?

Das Tool listet auf, was der Konfigurator von agorum.dev in einem Konfigurationsprojekt einrichten kann. Jeder dieser Bausteine heißt Config und hat eine eindeutige Kennung, etwa aguila-widget, custom-service, messages oder project.

Die Liste wird bei jedem Aufruf aus dem System gelesen. Bringt ein Projekt eigene Configs mit, erscheinen sie hier ohne weitere Anpassung.

Jede Config gehört zu einer von drei Kategorien:

Kategorie	Beschreibung
type	Registriert ein Skript oder einen Eintrag in der MetaDB und meldet ihn wieder ab (Vorgänge register und unregister), etwa aguila-Widgets, acic-Filter, Decorators, Custom Services, DataHandler oder Reiter im Detailfenster.
executor	Führt etwas für ein Projekt aus (Vorgang execute), etwa YML-Dateien oder das Einlesen von Übersetzungen.
manager	Bietet benannte Aktionen an (Vorgang action), etwa ein Projekt anlegen, klonen oder exportieren.

Bringt eine Config Dateivorlagen mit, bietet sie zusätzlich den Vorgang createFromTemplate an: eine neue Datei aus einer Vorlage, auf Wunsch gleich registriert.

Das Tool liest nur und verändert nichts im System.

Empfohlener Einsatzzweck

Das Tool ist der erste Schritt, bevor die KI in einem Konfigurationsprojekt etwas registriert, anlegt oder ausführt. Statt MetaDB-Einträge, Zeilen der export.yml oder Deploy-Skripte von Hand zu schreiben, ermittelt die KI zuerst die passende Config. Der Konfigurator wendet dann die Namensregeln an und schreibt alles, was dazugehört.

Der Ablauf mit den Konfigurator-Tools:

1. configurator_list: Welche Config passt?
2. configurator_describe: Welche Parameter hat der gewünschte Vorgang?
3. configurator_entries: Was hat das Projekt bereits?
4. configurator_run: Vorgang ausführen, wo möglich zuerst als Probelauf.

Für den Einsatz im Chat ist das Tool nicht vorgesehen. Es steht im Developer Studio und über MCP für externe Coding Agents zur Verfügung, siehe die Toolgruppe agorum_ai_dev_configurator_tools.

Funktionsbeschreibung

Alle Parameter sind optional. Ohne Parameter liefert das Tool alle Configs.

Parameter	Beschreibung
category (optional)	Nur Configs dieser Kategorie liefern. Mögliche Werte: type executor manager
query (optional)	Nur Configs liefern, deren Kennung, Zusammenfassung oder Kurzbeschreibung diesen Text enthält. Groß- und Kleinschreibung wird nicht beachtet.
project (optional)	Nur Configs liefern, die zu diesem Projekt passen, etwa zu den YML-Dateien, die es hat. Angabe als Projektname, zum Beispiel agorum.demo.
path (optional)	Nur Configs liefern, die zu dem Objekt unter diesem Pfad passen, zum Beispiel /agorum/roi/customers/agorum.demo/js/aguila/my-widget.js.
aiContextToolPrompt (optional, nur in der Tool-Konfiguration)	Text, den das Tool beim Laden in den Kontext der KI einfügt. Er wird nicht von der KI gesetzt, sondern in der Tool-Konfiguration. Ohne eigene Angabe weist der Text die KI an, für Registrierungen, Dateivorlagen, YML-Dateien, Übersetzungen und Projektaktionen die Konfigurator-Tools zu verwenden - erst list, dann describe, dann run, wo möglich zuerst mit dryRun: true - und das nicht von Hand zu erledigen.

Rückgabe

Das Tool liefert die Anzahl und die Liste der Configs. Je Config stehen unter anderem Kennung (id), Kategorie, Zusammenfassung, Kurzbeschreibung, das Projekt, das die Config mitbringt, die möglichen Vorgänge und die Anzahl der Vorlagen darin:

{
  "total": 2,
  "configs": [
    { "id": "aguila-widget", "category": "type", "summary": "...", "shortDescription": "...",
      "sourceProject": "agorum.dev", "operations": ["register", "unregister", "createFromTemplate"],
      "templateCount": 8 },
    { "id": "project", "category": "manager", "operations": ["action:create", "action:clone", "action:export"],
      "blockedOperations": ["action:rename"] }
  ]
}

blockedOperations nennt Vorgänge, die die Config den KI-Tools nicht erlaubt. Diese bleiben dem Benutzer im Konfigurator vorbehalten, etwa das Umbenennen eines Projekts.

Beispiel-Prompt

Ich möchte im Projekt my.project einen neuen REST-Endpunkt anlegen.
Ermittle mit den Konfigurator-Tools, welche Config dafür zuständig ist
und welche Vorlagen sie anbietet.

Tipps und Tricks