agorum_ai_agents_library_basic_metadb_read

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: MetaDB read

Was macht das Tool?

Das Tool liest einen Wert oder ein Bundle aus der agorum core MetaDB mithilfe des angegebenen MetaDB-Pfads aus. Als Ergebnis wird der Wert oder das Bundle als JSON zurückgegeben, bei fehlendem Wert null.

Empfohlener Einsatzzweck

Dieses Tool eignet sich optimal, um gezielt Konfigurationen, Einstellungen oder Ressourcen aus der agorum MetaDB programmatisch auszulesen. Perfekt für Systemadministratoren, Entwickler oder für Tools, die dynamisch auf MetaDB-Inhalte zugreifen oder diese überprüfen müssen.

Funktionsbeschreibung

Parameter Beschreibung

Parameter	Beschreibung
path (Pflicht)	Der genaue Pfad zu dem MetaDB-Eintrag, der ausgelesen werden soll. Dieser Pfad muss mit einem der Hauptbereiche starten: `MAIN_ACL_MANAGEMENT` `MAIN_COMMON_MANAGEMENT` `MAIN_GROUP_MANAGEMENT` `MAIN_MACHINE_MANAGEMENT` `MAIN_MODULE_MANAGEMENT` `MAIN_SERVER_MANAGEMENT` `MAIN_USER_MANAGEMENT` Beispiel: `MAIN_MODULE_MANAGEMENT/client/AddOns/drop-area-agorum.tpl3.js`
maxDepth (Optional)	Maximale Tiefe des zurückgegebenen Ergebnisbaums (1 bis 20). Damit lässt sich die Ausgabe bei großen MetaDB-Strukturen begrenzen. `1`: gibt nur Top-Level-Keys zurück; verschachtelte Objekte werden nicht ausgegeben `2`: gibt eine Ebene tiefer zurück, usw. Wertebereich: `1` bis `20` Wenn der Parameter nicht gesetzt ist, wird das vollständige Ergebnis zurückgegeben. Wenn das Ergebnis abgeschnitten wird, wird anstelle der abgeschnittenen Informationen folgender Hinweis angezeigt, dass es noch mehr Unterstruktur/Daten gibt, die aber nicht ausgegeben wurden: `... (truncated)`

path
(Pflicht)

Der genaue Pfad zu dem MetaDB-Eintrag, der ausgelesen werden soll. Dieser Pfad muss mit einem der Hauptbereiche starten:

MAIN_ACL_MANAGEMENT
MAIN_COMMON_MANAGEMENT
MAIN_GROUP_MANAGEMENT
MAIN_MACHINE_MANAGEMENT
MAIN_MODULE_MANAGEMENT
MAIN_SERVER_MANAGEMENT
MAIN_USER_MANAGEMENT

Beispiel:
MAIN_MODULE_MANAGEMENT/client/AddOns/drop-area-agorum.tpl3.js

maxDepth
(Optional)

Maximale Tiefe des zurückgegebenen Ergebnisbaums (1 bis 20). Damit lässt sich die Ausgabe bei großen MetaDB-Strukturen begrenzen.

1: gibt nur Top-Level-Keys zurück; verschachtelte Objekte werden nicht ausgegeben
2: gibt eine Ebene tiefer zurück, usw.

Wertebereich: 1 bis 20

Wenn der Parameter nicht gesetzt ist, wird das vollständige Ergebnis zurückgegeben.
Wenn das Ergebnis abgeschnitten wird, wird anstelle der abgeschnittenen Informationen folgender Hinweis angezeigt, dass es noch mehr Unterstruktur/Daten gibt, die aber nicht ausgegeben wurden: ... (truncated)

Beispiel-Prompt

Bitte lies in der MetaDB den Bereich der AddOns aus.

Tool: agorum_ai_agents_library_basic_metadb_read
Parameter:
- path: MAIN_MODULE_MANAGEMENT/filingassistant/2.0/control/AddOns
- maxDepth: 1

Tipps und Tricks

Tipps:

Prüfen Sie immer, ob der genutzte Pfad in der MetaDB existiert und die Schreibweise exakt stimmt. Das Tool liefert null zurück, wenn unter dem angegebenen Pfad kein Wert gefunden oder der Bereich nicht korrekt angegeben wurde.
Wenn Sie einen großen MetaDB-Baum auslesen möchten, starten Sie mit maxDepth: 1 und verfeinern anschließend den path (tieferer Pfad) in einem zweiten Aufruf. Das ist in der Regel effizienter, als die Tiefe immer weiter zu erhöhen.