read_email

macOS

Scopo

Usa questo strumento quando l’utente vuole il contenuto completo di un’email presente in Apple Mail sul Mac (l’ID del messaggio proviene da list_emails/search_emails). Per un ID messaggio di Microsoft 365 proveniente da m365_list_emails, usa m365_read_email. Passa account= (e mailbox= se noto, entrambi provenienti da list_emails/search_emails) affinché la ricerca sia limitata a un solo account invece di esaminarli tutti. Esegui le chiamate in sequenza, non in parallelo: le chiamate simultanee vengono serializzate dal lock JXA di Mail.app e quelle successive scadranno. Prestazioni: il recupero del corpo è la principale fonte di latenza (in media 20 s con IMAP lento). Passa include_body=false per saltarlo e ottenere rapidamente solo i metadati. Passa max_body_chars=N per limitare il corpo a N caratteri dopo la rimozione dell’HTML (valore predefinito 30000; 0=senza limite). La risposta include body_fetch_ms quando il recupero richiede >2s, body_omitted=true quando viene saltato e body_truncated_at=N quando il corpo viene troncato. Quando il corpo non è memorizzato nella cache di questo Mac, read_email restituisce i metadati con body_omitted=true e body_omit_reason="not_downloaded" (archiviazione ottimizzata iCloud/IMAP), invece di fare in modo che Mail lo scarichi, operazione che può essere lenta e tenere Mail occupato. Se l’utente lo vuole comunque, riprova con force_download=true affinché Mail scarichi subito il corpo tramite IMAP e lo restituisca (attende fino a ~60s). Questa opzione è disattivata per impostazione predefinita e viene ignorata mentre Mail è in un periodo di cooldown.

Input obbligatori

• message_id

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.

• Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

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

Esempio documentale

Esempio di documentazione per read_email. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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