read_email

macOS

목적

사용자가 Mac의 Apple Mail에 있는 이메일 전체 콘텐츠를 원할 때 사용합니다(list_emails/search_emails의 message ID). m365_list_emails의 Microsoft 365 message ID에는 m365_read_email을 사용하세요. 모든 계정을 검색하지 않고 한 계정만 대상으로 조회하도록 account=(알고 있다면 mailbox=도 함께, 둘 다 list_emails/search_emails에서 가져옴)를 전달하세요. 병렬이 아니라 순차적으로 호출하세요. 동시 호출은 Mail.app의 JXA lock 뒤에서 직렬화되어 이후 호출이 time out됩니다. 성능: body 가져오기가 주된 지연 요인입니다(느린 IMAP에서 평균 20s). 본문을 건너뛰고 메타데이터만 빠르게 받으려면 include_body=false를 전달하세요. HTML 제거 후 본문을 N자로 제한하려면 max_body_chars=N을 전달하세요(기본값 30000, 0=unlimited). 가져오기에 2s 넘게 걸리면 응답에 body_fetch_ms가 포함되고, 건너뛰면 body_omitted=true, 잘리면 body_truncated_at=N이 포함됩니다. 본문이 이 Mac에 캐시되지 않았으면 read_email은 Mail이 본문을 가져오게 하지 않고 메타데이터와 body_omitted=true 및 body_omit_reason="not_downloaded"(iCloud/IMAP optimized storage)를 반환합니다. 본문 가져오기는 느리고 Mail을 점유할 수 있습니다. 사용자가 그래도 원하면 force_download=true로 다시 시도하여 Mail이 지금 IMAP으로 본문을 가져와 반환하게 하세요(최대 약 60s 대기). 기본값은 꺼짐이며 Mail이 cooldown 상태이면 무시됩니다.

필수 입력

• message_id

입력 이름은 도구가 요구하는 정확한 형태로 유지됩니다. 영문 정식 기술 정의는 아래 펼칠 수 있는 스키마에 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 없습니다. 이는 무단 작업을 허용하지 않습니다. 효과를 검토하고 승인을 받으세요.

• 이 플랫폼에서는 사용자가 승인한 앱, 계정 및 리소스만 사용하세요. 연결 및 권한 요구 사항은 이 도구의 플랫폼별 설명을 참조하세요. 이 카탈로그는 추가 OAuth 범위나 OS 권한이 있다고 주장하지 않습니다.

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

문서 예시

read_email 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.

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