create_draft

メール · macOS

効果: 書き込み. 状態: 条件付き提供.

「条件付き提供」は、バージョン、プラットフォーム、権限、アカウント、設定に依存する可能性を示し、すべての環境で有効という意味ではありません。

macOS

目的

ユーザーが確認して手動送信できるよう、メールを Mail.app の Drafts フォルダに保存します。自動送信は決して行いません。`to`/`subject` と `body` または `html_body` を指定して新規下書きを作成するか、`reply_to_message_id`、`reply_all`、`body` または `html_body` を指定してネイティブな返信として保存します。応答には Drafts メールボックス名と件名が含まれます。返信下書きでは、`threaded`: true は保存後に読み戻し、ヘッダーが元のメッセージを参照している（会話内に表示される）ことを意味します。false はスレッド化ヘッダーなしで保存されたことを意味するため、警告をユーザーへ伝えてください。「unconfirmed」は時間内に読み戻せなかったこと（Exchange の同期遅延など）を意味します。複数アカウントがある Mac では、`account`（list_email_accounts が返すアカウント名）または `from`（送信者アドレス）を指定すると、そのアカウントの Drafts に保存されます。省略時は既定のアカウントです。`attachments` にカンマ区切りの絶対ファイルパス（PDF 見積書など）を渡してファイルを添付できます。AI に文章作成を任せつつ送信は自分で行いたい慎重なユーザー向けです。実際に保存するには confirm=true が必要で、省略時は Mail.app を変更せずプレビューを返します。

必須入力

このプラットフォームのスキーマには必須入力が宣言されていません。任意の選択項目や実行要件が存在する場合があります。

権限と確認

スキーマには明示的な確認パラメータがあります。プレビューを確認し、プラットフォーム契約に従って実操作を承認してください。

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

英語の正規技術スキーマ — macOS

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

ドキュメント例

create_draft のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

{
  "body": "Can we review the launch checklist on Tuesday?",
  "confirm": false,
  "subject": "Planning meeting",
  "to": "[email protected]"
}