save_attachment

macOS

Zweck

Speichert einen Anhang einer E-Mail auf der Festplatte. Erfordert confirm=true; Ohne diese Funktion erhalten Sie eine Vorschau, wohin die Datei geschrieben würde. Übergeben Sie account= (und mailbox=, falls bekannt, beide von list_emails/search_emails), damit die Suche auf ein Konto abzielt, anstatt alle zu scannen.

Erforderliche Eingaben

• message_id
• attachment_name

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

• Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

{
  "properties": {
    "account": {
      "description": "Mail.app account the message lives in (returned alongside the id). Passing it skips searching the other accounts.",
      "type": "string"
    },
    "attachment_name": {
      "description": "File name of the attachment as it appears in the message.",
      "type": "string"
    },
    "confirm": {
      "default": "false",
      "description": "Set to true to actually write the file. Without it you get a preview of where it would be written. Defaults to false.",
      "type": "boolean"
    },
    "destination": {
      "default": "~/Downloads",
      "description": "Folder to write the file into. Defaults to ~/Downloads.",
      "type": "string"
    },
    "mailbox": {
      "description": "Folder the message lives in (returned alongside the id). Passing it skips searching the other folders.",
      "type": "string"
    },
    "message_id": {
      "description": "The message id of the email that carries the attachment, from list_emails or search_emails. Accepts the bare id or the <angle-bracketed> form.",
      "type": "string"
    }
  },
  "required": [
    "message_id",
    "attachment_name"
  ],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für save_attachment. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

{
  "attachment_name": "launch-checklist.pdf",
  "confirm": false,
  "message_id": "demo-message-001"
}