Tutti gli strumenti

create_draft

E-mail · macOS

Effetto: scrittura. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Salva un'e-mail to nella cartella Bozze di Mail.app per la revisione e l'invio manuale dell'utente to: non viene mai inviata. Componi una nuova bozza con `to`/`subject` e `body` o `html_body` oppure salva una risposta nativa con `reply_to_message_id`, `reply_all` e `body` o `html_body`; la risposta denomina la casella di posta Bozze e subject. La risposta di una bozza di risposta include `threaded`: true significa che la bozza salvata è stata letta e le sue intestazioni fanno riferimento al messaggio di origine (apparirà all'interno della conversazione); false significa che ha salvato le intestazioni del threading WITHOUT (trasmette l'avviso to all'utente); "Non confermato" significa che non è stato possibile rileggerlo nel tempo (ad esempio, ritardo di sincronizzazione di Exchange). Su un Mac multi-account, passa `account` (un nome account from list_email_accounts) o `from` (un indirizzo mittente) to inserisci la bozza nelle Bozze di account; altrimenti arriva allo account predefinito. Allega file passando `attachments` (percorsi di file assoluti separati da virgole, ad esempio una citazione PDF) — vengono allegati to alla bozza salvata. Usalo per l'utente cauto che desidera la posta composta dall'intelligenza artificiale ma insiste per inviarla da solo. Richiede confirm=true to salvalo effettivamente: senza di esso, restituisce un'anteprima senza touching 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.

Schema tecnico canonico in inglesemacOS
{
  "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. 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": "[email protected]"
}