aguila_widget

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 tools einrichten

Anzeigename: Aguila Widget

Hinweis: Im Wissensbereich stehen Informationen zur Verwendung dieses KI-Tools zur Verfügung. Binden Sie nicht nur das Tool selbst, sondern auch das Wissen in Ihre KI-Voreinstellungen ein, um dieses Tool optimal zu nutzen.

Was macht das Tool?

Das Tool aguila_widget öffnet oder schließt aguila-Widgets direkt in der Bedienoberfläche, und zwar im gleichen UI-Kontext, in dem auch der Chat läuft. Dadurch können KI-Agenten Widgets zur Vorschau anzeigen lassen (Action open) und sie anschließend wieder schließen (Action close).

Empfohlener Einsatzzweck

Das Tool eignet sich besonders für:

iterative Widget-Entwicklung (Widget öffnen → visuell prüfen → verbessern → erneut öffnen)
Kombination mit einem Screen-Capture-Tool wie über das KI-Tool capture_screen, um visuelles Feedback (Screenshot) für UI-Änderungen zu erhalten
gezieltes Ein-/Ausblenden von UI-Dialogen/Popups, die als aguila-Widget in einer JS-Datei implementiert sind

Funktionsbeschreibung

Parameter	Beschreibung
action (Pflicht)	Legt fest, welche Aktion ausgeführt wird. open: Öffnet ein Widget anhand eines JS-Dateipfads und gibt eine `widgetId` zurück. close: Schließt ein zuvor geöffnetes Widget anhand der `widgetId`.
widgetJsPath (Optional)	Absoluter Pfad zur JS-Datei, die das aguila-Widget definiert. Wird benötigt, wenn `action` = `open`. Die JS-Datei muss als letzter Ausdruck ein gültiges aguila-Widget zurückgeben (z. B. `widget;`). Wenn der Pfad ohne `.js` angegeben wird, versucht das Tool zusätzlich automatisch auch `.js` anzuhängen.
widgetId (Optional)	Die Widget-Instanz-ID, die von einem vorherigen Aufruf mit `action` = `open` zurückgegeben wurde. Wird benötigt, wenn `action` = `close`. Gilt nur innerhalb der aktuellen UI-Session / des aktuellen Kontexts.

Beispiel-Prompt

Bitte öffne das Widget aus der Datei "/agorum/roi/customers/<mein.projekt>/js/widgets/<demo-widget.js>".

Öffnen eines einfachen aguila-Widgets aus dem Chat

Anforderungen an das aguila-Widget

Damit ein Widget mit dem KI-Tool aguila_widget geöffnet werden kann, muss die angegebene JS-Datei ein aguila-Widget erzeugen und als letzten Ausdruck zurückgeben.
Das Tool prüft außerdem, ob das zurückgegebene Widget eine popup()-Funktion besitzt (Popup-fähiges Widget).

Hinweis: Wichtig ist, dass am Ende der Datei wirklich das Widget-Objekt steht (z. B. widget;). Ein reines return in einer Funktion reicht nicht, wenn am Dateiende kein Widget als Expression zurückgegeben wird.

Übersicht über die Anforderungen

Absoluter Dateipfad muss existieren (oder Tool findet die Datei über automatisches Anhängen von .js).
Die Datei muss ein gültiges aguila-Widget erzeugen.
Das Widget muss Popup-fähig sein (d. h. widget.popup({}) muss funktionieren).
Das Widget muss als letzter Ausdruck der Datei zurückgegeben werden (z. B. widget;).

Einfaches Beispiel-Widget

Das folgende Skript zeigt das aguila-Widget, das für das Anzeigebeispiel oben verwendet wurde:

let aguila = require('common/aguila');

let widget = aguila.create({
  type: 'agorum.vbox',
  width: 500,
  height: 260,
  items: [
    {
      type: 'agorum.textInput',
      name: 'title',
      readOnly: true,
      value: 'Hallo aus dem Demo-Widget',
    },
    {
      type: 'agorum.spacer',
      height: 5,
    },
    {
      type: 'agorum.textInput',
      name: 'info',
      readOnly: true,
      value: 'Dieses Widget wurde per aguila_widget im UI-Kontext des Chats geöffnet.',
    },
    {
      type: 'agorum.spacer',
      height: 10,
    },
    {
      type: 'agorum.button',
      name: 'okButton',
      text: 'OK',
    },
  ],
});

setImmediate(function () {
  if (widget.form) {
    widget.form.title = 'Demo-Widget';
  }
});

widget.down('okButton').on('clicked', function () {
  if (widget.form) {
    widget.form.close();
  }
});

widget;

Tipps und Tricks

Tipp: Wenn das Schließen fehlschlägt („Widget not found …“), ist das Widget ggf. bereits geschlossen oder die widgetId stammt aus einem anderen UI-Kontext.