agorum_ai_agents_library_basic_get_text

Anzeigename: Gets the 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 extrahiert den reinen Text aus einem agorum core Objekt. Das funktioniert auch bei Binärdateien (z. B. Office-/PDF-Dokumenten), bei denen der Textinhalt aus der Datei herausgelesen wird.

Die Rückgabe erfolgt als RAW TEXT, damit die Ausgabe im Chat direkt weiterverarbeitet werden kann und keine Probleme durch Escaping entstehen.

Um den KI-Kontext zu schützen, ist die Ausgabe standardmäßig auf maximal 20.000 Zeichen begrenzt. Wenn der extrahierte Text länger ist, wird er wort-/zeilenfreundlich gekürzt (kein Abschneiden mitten im Wort). 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).

Empfohlener Einsatzzweck

Das Tool ist geeignet für alle Anwendungsfälle, in denen der reine Text eines Dokuments benötigt wird, z. B. für Textanalysen, KI-gestützte Verarbeitung, die Vorbereitung von Zusammenfassungen oder die Weiterverarbeitung in anderen Systemen.

Funktionsbeschreibung

Parameter	Beschreibung
id (Pflicht)	Die Objekt-ID des agorum core Objekts, dessen Text extrahiert werden soll.
start (optional)	Startposition (0-basierter Zeichenindex), ab der der extrahierte Text gelesen wird. Standard: `0`
length (optional)	Maximale Anzahl an Zeichen, die zurückgegeben werden soll. Standard: `20000`. 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>
totalSize: <total size in characters>
start: <start position>
returnedLength: <returned length>
truncated: <true|false>
nextStart: <start position for the next read - only when truncated>
objectLink: <markdown link to the object>
=== FILE CONTENT ===
<extracted text>
=== END OF FILE ===

Tipps und Tricks

Tipp: Wenn truncated: true zurückkommt, rufen Sie das Tool erneut mit start=<nextStart> auf, um exakt weiterzulesen. So können Sie sehr große Dokumente sicher in Abschnitten verarbeiten.