read_email

macOS

Zweck

Verwenden Sie dies, wenn der Benutzer den vollständigen Inhalt einer E-Mail haben möchte, die sich im Apple Mail des Mac befindet (Nachrichten-ID von list_emails/search_emails). Für eine Microsoft 365-Nachrichten-ID von m365_list_emails verwenden Sie m365_read_email. Übergeben Sie account= (und mailbox=, falls bekannt, beide von list_emails/search_emails), damit die Suche auf ein Konto abzielt, anstatt alle zu scannen. Rufen Sie nacheinander auf, nicht parallel – gleichzeitige Aufrufe werden hinter der JXA-Sperre von Mail.app serialisiert, und bei späteren Aufrufen kommt es zu einer Zeitüberschreitung. Leistung: Body Fetch ist die primäre Latenzquelle (durchschnittlich 20 Sekunden bei langsamem IMAP). Übergeben Sie include_body=false, um es zu überspringen und nur Metadaten zu erhalten (schnell). Übergeben Sie max_body_chars=N, um den Text nach dem HTML-Stripping auf N Zeichen zu begrenzen (Standard 30000; 0 = unbegrenzt). Die Antwort umfasst body_fetch_ms, wenn der Abruf mehr als 2 Sekunden dauerte, body_omitted=true, wenn er übersprungen wurde, und body_truncated_at=N, wenn er abgeschnitten wurde. Wenn ein Text auf diesem Mac nicht zwischengespeichert wird, gibt read_email Metadaten mit body_omitted=true und body_omit_reason="not_downloaded" (für iCloud/IMAP optimierter Speicher) zurück, anstatt dass Mail sie abruft (was langsam sein und Mail blockieren kann). Wenn der Benutzer es trotzdem möchte, versuchen Sie es erneut mit force_download=true, damit Mail den Text jetzt über IMAP zieht und zurückgibt (Wartezeit ca. 60 Sekunden). Standardmäßig deaktiviert; Wird ignoriert, während sich Mail in einer Abklingzeit befindet.

Erforderliche Eingaben

• message_id

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

• Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

{
  "properties": {
    "account": {
      "type": "string"
    },
    "force_download": {
      "default": "false",
      "type": "boolean"
    },
    "include_body": {
      "default": "true",
      "type": "boolean"
    },
    "mailbox": {
      "type": "string"
    },
    "max_body_chars": {
      "default": "30000",
      "minimum": 0,
      "type": "integer"
    },
    "message_id": {
      "type": "string"
    }
  },
  "required": [
    "message_id"
  ],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für read_email. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

{
  "message_id": "demo-message-001"
}