E-Mail-Tools

Ein verbundenes Postfach ist auch eine Tool-Familie für den Agenten, E-Mails lesen, durchsuchen, öffnen, senden, beantworten, markieren und verschieben. Alle owner-only und getrennt von E-Mail-als-Kanal.

Das Postfach, das du als E-Mail-Kanal verbindest, hat zwei Oberflächen: Neben dem Beantworten eingehender Mail stellt es deinem Agenten eine Tool-Familie bereit, den Posteingang lesen, durchsuchen, eine Nachricht öffnen, senden, im Thread antworten, als gelesen/ungelesen markieren und Nachrichten verschieben. Jedes einzelne dieser Tools ist owner-only. Hier ist, was ein interner Agent mit einem Postfach als Tools tun kann.

Verbinden

Es gibt keinen separaten Verbindungsschritt für die E-Mail-Tools, das Verbinden des E-Mail-Kanals ist das, was sie aktiviert. Dieselbe Postfach-Zeile treibt beide Oberflächen an.

Verbinde ein Postfach unter Kanäle → Kanal hinzufügen → Email, Gmail-Anmeldung oder IMAP/SMTP für jeden anderen Provider. Die vollständigen Schritte findest du auf der Seite zum E-Mail-Kanal.
Hänge diese Verbindung an einen internen Agenten an, das Dashboard oder BotFather. Die E-Mail-Tools erscheinen nur für interne Aufrufer.
Sprich mit dem Agenten. Bitte ihn, den Posteingang zu prüfen, einen Absender zu suchen oder eine Antwort zu entwerfen.

Der entscheidende Haken: Diese Tools sind owner-only, sie laufen nur auf internen Oberflächen und niemals für einen Website-Besucher, denn ein Postfach enthält private Mail. Ein öffentlicher Web-Chat-Agent sieht sie auch nach dem Verbinden nicht. Und die Einstellung Nur lesen des Kanals ist der An-/Aus-Schalter für die Schreib-Hälfte: Aktivierst du sie, verschwinden Senden, Antworten, Markieren und Verschieben, und es bleiben nur die Lese-Tools.

Was der Agent tun kann

Tool	Zugriff	Typ	Funktion
`email_list_accounts`	Nur Inhaber	Read	Listet die mit diesem Agenten verbundenen Postfächer mit Adresse, Provider und Status auf, rufe es zuerst auf, wenn mehr als eines verbunden ist, um die Account-uid zu erhalten.
`email_read_inbox`	Nur Inhaber	Read	Listet aktuelle Nachrichten aus einem Ordner (Standard INBOX) mit Betreff, Absender, Datum und Lesestatus auf.
`email_search`	Nur Inhaber	Read	Durchsucht einen Ordner per Stichwort über Betreff, Absender und Textkörper; gibt passende Nachrichten zurück.
`email_get_message`	Nur Inhaber	Read	Öffnet eine Nachricht anhand ihrer id, vollständiger Betreff, Von/An/CC, Datum und Textkörper.
`email_send`	Nur Inhaber	Write	Sendet eine neue E-Mail (reiner Text oder HTML) mit optionalem CC und BCC, von der verbundenen Adresse.
`email_reply`	Nur Inhaber	Write	Antwortet auf eine Nachricht im Thread, setzt die Threading-Header und stellt dem Betreff 'Re:' voran.
`email_mark_read`	Nur Inhaber	Write	Markiert eine Nachricht als gelesen oder ungelesen.
`email_move`	Nur Inhaber	Write	Verschiebt eine Nachricht in einen anderen Ordner oder ein anderes Label, Papierkorb, Archiv und Ähnliches.

Owner-only, und die Trennung Lesen/Schreiben

Keines davon ist public-safe. Alle acht sind an einen internen Aufrufer plus das Vorhandensein des E-Mail-Add-ons gebunden, und jeder Aufruf ist als sensibel markiert, damit er im Chat-Stream verborgen bleibt. Darin gibt es zwei Stufen: die vier Lese-Tools (Accounts auflisten, Posteingang lesen, suchen, Nachricht abrufen) und die vier Schreib-Tools (senden, antworten, als gelesen markieren, verschieben). Der Nur lesen-Schalter des Kanals entfernt die vier Schreib-Tools, ein Postfach im Nur-Lesen-Modus lässt den Agenten Mail sichten und zitieren, aber nie darauf reagieren.

Praxisbeispiel

Du sagst deinem internen Support-Agenten: „Sieh in meinem Posteingang nach allem von Acme aus dieser Woche, und falls sie nach der Rechnung gefragt haben, antworte, dass sie unterwegs ist.“ Der Agent führt email_search für Acme aus, email_get_message, um den Thread zu lesen, dann email_reply, um im Thread unter deinem Absendernamen und deiner Signatur zu antworten, ein einziger Round-Trip, kein Kontextwechsel zu deinem Mail-Client.

Grenzen & Ehrlichkeit

Schreibvorgänge sind echte Sendungen. email_send und email_reply stellen an echte Empfänger von deiner echten Adresse zu. Teste zuerst mit einem internen Agenten.
Nur lesen ist die Schutzvorrichtung. Mit aktivierter Einstellung Nur lesen des Kanals sind die Schreib-Tools vollständig verborgen, der Agent kann lesen, aber niemals senden, markieren oder verschieben.
Ids sind undurchsichtig und providerabhängig geformt. Eine Nachrichten-id ist eine Zahl bei IMAP-Postfächern und eine Zeichenkette bei Gmail, übergib immer genau das, was email_read_inbox oder email_search zurückgegeben hat; rate nicht.
Wähle das Postfach, wenn es mehr als eines gibt. Bei mehreren verbundenen Postfächern rufe zuerst email_list_accounts auf und übergib die account_uid; bei einem einzelnen Postfach wird es für dich ausgewählt.

Fehlerbehebung

Der Agent sieht die E-Mail-Tools nicht, du bist wahrscheinlich auf einem öffentlichen/Web-Chat-Agenten. Die Familie ist owner-only; hänge das Postfach an einen internen Agenten an.
Lesen funktioniert, Senden wird abgelehnt, das Postfach ist im Modus Nur lesen, oder (bei IMAP) die SMTP-Hälfte konnte sich nicht authentifizieren. Prüfe beides.
„No email accounts connected“, das Postfach ist nicht an diesen Agenten angehängt, oder die Verbindung hat einen Fehler. Verbinde erneut über Kanäle.

FAQ

Ist das etwas anderes als der E-Mail-Kanal? Dieselbe Verbindung, zweite Oberfläche. Der Kanal beantwortet eingehende Mail; die Tools lassen einen internen Agenten das gesamte Postfach lesen und darauf reagieren.

Kann ein Website-Besucher meinen Posteingang lesen? Niemals, alle acht Tools sind owner-only und bleiben auf kundenseitigen Agenten deaktiviert.

Kann ich mehr als ein Postfach verbinden? Ja, jedes hat seine eigene account_uid; liste zuerst die Accounts auf, dann sprich eines an.

Nächste Schritte

E-Mail-Kanal, die andere Hälfte: eingehende Mail als Unterhaltungen
Google Workspace, Drive, Docs, Calendar und Gmail
Fähigkeiten des Agenten, wie sich Tools mit einem Agenten verbinden
Übersicht der Integrationen

Auf dieser Seite