agorum_ai_agents_library_basic_read_mail_data

Anzeigename: Reads the data from a email

Was macht das Tool?

Dieses Tool liest die Daten eines agorum core Mailobjekts aus und gibt die gewünschten Felder als flaches Objekt zurück. Wird readKeys nicht gesetzt oder ist leer, werden alle verfügbaren Felder zurückgegeben.
Das Ergebnis ist ein JSON-Objekt mit den angeforderten Maildaten.

Empfohlener Einsatzzweck

Verwenden Sie dieses Tool, wenn Sie gezielt die Metadaten und Inhalte einer E-Mail aus agorum core abrufen wollen, z. B. für Automatisierungen, Auswertungen oder die Weiterverarbeitung einzelner Mailbestandteile (wie Betreff, Absender, Empfänger, Anhänge usw.).

Funktionsbeschreibung

Parameter Beschreibung

mail
(Pflicht) Das agorum core Mailobjekt, das ausgelesen werden soll. Angabe als ID, UUID oder Pfad.

Parameter	Beschreibung
mail (Pflicht)	Das agorum core Mailobjekt, das ausgelesen werden soll. Angabe als ID, UUID oder Pfad.
readKeys (optional)	Array der zu lesenden E-Mail-Felder. Wenn nicht gesetzt oder leer, werden alle verfügbaren Felder geliefert. Mögliche Werte: `priority` `sensitivity` `receipt` `sent` `status` `from` `replyTo` `to` `cc` `bcc` `subject` `shouldSendDispositionNotification` `dispositionNotificationTo` `seen` `defaultSenderAddress` `body` `attachments`

readKeys
(optional)

Array der zu lesenden E-Mail-Felder. Wenn nicht gesetzt oder leer, werden alle verfügbaren Felder geliefert.

Mögliche Werte:

priority
sensitivity
receipt
sent
status
from
replyTo
to
cc
bcc
subject
shouldSendDispositionNotification
dispositionNotificationTo
seen
defaultSenderAddress
body
attachments

Tipps und Tricks

Tipps:

Wenn Sie nur bestimmte Felder benötigen (z. B. nur den Betreff oder nur die Anhänge), geben Sie diese explizit im readKeys-Array an. Das beschleunigt die Verarbeitung und reduziert die Datenmenge.
Das Tool prüft automatisch, ob das angegebene Objekt tatsächlich ein Mailobjekt ist. Bei ungültigen IDs oder falschem Objekttyp wird eine Fehlermeldung zurückgegeben.