create_draft

macOS

Zweck

Speichert eine E-Mail im Ordner „Entwürfe“ von Mail.app, damit der Benutzer sie überprüfen und manuell senden kann – sie wird nie gesendet. Verfassen Sie einen neuen Entwurf mit `to`/`subject` und `body` oder `html_body`, oder speichern Sie einen Antwortentwurf mit `reply_to_message_id`, `reply_all` und `body` oder `html_body`; die Antwort nennt den Betreff und, sobald Mail den gespeicherten Entwurf wieder anzeigt, das Postfach, in dem er gelandet ist (`mailbox` bei einem neuen Entwurf, `draft_mailbox` bei einer Antwort), sowie seine aktuelle Nachrichten-ID; hat Mail ihn noch nicht angezeigt, wird kein Postfach genannt. Ein Antwortentwurf enthält Ihren Text gefolgt von einem Nur-Text-Zitat der Originalnachricht ("On <date>, <sender> wrote:" und die Zeilen des Originals mit dem Präfix `> `), nicht das formatierte Zitat von Mail, und in einem Antwortentwurf wird `html_body` in Nur-Text umgewandelt. `quoted_original` in der Antwort ist true, wenn das Zitat vorhanden ist; es ist false, mit einem Hinweis, wenn das Original keinen lesbaren Text hat. Die Antwort eines Antwortentwurfs enthält `threaded`: true bedeutet, dass der gespeicherte Entwurf zurückgelesen wurde und seine Kopfzeilen auf die Quellnachricht verweisen (er erscheint innerhalb der Konversation); false bedeutet, dass er OHNE Threading-Kopfzeilen gespeichert wurde (geben Sie die Warnung an den Benutzer weiter); "unconfirmed" bedeutet, dass er nicht rechtzeitig zurückgelesen werden konnte (z. B. Exchange-Synchronisierungsverzögerung). Übergeben Sie auf einem Mac mit mehreren Konten `account` (ein Kontoname aus list_email_accounts) oder `from` (eine Absenderadresse), um den Entwurf im Ordner „Entwürfe“ dieses Kontos abzulegen; andernfalls landet er im Standardkonto. Hängen Sie Dateien an, indem Sie `attachments` übergeben (durch Kommas getrennte absolute Dateipfade, z. B. ein PDF-Angebot) – sie werden an den gespeicherten Entwurf angehängt. Verwenden Sie dies für vorsichtige Benutzer, die E-Mails mithilfe einer KI verfassen lassen möchten, sie aber unbedingt selbst senden wollen. Erfordert confirm=true, um tatsächlich zu speichern – ohne diesen Parameter wird eine Vorschau zurückgegeben, ohne Mail.app zu berühren.

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

• Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

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

Dokumentationsbeispiel

Dokumentationsbeispiel für create_draft. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

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