read_email

macOS

Doel

Gebruik dit wanneer de gebruiker de volledige inhoud wil van een e-mail die in Apple Mail op de Mac staat (bericht-ID uit list_emails/search_emails). Gebruik m365_read_email voor een Microsoft 365-bericht-ID uit m365_list_emails. Geef account= door (en mailbox= als die bekend is, beide afkomstig uit list_emails/search_emails), zodat de zoekactie op één account is gericht in plaats van alle accounts te doorzoeken. Roep de tool opeenvolgend aan, niet parallel — gelijktijdige aanroepen worden achter het JXA-slot van Mail.app in de wachtrij gezet en latere aanroepen krijgen een time-out. Prestaties: het ophalen van de berichttekst is de belangrijkste bron van vertraging (gemiddeld 20s bij trage IMAP). Geef include_body=false door om dit over te slaan en alleen metadata op te halen (snel). Geef max_body_chars=N door om de berichttekst na het verwijderen van HTML te beperken tot N tekens (standaard 30000; 0=onbeperkt). Het antwoord bevat body_fetch_ms wanneer het ophalen langer dan 2s duurde, body_omitted=true wanneer dit is overgeslagen en body_truncated_at=N wanneer de tekst is afgekapt. Wanneer een berichttekst niet op deze Mac in de cache staat, retourneert read_email metadata met body_omitted=true en body_omit_reason="not_downloaded" (geoptimaliseerde iCloud-/IMAP-opslag), in plaats van Mail de tekst te laten ophalen (dat kan traag zijn en Mail bezet houden). Als de gebruiker de tekst toch wil, probeer het opnieuw met force_download=true om Mail de tekst nu via IMAP te laten downloaden en terug te sturen (wacht maximaal ongeveer 60s). Standaard uitgeschakeld; wordt genegeerd zolang Mail in een afkoelperiode zit.

Vereiste invoer

• message_id

De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.

Machtigingen en bevestiging

Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.

• Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

{
  "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"
}

Documentatievoorbeeld

Documentatievoorbeeld voor read_email. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

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