create_draft

macOS

Finalidade

Salva um e-mail na pasta Rascunhos do Mail.app para o usuário revisar e enviar manualmente; nunca envia. Componha um novo rascunho com `to`/`subject` e `body` ou `html_body`, ou salve um rascunho de resposta com `reply_to_message_id`, `reply_all` e `body` ou `html_body`; a resposta informa o assunto e, assim que o Mail mostra de volta o rascunho salvo, a caixa de correio em que ele foi parar (`mailbox` para um novo rascunho, `draft_mailbox` para uma resposta) e seu id de mensagem atual; quando o Mail ainda não o mostrou, nenhuma caixa de correio é informada. Um rascunho de resposta contém seu texto seguido de uma citação em texto simples do original ("On <date>, <sender> wrote:" e as linhas do original precedidas por `> `), não a citação estilizada do Mail, e em um rascunho de resposta `html_body` é convertido em texto simples. `quoted_original` na resposta é true quando a citação está presente; é false, com uma observação, quando o original não tem texto legível. A resposta de um rascunho de resposta inclui `threaded`: true significa que o rascunho salvo foi lido de volta e seus cabeçalhos referenciam a mensagem de origem (ele aparecerá dentro da conversa); false significa que foi salvo SEM os cabeçalhos de conversa (repasse o aviso ao usuário); "unconfirmed" significa que não foi possível lê-lo de volta a tempo (por exemplo, atraso de sincronização do Exchange). Em um Mac com várias contas, passe `account` (um nome de conta de list_email_accounts) ou `from` (um endereço de remetente) para colocar o rascunho nos Rascunhos dessa conta; caso contrário, ele vai para a conta padrão. Anexe arquivos passando `attachments` (caminhos de arquivo absolutos separados por vírgula, por exemplo, uma cotação em PDF); eles são anexados ao rascunho salvo. Use-o para o usuário cauteloso que quer e-mails redigidos por IA, mas insiste em enviá-los ele mesmo. Requer confirm=true para realmente salvar; sem ele, retorna uma prévia sem tocar no Mail.app.

Entradas obrigatórias

O esquema desta plataforma não declara entradas obrigatórias. Ainda podem existir seletores opcionais ou requisitos de execução.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

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

Exemplo documental

Exemplo de documentação para create_draft. 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.

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