Zur Dokumentation springen
DokumentationE-Mail

E-Mail

Lassen Sie einen Agenten aus Ihrem Postfach senden, es durchsuchen und lesen und die Mails sortieren, während Sallyport das Passwort behält.

Auf dieser Seite

Ihr Agent schreibt die Nachricht, und Sallyport sendet sie aus Ihrem eigenen Postfach. Er durchsucht den Posteingang, liest Nachrichten und Anhänge, verschiebt und markiert Mails. Das Passwort bleibt in Sallyport, und der Agent sieht es nie.

Postfach verbinden

  • Öffnen Sie Postfach verbinden. Aus Schlüssel ist es „Schlüssel hinzufügen“, dann „E-Mail“ unter „Quelle des Schlüssels“.
  • Wählen Sie den „E-Mail-Anbieter“: Gmail / Google Workspace, Outlook / Microsoft 365, Yahoo Mail, iCloud Mail, Fastmail, Zoho Mail oder „Eigener Mailserver“. Server, Ports und Verschlüsselung füllen sich aus und bleiben änderbar.
  • Geben Sie die „E-Mail-Adresse“ und das „Postfach-Passwort“ ein. Die meisten Anbieter erwarten hier ein App-Passwort, und das Formular führt zur Seite, die es ausstellt.
  • Drücken Sie „Verbindung testen“. Sallyport meldet sich bei jedem Server an und nennt den, der abgelehnt hat.
  • Drücken Sie „Postfach speichern“. Das Passwort ist versiegelt und lässt sich nicht zurücklesen. Alle Agenten des Arbeitsbereichs erhalten das Postfach.
AnbieterWelches Passwort
Gmail / Google WorkspaceEin App-Passwort. Google stellt es aus, sobald die Bestätigung in zwei Schritten aktiv ist.
Outlook / Microsoft 365Das Postfach-Passwort. Ihre Microsoft-365-Verwaltung schaltet für das Postfach SMTP AUTH und die IMAP-Anmeldung mit Passwort ein.
Yahoo MailEin App-Passwort aus der Kontosicherheit.
iCloud MailEin app-spezifisches Passwort Ihres Apple Accounts.
FastmailEin App-Passwort mit IMAP- und SMTP-Zugriff.
Zoho MailEin anwendungsspezifisches Passwort. Organisationspostfächer nutzen smtppro.zoho.com und imappro.zoho.com.

Ein Postfach sendet über seinen SMTP-Server und wird über seinen IMAP-Server gelesen. Schalten Sie einen unter „Senden (SMTP)“ oder „Lesen (IMAP)“ aus, und seine Werkzeuge gehen mit.

Mit Google oder Microsoft anmelden

Postfächer bei Gmail und Microsoft 365 melden sich beim Anbieter an statt mit einem Passwort. Wählen Sie unter „Wie Sallyport sich anmeldet“ „Mit Google anmelden“ oder „Mit Microsoft anmelden“ und drücken Sie „Speichern und mit Google anmelden“ oder „Speichern und mit Microsoft anmelden“. Der Anbieter bittet Sie, den Zugriff zu erlauben, und bringt Sie zur Seite des Schlüssels zurück.

  • Sallyport verwahrt das Token im Tresor und erneuert es selbst, wie jeden Schlüssel mit Anmeldung. Kein Passwort wird gespeichert.
  • Google meldet sich über die eigene App von Sallyport an. Bei Microsoft registrieren Sie eine eigene App: Das Formular nennt die „Redirect-URI“ dafür und nimmt ihre „Client-ID“ und ihr „Client-Secret“. Die App braucht IMAP.AccessAsUser.All, SMTP.Send und offline_access.
  • Das Token geht nur an die Mailserver des Anbieters selbst: smtp.gmail.com und imap.gmail.com oder smtp.office365.com, outlook.office365.com und smtp-mail.outlook.com.

Was der Agent tun kann

Der Agent behält seine MCP-Verbindung zu Sallyport. Ein Postfach gibt ihm drei Werkzeuge, benannt nach der Verbindung:

WerkzeugWas es tutKlasse
_readlist_folders; search in einem Ordner; fetch einer Nachricht über ihre uid; ein attachment über seinen part. Lesen markiert nichts als gelesen.Lesen
_sendSendet eine Nachricht aus dem Postfach: to, cc, bcc, subject, text, html, reply_to, in_reply_to, references und attachments.Schreiben
_changemove und copy nach to_folder; flag und unflag mit flags; delete; create_folder.Schreiben. delete und die Markierung deleted sind destruktiv.
Argumente von _read · die ungelesenen Mails der Buchhaltung
{
  "operation": "search",
  "from": "[email protected]",
  "unseen": true
}
Argumente von _send · eine Antwort mit Datei
{
  "to": "Ana Lima <[email protected]>",
  "bcc": "[email protected]",
  "subject": "Re: Invoice 42",
  "text": "Paid today. The receipt is attached.",
  "in_reply_to": "<[email protected]>",
  "attachments": [{ "filename": "receipt.csv", "content_type": "text/csv", "content_base64": "YW1vdW50LGR1ZQo0MjAwLEZyaWRheQo=" }],
  "intent": "Confirm the payment of invoice 42"
}
Argumente von _change · die bezahlte Rechnung ablegen
{
  "operation": "move",
  "uids": [4102],
  "to_folder": "Archive",
  "intent": "File the paid invoice"
}
  • search liefert die Gesamtzahl und die neuesten Nachrichten, standardmäßig 20 und höchstens 100, jede mit uid, Absender, Betreff, Datum und Markierungen.
  • fetch liefert die Kopfzeilen, den Text, das HTML und die Liste der Anhänge mit ihrem part.
  • Eine Nachricht geht immer aus dem Postfach selbst. Bcc erreicht seine Empfänger und steht nie in der Nachricht.
  • Eine Änderung betrifft nur die Nachrichten, die sie nennt. Eine uid, die der Ordner nicht hat, kommt als missing zurück.

Festlegen, was auf Sie wartet

Mails laufen standardmäßig ohne Nachfrage. Um jede Nachricht vor dem Versand zu sehen, öffnen Sie den Agenten unter Agenten, suchen das Postfach in seiner Liste „Zugriff“ und stellen die Spalte Schreiben auf „Freigabe erforderlich“ oder schalten „Bei jedem Aufruf fragen“ ein.

Die Freigabekarte zeigt jeden Empfänger, Bcc eingeschlossen, den Betreff, den Text und jede Datei mit Name und Größe. Es geht genau die Nachricht von der Karte hinaus.

Limits und Sicherheit

  • Eine Nachricht trägt bis zu 100 Empfänger, 20 Anhänge und 10 MiB insgesamt.
  • Eine Nachricht wird bis 80 MiB gelesen, Text und HTML bis je 2 MiB. Eine längere Antwort wird gespeichert, und fetch_body liest sie.
  • Ein Vorgang dauert bis zu 120 Sekunden.
  • Immer TLS mit geprüftem Zertifikat: SMTP auf 465 oder 587, IMAP auf 993 oder 143. Port 25 wird abgelehnt.
  • Das Protokoll hält Empfänger, Betreff und Dateinamen jeder Nachricht fest. Der Text bleibt draußen.