Todas las herramientas

read_email

Correo electrónico · macOS

Efecto: lectura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Úselo cuando el usuario desee el contenido completo de un correo electrónico que se encuentra en Apple Mail de Mac (ID de mensaje de list_emails / search_emails). Para un identificador de mensaje de Microsoft 365 de m365_list_emails, use m365_read_email. Pase account= (y mailbox= si se conoce, ambos de list_emails / search_emails) para que la búsqueda se dirija a una cuenta en lugar de escanearlas todas. Llame secuencialmente, no en paralelo: las llamadas simultáneas se serializan detrás del bloqueo JXA de Mail.app y las llamadas posteriores expirarán. Rendimiento: la búsqueda del cuerpo es la principal fuente de latencia (promedio de 20 segundos en IMAP lento). Pase include_body=false para omitirlo y obtener solo metadatos (rápido). Pase max_body_chars =N para limitar el cuerpo a N caracteres después de eliminar HTML (predeterminado 30000; 0=ilimitado). La respuesta incluye body_fetch_ms cuando la recuperación tardó >2 s, body_omitted=true cuando se omitió, body_truncated_at =N cuando se cortó. Cuando un cuerpo no está almacenado en caché en esta Mac, read_email devuelve metadatos con body_omitted=true y body_omit_reason="not_downloaded" (almacenamiento optimizado para iCloud/ IMAP) en lugar de hacer que Mail los recupere (lo que puede ser lento y bloquear el correo). Si el usuario lo quiere de todos modos, vuelva a intentarlo con force_download=true para que Mail coloque el cuerpo sobre IMAP ahora y lo devuelva (espera hasta ~60 segundos). Desactivado de forma predeterminada; ignorado mientras Mail está en tiempo de reutilización.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Esquema técnico canónico en inglés — macOS
{
  "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"
}

Ejemplo documental

Ejemplo de documentación para read_email. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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