create_draft

macOS

Propósito

Guarda un correo electrónico en la carpeta Borradores de Mail.app para que el usuario lo revise y lo envíe manualmente; nunca lo envía. Redacta un borrador nuevo con `to`/`subject` y `body` o `html_body`, o guarda una respuesta nativa con `reply_to_message_id`, `reply_all` y `body` o `html_body`; la respuesta indica el buzón de Borradores y el asunto. La respuesta de un borrador de contestación incluye `threaded`: `threaded: true` significa que se volvió a leer el borrador guardado y que sus encabezados hacen referencia al mensaje de origen (aparecerá dentro de la conversación); `threaded: false` significa que se guardó SIN los encabezados de conversación (comunica la advertencia al usuario); "unconfirmed" significa que no se pudo volver a leer a tiempo (por ejemplo, por un retraso de sincronización de Exchange). En una Mac con varias cuentas, pasa `account` (un nombre de cuenta obtenido de list_email_accounts) o `from` (una dirección de remitente) para colocar el borrador en los Borradores de esa cuenta; de lo contrario, se guarda en la cuenta predeterminada. Para adjuntar archivos, pasa `attachments` (rutas de archivo absolutas separadas por comas, por ejemplo, una cotización en PDF); los archivos se adjuntan al borrador guardado. Úsala cuando el usuario quiera que la IA redacte el correo, pero prefiera enviarlo personalmente. Requiere confirm=true para guardarlo; sin ese argumento, devuelve una vista previa sin modificar Mail.app.

Entradas obligatorias

El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.

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.

• Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

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

Ejemplo documental

Ejemplo de documentación para 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": "[email protected]"
}