Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht

Navigation: Dokumentationen agorum core > ALBERT | AI > ALBERT | AI Agents > ALBERT| AI KI-Tools-Dokumentationen

agorum_ai_agents_library_basic_database_read

Anzeigename: Database read

Was macht das Tool?

Dieses Tool liest die UUIDs von Datenbankeinträgen aus einer angegebenen Collection (Datensammlung) in agorum core aus. Es können gezielt Einträge anhand von Metadaten gefiltert werden.
Das Ergebnis kann entweder aus den UUIDs der gefundenen Datensätze bestehen oder optional auch alle Datenbankdaten enthalten.

Empfohlener Einsatzzweck

Das Tool wird genutzt, um gezielt Datensätze aus einer bestimmten Collection in agorum core zu finden, etwa für Auswertungen, Datenabgleiche oder zur Weiterverarbeitung. Es eignet sich optimal für Fälle, in denen Daten gezielt nach bestimmten Metadaten ausgelesen werden sollen.

Funktionsbeschreibung

Parameter Beschreibung
collectionName
(Pflicht)		 Name der Collection, aus der gelesen werden soll.
data
(Pflicht)		 Objekt mit den Metadaten-Feldern der Collection zur Filterung der Einträge.
  • Muss mindestens agorum_ai_agents_library_basic_database_identifier (der Name des Datenbestands/Aktion) enthalten.
  • Optional kann agorum_ai_agents_library_basic_database_id (Primärschlüssel, falls gezielt Datensatz-ID gesucht wird) angegeben werden.
  • Weitere Metadatenfelder sind möglich.
additionalQuery
(Optional)		 Zusätzlicher Query-String für erweiterte Filtermöglichkeiten.
returnAllDBData
(Optional)
  • true = Gibt alle DB-Daten inkl. UUID und Inhalt zurück.
  • false = Gibt nur die UUIDs zurück.

Default: false
 

Tipps und Tricks

Tipps:

  • Je genauer die Metadaten im data-Objekt angegeben werden, desto gezielter und schneller ist die Suche. Für große Datenmengen empfiehlt es sich, die Rückgabe auf UUIDs zu beschränken (returnAllDBData=false).
  • Durch Kombination von returnAllDBData=true lassen sich komplette Datensätze mit Inhalt laden. Für einfache ID-Listen returnAllDBData=false verwenden.