agorum_ai_agents_library_basic_create_mail

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: Creates a new email

Was macht das Tool?

Dieses Tool erstellt einen neuen E-Mail-Entwurf direkt in agorum core. Es ermöglicht die Angabe von Absender, Empfängern, Betreff, Inhalt (HTML-Format), CC, BCC, Signatur und Anhängen. Nach dem Aufruf wird ein Entwurfs-Objekt angelegt, das im System weiter bearbeitet oder versendet werden kann. Die Anlage erfolgt im Benutzerkontext oder für einen angegebenen Nutzer.

Hinweis: Beim Erstellen des E-Mail-Entwurfs setzt das Tool automatisch die Metadaten agorum_ai_created_by_ai (Boolean) und agorum_ai_chat_id (String) auf dem neu erstellten Objekt. Damit ist nachvollziehbar, dass das Objekt durch einen KI-Agenten erzeugt wurde und in welchem Chat-Kontext dies passiert ist.

Empfohlener Einsatzzweck

Das Tool eignet sich ideal für die automatisierte Erstellung von E-Mail-Entwürfen in verschiedenen Szenarien:

Workflow-gesteuerte Benachrichtigungen und automatische Informationsversendung
Erstellung von Standard-E-Mails auf Basis von Dokumenten oder Vorgängen
Automatisches Zusammenstellen von E-Mails mit Anhängen aus dem DMS
Integration in Geschäftsprozesse, bei denen E-Mails vorbereitet werden sollen

Funktionsbeschreibung

Parameter	Beschreibung
to (Pflicht)	Empfänger der E-Mail. Mindestens eine E-Mail-Adresse als Zeichenkette, bei mehreren als Array angeben. Beispiel: ["max@beispiel.de"].
subject (Pflicht)	Betreffzeile der zu erstellenden E-Mail. Beispiel: "Ihre Anfrage zu Produkt X"
from (Optional)	Der Absender der E-Mail. Wird kein Wert angegeben, wird der Standard-Absender des Benutzers verwendet. Standard: Die E-Mail-Adresse des aktuellen Benutzers wird verwendet
cc (Optional)	CC (Carbon Copy)-Empfänger als Array von E-Mail-Adressen. Diese Empfänger erhalten eine Kopie der E-Mail. Beispiel: ["kollege@firma.de"]
bcc (Optional)	BCC (Blind Carbon Copy)-Empfänger als Array. Diese Empfänger erhalten eine Blindkopie. Beispiel: ["archiv@firma.de"]
body (Optional)	Inhalt der E-Mail im HTML-Format. Einzelne Absätze sollten mit <p>-Tags ausgezeichnet werden. Beispiel: "<p>Sehr geehrter Kunde,</p><p>vielen Dank für Ihre Anfrage.</p>"
attachments (Optional)	Liste der Anhang-Objekte (IDs, UUIDs oder Pfade zu Dateien/Dokumenten, die angehängt werden sollen). Beispiel: ["12345678-aaaa-bbbb-cccc-1234567890ab", "/agorum/dokumente/angebot.pdf"]
signature (Optional)	Signatur, die an das Ende der E-Mail angefügt wird. Beispiel: "Mit freundlichen Grüßen\nMax Mustermann"
user (Optional)	Der agorum core Benutzer (als id, uuid oder path), für den der Entwurf angelegt werden soll. Standard: Der aktuell angemeldete Benutzer
inreplyto (Optional)	RFC822 Message-ID einer E-Mail, auf die diese E-Mail als Antwort referenziert werden soll. Wird für die korrekte Thread-Zuordnung verwendet. Beispiel: "<abc123@mail.beispiel.de>"

Tipps und Tricks

Mindestens ein Empfänger (to) und ein Betreff (subject) sind erforderlich.
Der E-Mail-Inhalt (body) kann HTML enthalten. Für bessere Lesbarkeit Absätze mit <p> nutzen.
Anhänge müssen als gültige agorum core Objekt-IDs, UUIDs oder Pfade angegeben werden.
Das Tool erzeugt nur den Entwurf. Der Versand erfolgt separat.