agorum_ai_agents_library_basic_get_content

Anzeigename: Gets the content (as raw text) of an agorum core object

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

Was macht das Tool?

Dieses Tool liest den Inhalt eines agorum core Objekts als reinen Text aus und gibt ihn als RAW TEXT zurück. Das ist besonders hilfreich, um Escaping-Probleme (z. B. doppelt maskierte Sonderzeichen) zu vermeiden.

Um den KI-Kontext zu schützen, ist die Ausgabe standardmäßig auf maximal 20.000 Zeichen begrenzt. Wenn der Inhalt länger ist, wird er wort-/zeilenfreundlich gekürzt (es wird kein Wort mitten im Wort abgeschnitten). In diesem Fall wird truncated: true ausgegeben und zusätzlich nextStart, damit Sie beim nächsten Aufruf exakt an der richtigen Stelle weiterlesen können.

Optional können Sie über start und length gezielt einen Ausschnitt lesen (Paging). Zusätzlich wird ein MD5-Hash geliefert, der bei nachfolgenden Schreiboperationen zur Änderungserkennung verwendet werden kann.

Empfohlener Einsatzzweck

Das Tool eignet sich, um Inhalte von Dateien/Dokumenten automatisiert auszulesen, z. B. für Analysen, Textauswertungen, Zusammenfassungen oder als Vorstufe für automatisierte Bearbeitungen. Durch die Standardbegrenzung auf 20.000 Zeichen ist es zudem gut für den Einsatz im KI-Chat geeignet.

Funktionsbeschreibung

Parameter	Beschreibung
id (Pflicht)	Die Objekt-ID des agorum core Objekts, dessen Text-Inhalt gelesen werden soll.
start (optional)	Startposition (0-basierter Zeichenindex), ab der der Inhalt gelesen wird. Standard: `0`
length (optional)	Maximale Anzahl an Zeichen, die ab `start` zurückgegeben werden sollen. Standard: `20000` (kontextschonende Begrenzung). Hinweis: Die tatsächlich zurückgegebene Länge kann etwas kleiner sein, da die Ausgabe bevorzugt am Zeilenende bzw. an Wortgrenzen gekürzt wird.

Rückgabeformat

Das Tool liefert RAW TEXT mit klaren Trennern:

=== FILE METADATA ===
uuid: <uuid>
name: <filename>
hash: <md5 hash>
totalSize: <total size in characters>
start: <start position>
returnedLength: <returned length>
truncated: <true|false>
nextStart: <start position for the next read - only when truncated>
=== FILE CONTENT ===
<content>
=== END OF FILE ===

Tipps und Tricks

Tipp: Verwenden Sie für sehr große Dateien Paging mit start und length. Wenn truncated: true zurückkommt, rufen Sie das Tool erneut mit start=<nextStart> auf, um exakt weiterzulesen.

Hinweis:Wenn das Objekt nicht gefunden wird, liefert das Tool eine Fehlermeldung ("agorum core object not found, wrong id"). Wenn das Objekt keinen Inhalt unterstützt, wird ebenfalls eine Fehlermeldung zurückgegeben ("This object does not support getting content.").