Saltar al contenido
Todas las herramientas

m365_create_draft

Microsoft 365 · macOS · Windows

Efecto: escritura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Úsala cuando el usuario quiera dejar preparado un correo en su cuenta de Microsoft 365 / Outlook sin enviarlo: guarda un borrador en la carpeta Borradores de esa cuenta, para que la persona lo revise y lo envíe desde Outlook. Nunca envía nada. Un mensaje nuevo toma subject y body (to y cc opcionales); una respuesta en borrador toma reply_to_id (un ID de mensaje de m365_list_emails, m365_search_emails o m365_read_email) y solo body: sus destinatarios y su asunto vienen del original. Muestra primero una vista previa: establece confirm=true para guardar el borrador; confirmar dos veces guarda dos borradores. Sin adjuntos. Necesita una cuenta de Microsoft 365 conectada con el permiso Mail.ReadWrite: una cuenta conectada antes de que existiera esta herramienta responde consent_required hasta que se vuelva a conectar. Para enviar de inmediato usa m365_send_email o m365_reply_email; para un borrador en la app Mail del Mac usa create_draft.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

Ejemplo de documentación para m365_create_draft. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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

Windows

Propósito

Crea un BORRADOR de correo en la carpeta Borradores de tu cuenta de Microsoft 365, para que lo revises y lo envíes tú mismo. Nunca envía. Muestra primero una vista previa: establece confirm=true para crear el borrador; confirmar dos veces crea dos borradores. Con reply_to_id el borrador es una respuesta a ese mensaje y conserva sus destinatarios y su asunto (omite to, cc y subject). Una cuenta conectada antes de que existiera esta herramienta debe volver a conectarse (connect_m365_account) para permitir borradores.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

Ejemplo de documentación para m365_create_draft. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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