create_draft

이메일 · macOS

효과: 쓰기. 상태: 조건부 제공.

‘조건부 제공’은 도구가 버전, 플랫폼, 권한, 계정 또는 설정에 따라 달라질 수 있음을 뜻하며 모든 설치에서 활성화되었다는 의미는 아닙니다.

macOS

목적

사용자가 검토하고 직접 보내도록 이메일을 Mail.app의 임시 보관함에 저장하며 절대 전송하지 않습니다. `to`/`subject`와 `body` 또는 `html_body`로 새 초안을 작성하거나, `reply_to_message_id`, `reply_all`, 그리고 `body` 또는 `html_body`로 답장 초안을 저장합니다. 응답에는 제목이 표시되며, Mail이 저장된 초안을 다시 보여 주면 초안이 들어간 사서함(새 초안은 `mailbox`, 답장은 `draft_mailbox`)과 현재 메시지 id도 표시됩니다. Mail이 아직 보여 주지 않았으면 사서함은 표시되지 않습니다. 답장 초안에는 작성한 텍스트 뒤에 원본의 일반 텍스트 인용("On <date>, <sender> wrote:"와, 원본의 각 줄 앞에 `> `를 붙인 것)이 들어가며, Mail의 스타일이 적용된 인용이 아닙니다. 답장 초안에서 `html_body`는 일반 텍스트로 변환됩니다. 응답의 `quoted_original`은 인용이 있으면 true이고, 원본에 읽을 수 있는 텍스트가 없으면 안내와 함께 false입니다. 답장 초안의 응답에는 `threaded`가 포함됩니다. true는 저장된 초안을 다시 읽었고 헤더가 원본 메시지를 참조하여 대화 안에 표시된다는 뜻입니다. false는 스레딩 헤더 없이 저장되었다는 뜻이므로 사용자에게 경고를 전달하세요. "unconfirmed"는 Exchange 동기화 지연 등으로 제때 다시 읽지 못했다는 뜻입니다. 여러 계정을 사용하는 Mac에서는 `account`(list_email_accounts의 계정 이름) 또는 `from`(발신자 주소)을 전달해 해당 계정의 임시 보관함에 초안을 넣을 수 있으며, 그렇지 않으면 기본 계정에 저장됩니다. `attachments`(쉼표로 구분한 절대 파일 경로, 예: 견적서 PDF)를 전달해 파일을 첨부하면 저장된 초안에 첨부됩니다. AI가 작성한 메일을 원하지만 전송은 직접 하려는 신중한 사용자를 위한 기능입니다. 실제로 저장하려면 confirm=true가 필요하며, 없으면 Mail.app을 건드리지 않고 미리보기를 반환합니다.

필수 입력

이 플랫폼의 스키마에는 필수 입력이 선언되어 있지 않습니다. 선택 항목이나 실행 요구 사항은 여전히 있을 수 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 있습니다. 미리보기를 검토하고 플랫폼 계약에 따라 실제 작업을 승인하세요.

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

영문 정식 기술 스키마 — macOS

{
  "properties": {
    "account": {
      "description": "Account name (from list_email_accounts) whose Drafts folder receives the draft. Alternative to `from`.",
      "type": "string"
    },
    "attachments": {
      "description": "Files to attach, as comma-separated absolute paths (e.g. a PDF).",
      "type": "string"
    },
    "bcc": {
      "description": "BCC address(es), comma-separated.",
      "type": "string"
    },
    "body": {
      "description": "Plain-text body of the draft.",
      "type": "string"
    },
    "cc": {
      "description": "CC address(es), comma-separated.",
      "type": "string"
    },
    "confirm": {
      "default": "false",
      "description": "Must be true to actually save the draft. Without it, returns a preview of the recipient/sender, subject, and that the body will be saved.",
      "type": "boolean"
    },
    "from": {
      "description": "Sender address — on a multi-account Mac, selects which account's Drafts to use. Alternative to `account`.",
      "type": "string"
    },
    "html_body": {
      "description": "HTML body of the draft. Takes precedence over `body` when both are given.",
      "type": "string"
    },
    "reply_all": {
      "default": "false",
      "description": "For a reply draft, include all original recipients (reply-all) instead of just the sender.",
      "type": "boolean"
    },
    "reply_to_message_id": {
      "description": "Message id (from list_emails/search_emails) to draft a reply to, instead of a new message.",
      "type": "string"
    },
    "subject": {
      "description": "Subject line for a new draft. Ignored for reply drafts (they inherit the original subject).",
      "type": "string"
    },
    "to": {
      "description": "Recipient address(es) for a new draft, comma-separated. May be left empty: the draft is saved without a recipient, to be added in Mail. Omit for a reply draft (uses reply_to_message_id).",
      "type": "string"
    }
  },
  "type": "object"
}

문서 예시

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

{
  "body": "Can we review the launch checklist on Tuesday?",
  "confirm": false,
  "subject": "Planning meeting",
  "to": "alex@example.com"
}