read_email

macOS

Finalidade

Use isto quando o usuário desejar o conteúdo completo de um e-mail que reside no Apple Mail do Mac (ID da mensagem de list_emails/search_emails). Para uma ID de mensagem do Microsoft 365 de m365_list_emails, use m365_read_email. Passe account= (e mailbox= se conhecido, ambos de list_emails/search_emails) para que a pesquisa tenha como alvo uma conta em vez de verificar todas elas. Chame sequencialmente, não em paralelo - as chamadas simultâneas seriam serializadas atrás do bloqueio JXA do Mail.app e as chamadas posteriores atingirão o tempo limite. Desempenho: a busca do corpo é a principal fonte de latência (média de 20s no IMAP lento). Passe include_body=false para ignorá-lo e obter apenas metadados (rápido). Passe max_body_chars=N para limitar o corpo em N caracteres após a remoção de HTML (padrão 30000; 0=ilimitado). A resposta inclui body_fetch_ms quando a busca leva >2s, body_omitted=true quando ignorada, body_truncated_at=N quando cortada. Quando um corpo não está armazenado em cache neste Mac, read_email retorna metadados com body_omitted=true e body_omit_reason="not_downloaded" (armazenamento otimizado do iCloud/IMAP) em vez de fazer o Mail buscá-lo (isso pode ser lento e amarrar o Mail). Se o usuário quiser mesmo assim, tente novamente com force_download=true para que o Mail puxe o corpo sobre IMAP agora e devolva-o (aguarda até cerca de 60s). Desativado por padrão; ignorado enquanto o Mail está em espera.

Entradas obrigatórias

• message_id

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

• Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

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

Exemplo documental

Exemplo de documentação para read_email. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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