configurator_entries – Einträge eines Projekts im Konfigurator auflisten (ALBERT | AI Tool)

Anzeigename: Configurator: entries of a project

Interner Name: agorum_ai_dev_configurator_entries (über MCP: configurator_entries)

Was macht das Tool?

Das Tool listet auf, was ein Konfigurationsprojekt in den Bereichen des Konfigurators von agorum.dev bereits hat - dieselben Zeilen, die ein Benutzer im Konfigurator sieht:

• die Registrierungen je Art, etwa aguila-Widgets, Filter, Custom Services oder DataHandler
• die YML-Dateien des Projekts
• die Sprachdateien
• das Projekt selbst mit seiner Version
• die Workflows des Projekts mit ihrem Zustand

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

Empfohlener Einsatzzweck

Verwenden Sie das Tool, bevor die KI in einem Projekt etwas registriert oder abmeldet. Es zeigt,

• was bereits registriert ist - so entstehen keine doppelten Registrierungen,
• unter welchem Projekt und Namen ein Eintrag steht - genau diese Angaben braucht configurator_run für unregister,
• welche YML-Dateien sich ausführen lassen (executable: true) und mit welcher Config (configId).

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

Parameter	Beschreibung
project (Pflicht)	Name des Projekts, zum Beispiel agorum.demo.
area (optional)	Nur diesen Bereich liefern. Mögliche Werte: die Kennung einer Registrierungs-Config, zum Beispiel aguila-widget yml-metadata-files: Metadaten und Metadaten-Sammlungen yml-structure-files: Strukturen yml-files: project.yml, die Exportdateien und uninstall.yml messages: die Sprachdateien projects: das Projekt selbst workflows: die Workflows des Projekts Ohne Angabe liefert das Tool alle Bereiche.

Rückgabe

{
  "project": "agorum.demo",
  "areas": [
    { "id": "aguila-widget", "kind": "registration", "label": "...", "configId": "aguila-widget",
      "entries": [{ "name": "agorum.demo.myWidget", "project": "agorum.demo", "scriptPath": "...",
        "readOnly": false,
        "objectLink": "[my-widget.js](object:...)" }] },
    { "id": "yml-metadata-files", "kind": "yml", "entries": [{ "fileName": "metadata.yml", "configId": "yml-metadata",
      "executable": true, "scriptPath": "..." }] }
  ],
  "emptyAreas": ["acic-filter", "..."]
}

Zu beachten:

• emptyAreas nennt die Bereiche, in denen das Projekt nichts hat.
• Ein Eintrag mit readOnly: true lässt sich nicht entfernen.
• Eine Strukturdatei mit Platzhaltern ist die Struktur einer Akte. Sie wird nicht ausgeführt, sondern aus JavaScript vom structure-builder aufgerufen, und erscheint deshalb mit executable: false.
• Eine Exportdatei führen Sie mit configurator_run aus: Config project, Vorgang action, Aktion export, Optionen project und exportFile.
• Der Bereich workflows nennt je Workflow unter anderem die Version, ob er deployt ist (deployed), ob er seit dem Deployen geändert wurde (changed), die deployten Versionen (deployedVersions) und, wo er sich nicht deployen lässt, den Grund (fault).

Beispiel-Prompt

Zeige mir mit configurator_entries, welche aguila-Widgets im Projekt my.project
registriert sind und welche YML-Dateien sich ausführen lassen.

Tipps und Tricks