read_email

macOS

Objectif

Utilisez-le lorsque l'utilisateur souhaite consulter l'intégralité du contenu d'un e-mail stocké dans Apple Mail du Mac (ID de message de list_emails/search_emails). Pour un ID de message Microsoft 365 de m365_list_emails, utilisez m365_read_email. Passez account= (et mailbox= si connu, tous deux provenant de list_emails/search_emails) afin que la recherche cible un compte au lieu de tous les analyser. Appelez de manière séquentielle et non en parallèle : les appels simultanés sont sérialisés derrière le verrou JXA de Mail.app et les appels ultérieurs expireront. Performances : la récupération du corps est la principale source de latence (20 s en moyenne sur un IMAP lent). Passez include_body=false pour l’ignorer et obtenir uniquement les métadonnées (rapide). Passez max_body_chars=N pour limiter le corps à N caractères après la suppression de HTML (par défaut 30 000 ; 0 = illimité). La réponse inclut body_fetch_ms lorsque la récupération a pris > 2 s, body_omitted=true lorsqu'elle est ignorée, body_truncated_at=N lorsqu'elle est coupée. Lorsqu'un corps n'est pas mis en cache sur ce Mac, read_email renvoie des métadonnées avec body_omitted=true et body_omit_reason="not_downloaded" (stockage optimisé iCloud/IMAP) plutôt que de laisser Mail le récupérer (cela peut être lent et bloquer Mail). Si l'utilisateur le souhaite quand même, réessayez avec force_download=true pour que Mail récupère le corps sur IMAP maintenant et le renvoie (attend jusqu'à environ 60 s). Désactivé par défaut ; ignoré pendant que Mail est en temps de recharge.

Entrées requises

• message_id

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.

• Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

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

Exemple documentaire

Exemple de documentation pour read_email. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

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