create_draft

macOS

Zweck

Speichert eine E-Mail im Ordner „Mail.app-Entwürfe“, 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 eine native Antwort mit „reply_to_message_id“, „reply_all“ und „body“ oder `html_body`; Die Antwort nennt das Drafts-Postfach und subject. Die Antwort eines Antwortentwurfs enthält „threaded“: „true“ bedeutet, dass der gespeicherte Entwurf zurückgelesen wurde und seine Kopfzeilen auf die Quellnachricht verweisen (sie wird in der Konversation angezeigt); false bedeutet, dass WITHOUT-Threading-Header gespeichert wurden (die Warnung to an den Benutzer weiterleiten); „unbestätigt“ bedeutet, dass es nicht rechtzeitig zurückgelesen werden konnte (z. B. Exchange-Synchronisierungsverzögerung). Übergeben Sie auf einem Multi-account-Mac „account“ (einen account-Namen, from list_email_accounts) oder „from“ (eine Absenderadresse). to platzieren Sie den Entwurf in den Entwürfen dieses account; andernfalls landet es im Standardwert account. Hängen Sie Dateien an, indem Sie „attachments“ übergeben (durch Kommas getrennte absolute Dateipfade, z. B. ein PDF-Zitat) – sie werden an den gespeicherten Entwurf angehängt. Verwenden Sie dies für den vorsichtigen Benutzer, der E-Mails mithilfe einer KI verfassen möchte, diese aber unbedingt selbst versenden möchte. Erfordert confirm=true to tatsächliches Speichern – ohne touching Mail.app wird eine Vorschau zurückgegeben.

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. 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": "[email protected]"
}