agorum_ai_agents_library_basic_get_content

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

Was macht das Tool?

Dieses Tool liest den Inhalt eines agorum core Objekts (z. B. einer Datei oder eines Dokuments) als Text aus und gibt diesen als Text zurück. Optional kann nur ein Ausschnitt des Inhalts über Startposition und maximale Länge geladen werden. Zusätzlich wird ein MD5-Hash des zurückgegebenen Inhalts geliefert, der bei Schreiboperationen zur Kollisions-/Änderungserkennung verwendet werden kann.
Das Ergebnis enthält die UUID, den Namen und den eigentlichen Inhalt des Objekts. Falls das Objekt nicht gefunden wird, wird eine entsprechende Fehlermeldung ausgegeben.

Empfohlener Einsatzzweck

Das Tool eignet sich, um den reinen Textinhalt von Dateien, Dokumenten oder anderen agorum core Objekten automatisiert auszulesen. Es ist besonders nützlich für Integrationen, Analysen, Textauswertungen oder zur Weiterverarbeitung von Inhalten in anderen Systemen.

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 Bytes, die aus dem Objekt-Inhalt gelesen und zurückgegeben werden soll. Falls nicht angegeben, wird der komplette Inhalt ausgegeben.

Tipps und Tricks

Tipps:

Wenn Sie sehr große Dateien auslesen möchten, arbeiten Sie mit start und length in mehreren Schritten (Paging). Den zurückgegebenen hash können Sie anschließend für Schreiboperationen nutzen, um sicherzustellen, dass Sie auf der erwarteten Version arbeiten.
Wird ein Objekt nicht gefunden oder ist der Zugriff nicht erlaubt, gibt das Tool eine Fehlermeldung zurück.