create_draft

macOS

Назначение

Сохраняет электронное письмо в папке Drafts приложения Mail.app, чтобы пользователь мог проверить и отправить его вручную, — сам инструмент письмо никогда не отправляет. Создайте новый черновик с `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; файлы будут добавлены к сохраненному черновику. Используйте инструмент для осторожного пользователя, который хочет получить составленное ИИ письмо, но настаивает на самостоятельной отправке. Для фактического сохранения требуется confirm=true; без него возвращается предварительный просмотр без изменений в Mail.app.

Обязательные входные данные

Схема этой платформы не объявляет обязательных входных данных. Необязательные селекторы или требования среды всё же могут применяться.

Разрешения и подтверждение

Схема объявляет явный параметр подтверждения. Проверьте предварительный результат и разрешите реальную операцию согласно контракту платформы.

• Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

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