Saltar al contenido
Todas las herramientas

m365_save_attachment

Microsoft 365 · 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.

Windows

Propósito

Guarda los adjuntos de un correo de Microsoft 365 en una carpeta: todos, o uno por attachment_id (los ids que lista m365_read_email). Si un adjunto reemplaza un archivo del mismo nombre, LMCP guarda antes una copia de ese archivo (en su carpeta de copias de seguridad) y la respuesta dice dónde. Un elemento de Outlook adjunto o un enlace a un archivo en la nube no es un archivo: no se guarda, y la respuesta lo dice. Para el Outlook clásico, usa outlook_save_attachment.

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"
    },
    "attachment_id": {
      "description": "Save only this attachment (an id m365_read_email lists). Omit it to save all of them.",
      "type": "string"
    },
    "confirm": {
      "description": "Ignored; kept for older clients.",
      "type": "boolean"
    },
    "id": {
      "description": "The email message ID from m365_list_emails, m365_search_emails or m365_read_email",
      "type": "string"
    },
    "path": {
      "description": "Folder to save the attachments to",
      "type": "string"
    }
  },
  "required": [
    "id",
    "path"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para m365_save_attachment. 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.

{
  "confirm": false,
  "id": "demo-item-001",
  "path": "C:\\Users\\demo\\Documents\\Attachments"
}