get_object_as_image – Direktlink und Vorschau eines Bildobjekts abrufen (ALBERT | AI Tool)

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: Gets a link to an agorum core image object and also makes the image usable for AI

Was macht das Tool?

Das Tool erzeugt zu einem agorum core Objekt einen anklickbaren Objekt-Link (Markdown) und zusätzlich einen direkten Bild-Link (Markdown), mit dem das Bild im Chat direkt angezeigt werden kann. Außerdem wird das Bild als Attachment in der KI-Historie bereitgestellt, damit das LLM das Bild in nachfolgenden Antworten visuell auswerten kann.

Das Tool zeigt nicht nur Bilddateien, sondern alle Objekte, zu denen agorum core eine Vorschau erzeugt, etwa PDF, Office-Dokumente, TIFF und GIF. Solche Dokumente liefert das Tool seitenweise als Bild: Mit dem Parameter page wählen Sie die Seite, die Anzahl der Seiten nennt das Ergebnis in pageCount.

Wenn ein Bild eine bestimmte Dateigröße oder Pixel-Dimension überschreitet, wird es vor dem Injizieren in die KI-History automatisch zu einem JPG-Preview verkleinert. Dadurch brechen KIs bei großen Bildern nicht mehr ab. Bilder, die selbst nach Verkleinerung zu groß bleiben oder bei der Verarbeitung fehlschlagen, werden übersprungen; in diesem Fall bleibt ein Text-Hinweis im Prompt erhalten. Die Grenzwerte für die Erzeugung eines JGP-Previews sind zentral im Plugin festgelegt:

Bilddateien in den Formaten jpg, jpeg, png und webp werden direkt gezeigt.
Alle anderen Objekte mit Vorschau (zum Beispiel PDF, Office-Dokumente, TIFF, GIF) werden seitenweise als Bild geliefert, siehe Parameter page.
Dateigröße des Originals: ab 1 MB wird ein Preview erzeugt
Pixel-Dimension des Originals: ab 2000 px in Breite oder Höhe wird ein Preview erzeugt
Zielgröße des Previews: längere Kante 1920 px, gespeichert als JPG
Maximale Größe des Previews: 5 MB; größere Previews werden verworfen

Empfohlener Einsatzzweck

Verwende das Tool, wenn du im Chat ein Bild aus agorum core anzeigen und gleichzeitig sicherstellen möchtest, dass die KI dieses Bild „sehen“ und für Analysen nutzen kann (z. B. Beschreibung eines Scans, Auswertung von Screenshots, Sichtprüfung von Fotos).

Funktionsbeschreibung

Parameter	Beschreibung
id (Pflicht)	Objekt-ID des agorum core Bildobjekts, zu dem ein Objekt-Link zurückgegeben wird und das als Bild-Attachment in die KI-Historie übernommen werden soll.
displayName (optional)	Optionaler Anzeigename für den Link. Wird dieser nicht gesetzt, nutzt das Tool automatisch den Objekt-Namen.
page (optional)	Seite des Dokuments, die als Bild gezeigt wird, beginnend bei 1. Standard: `1`. Eine Bilddatei hat nur die Seite 1.
aiContextToolPrompt (optional)	Ein Freitext-Prompt, der beim Laden des Tools automatisch in den System-Kontext des Chats eingefügt wird. Über diesen Parameter kannst du dem Tool feste Arbeitsanweisungen, Regeln oder zusätzlichen Kontext mitgeben, ohne dass die KI den Parameter selbst sieht oder setzen kann. Der Wert wird nicht an die KI als Tool-Parameter übertragen. Stattdessen wird der Text vor jedem KI-Aufruf gesammelt und dem System-Prompt vorangestellt. Typische Anwendungsfälle: feste Regeln (z. B. für Transkription), zusätzlicher Kontext oder Steuerung des KI-Verhaltens bei der Nutzung des Tools. Standard: – (kein Prompt)

Rückgabewert

Feld	Beschreibung
objectLink	Markdown-Link auf das agorum core Objekt, z. B.: `[Scan Eingangsrechnung 123](object:<UUID>)`
imageLink	Markdown-Bild-Link zum direkten Anzeigen im Chat, z. B.: `![Scan Eingangsrechnung 123](https://agorumdocproxy.agorum.com/api/rest/object/download/<UUID>)`
page, pageCount	Nur bei Dokumenten mit Seiten: die gezeigte Seite und die Gesamtzahl der Seiten, z. B. `"page": 2, "pageCount": 14`.

Tipps und Tricks

Tipps:

Bei mehrseitigen Dokumenten rufen Sie das Tool je Seite einmal auf und ändern page. Die Seitenzahl steht in pageCount.
Objekte ohne Vorschau, zum Beispiel Ordner, ZIP-Archive oder Videos, können nicht gezeigt werden. Das Tool liefert dann einen Fehler und nicht mehr ein Platzhalterbild.
Arbeitet ein externer Coding Agent über MCP mit dem Tool, erhält er das Bild als MCP-Bildinhalt und nicht nur als Link. Siehe ALBERT | AI als MCP-Server verwenden