Перейти к содержимому
Все инструменты

m365_create_draft

Microsoft 365 · macOS · Windows

Эффект: запись. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Используйте, когда пользователю нужно подготовить письмо в его аккаунте Microsoft 365 / Outlook, не отправляя его: сохраняет черновик в папке Drafts этого аккаунта, чтобы человек проверил и отправил его из Outlook. Ничего не отправляет. Новое сообщение принимает subject и body (to и cc необязательны); черновик ответа принимает только reply_to_id (ID сообщения из m365_list_emails, m365_search_emails или m365_read_email) и body — его получатели и тема берутся из оригинала. Сначала показывает предпросмотр — установите confirm=true, чтобы сохранить черновик; двойное подтверждение сохраняет два черновика. Без вложений. Нужен подключённый аккаунт Microsoft 365 с разрешением Mail.ReadWrite: аккаунт, подключённый до появления этого инструмента, отвечает consent_required, пока не будет подключён заново. Чтобы отправить сразу, используйте m365_send_email или m365_reply_email; для черновика в приложении «Почта» на Mac — create_draft.

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

Имена сохранены в точности как их требует инструмент. Канонические технические определения на английском находятся в раскрываемой схеме ниже.

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

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

Каноническая техническая схема на английском — macOS
{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "body": {
      "description": "The text of the draft, as plain text. Line breaks are kept.",
      "type": "string"
    },
    "cc": {
      "description": "CC email addresses, separated by commas (optional; not with reply_to_id).",
      "type": "string"
    },
    "confirm": {
      "description": "Set to true to save the draft (default: shows a preview only). Nothing is sent in either case.",
      "type": "boolean"
    },
    "reply_to_id": {
      "description": "Message ID to draft a reply to (from m365_list_emails, m365_search_emails or m365_read_email). Leave it out for a new message.",
      "type": "string"
    },
    "subject": {
      "description": "Subject, one line. Required for a new message; not with reply_to_id.",
      "type": "string"
    },
    "to": {
      "description": "Recipient email addresses, separated by commas (optional; not with reply_to_id).",
      "type": "string"
    }
  },
  "required": [
    "body"
  ],
  "type": "object"
}

Пример для документации

Пример документации для m365_create_draft. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

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

Windows

Назначение

Создаёт ЧЕРНОВИК письма в папке Drafts вашего аккаунта Microsoft 365, чтобы вы сами проверили и отправили его. Никогда не отправляет. Сначала показывает предпросмотр — установите confirm=true, чтобы создать черновик; двойное подтверждение создаёт два черновика. С reply_to_id черновик становится ответом на это сообщение и сохраняет его получателей и тему (to, cc и subject не указывайте). Аккаунт, подключённый до появления этого инструмента, нужно подключить заново (connect_m365_account), чтобы разрешить черновики.

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

Имена сохранены в точности как их требует инструмент. Канонические технические определения на английском находятся в раскрываемой схеме ниже.

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

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

Каноническая техническая схема на английском — Windows
{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "body": {
      "description": "The text of the draft, as plain text. Line breaks are kept.",
      "type": "string"
    },
    "cc": {
      "description": "CC recipients (optional, comma-separated)",
      "type": "string"
    },
    "confirm": {
      "description": "Set to true to create the draft (default: shows preview only)",
      "type": "boolean"
    },
    "reply_to_id": {
      "description": "Message ID to draft a reply to (optional)",
      "type": "string"
    },
    "subject": {
      "description": "Subject. Required unless reply_to_id is given.",
      "type": "string"
    },
    "to": {
      "description": "Recipient email address (comma-separated for multiple). Optional: a draft may have no recipient yet.",
      "type": "string"
    }
  },
  "required": [
    "body"
  ],
  "type": "object"
}

Пример для документации

Пример документации для m365_create_draft. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

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