agorum_ai_agents_library_basic_get_object_as_image

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 Bildobjekt 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.

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:

Unterstützte Bildformate: jpg, jpeg, png, webp
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.
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>)`

Tipps und Tricks

Tipps:

Das Tool funktioniert nur für unterstützte Bildformate (aktuell: jpg, jpeg, png, webp).
Falls das Objekt kein Bild ist, liefert das Tool einen Fehler