create_draft

macOS

Scopo

Salva un'e-mail nella cartella Bozze di Mail.app affinché l'utente la riveda e la invii manualmente: non la invia mai. Componi una nuova bozza con `to`/`subject` e `body` o `html_body`, oppure salva una bozza di risposta con `reply_to_message_id`, `reply_all` e `body` o `html_body`; la risposta fornisce l'oggetto e, una volta che Mail mostra di nuovo la bozza salvata, la casella in cui è finita (`mailbox` per una nuova bozza, `draft_mailbox` per una risposta) e il suo id messaggio attuale; quando Mail non l'ha ancora mostrata, non viene indicata alcuna casella. Una bozza di risposta contiene il tuo testo seguito da una citazione in testo semplice del messaggio originale ("On <date>, <sender> wrote:" e le righe dell'originale precedute da `> `), non dalla citazione formattata di Mail, e in una bozza di risposta `html_body` viene convertito in testo semplice. `quoted_original` nella risposta è true quando la citazione è presente; è false, con una nota, quando l'originale non ha testo leggibile. La risposta di una bozza di risposta include `threaded`: true significa che la bozza salvata è stata riletta e le sue intestazioni fanno riferimento al messaggio di origine (apparirà all'interno della conversazione); false significa che è stata salvata SENZA intestazioni di threading (riporta l'avviso all'utente); "unconfirmed" significa che non è stato possibile rileggerla in tempo (ad es. ritardo di sincronizzazione di Exchange). Su un Mac con più account, passa `account` (un nome account da list_email_accounts) o `from` (un indirizzo mittente) per collocare la bozza nelle Bozze di quell'account; altrimenti finisce nell'account predefinito. Allega file passando `attachments` (percorsi assoluti separati da virgole, ad es. un preventivo in PDF): vengono allegati alla bozza salvata. Usalo per l'utente prudente che vuole e-mail composte dall'IA ma insiste nell'inviarle personalmente. Richiede confirm=true per salvare davvero: senza di esso restituisce un'anteprima senza toccare Mail.app.

Input obbligatori

Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

• Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.

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

Esempio documentale

Esempio di documentazione per create_draft. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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