Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht

Navigation: Dokumentationen agorum core > agorum core Module und Plugins > ALBERT | AI

ALBERT | AI Chat-Widget

Hinweise:

  • Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins ALBERT | AI. Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.
  • Wenn Sie zusätzlich das Plugin ALBERT | AI Agents verwenden, können Sie weitere Funktionen verwenden. Die Zusatzfunktionen sind ebenfalls in dieser Dokumentation beschrieben, jeweils mit dem Hinweis, dass sie nur mit dem Plugin ALBERT | AI Agents zur Verfügung stehen.

Das aguila-Widget agorum.ai.chatMain ist die zentrale Chat-Komponente von ALBERT | AI. Es stellt die vollständige Chat-Oberfläche bereit, einschließlich Nachrichtenanzeige, Eingabefeld, Seitenpanel mit Chat-Historie und Vorlagen sowie Debug-Modus.

Entwickler können dieses Widget in eigene aguila-Oberflächen einbetten, um kontextbezogene KI-Chat-Funktionalität bereitzustellen, etwa in Detailfenstern, eigenen Dialogen oder spezialisierten Anwendungen.

Verwendung

Das Widget wird als aguila-Komponente eingebunden:

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

let chatTest = aguila.create({
  type: 'agorum.ai.chatMain',
  hideSidePanel: true,
  flexible: true,
});

chatTest;

 

Screenshot zum Verwendungsbeispiel


Oder eingebettet in einen Container:

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

let chatContext = aguila.create({
  type: 'agorum.vbox',
  width: 1100,
  height: 800,
  items: [
    {
      type: 'agorum.ai.chatMain',
      hideSidePanel: false,
      flexible: true,
      name: 'chat',
    },
  ],
});

let chat = chatContext.down('chat');

// Open a specific chat
chat.id = '8115311a-8b06-4d45-9a1f-c0437e303809';

// Set context
chat.context = 'Du bist ein Experte für agorum core.';

chatContext;

 

Screenshot zum Verwendungsbeispiel

Properties

Property Typ Beschreibung Pflicht
id string UUID eines bestehenden Chats. Wenn gesetzt, wird dieser Chat geöffnet und angezeigt. Wird keine id angegeben, wird ein neuer Chat erstellt. nein
ids array Array von UUIDs. Kann verwendet werden, um mehrere Objekt-IDs als Kontext zu übergeben (z. B. markierte Suchergebnisse). nein
hideSidePanel boolean Wenn true, wird das Seitenpanel (Chat-Historie und Vorlagen) ausgeblendet. Nützlich, wenn das Widget in einem kompakten Bereich eingebettet wird, z. B. im Detailfenster. nein
context string Ein zusätzlicher Kontext-Text, der bei der nächsten KI-Anfrage mitgesendet wird. Dieser Kontext wird im Chat-Objekt gespeichert und bleibt auch beim Wechsel zwischen Chats erhalten. Der Kontext wird zum Kontext aus der KI-Voreinstellung hinzugefügt. nein
chatTitle string Ein Titel, der in der Toolbar des Chat-Widgets oben angezeigt wird. Nützlich, um dem Benutzer den aktuellen Kontext anzuzeigen (z. B. Ordnername, Suchergebnis). nein
ignorePresetErrors boolean Wenn true, werden Fehler beim Laden von KI-Voreinstellungen (Presets) nicht als Fehlerdialog angezeigt, sondern still ignoriert. Nützlich für eingebettete Widgets, die robust auf fehlende Konfigurationen reagieren sollen. nein
toolParameters object Ein Objekt mit Schlüssel-Wert-Paaren, die auf alle vom Preset geladenen KI-Tools angewendet werden (nur bei Verwendung von ALBERT | AI Agents). nein

Property toolParameters im Detail

Mit der Property toolParameters können Entwickler Standardwerte für Tool-Parameter widget-weit vorgeben. Die Werte werden auf alle vom Preset geladenen Tools angewendet, als wären sie in der jeweiligen Tool-Konfiguration vorbelegt.

Ein konkretes Anwendungsbeispiel für toolParameters ist der Reiter ALBERT | AI im Detailfenster. Dort werden Tools, die in ihrem Schema allowedBasePathIds deklarieren, automatisch auf den aktuellen Kontext-Pfad eingeschränkt:

Kontext Erlaubte Pfade
Ordner-Kontext Der ausgewählte Ordner selbst + persönlicher Workspace
Datei-Kontext Alle sichtbaren Eltern-Ordner der Datei + persönlicher Workspace
Such-Kontext (oder kein Kontext) Nur der persönliche Workspace (home:ai/workspace)

Persönlicher Workspace-Ordner als Schreib-Fallback

Im Home-Verzeichnis jedes Benutzers wird beim ersten Öffnen des Details-Chats automatisch der Ordner home:ai/workspace angelegt (sofern noch nicht vorhanden). Dieser Ordner ist dauerhaft als zulässiger Schreib-Ordner für KI-Tools verfügbar: