Vai al contenuto
Tutti gli strumenti

m365_create_draft

Microsoft 365 · macOS · Windows

Effetto: scrittura. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Da usare quando l'utente vuole preparare un'email nel suo account Microsoft 365 / Outlook senza inviarla: salva una bozza nella cartella Bozze di quell'account, perché la persona la riveda e la invii da Outlook. Non invia mai nulla. Un nuovo messaggio richiede subject e body (to e cc facoltativi); una bozza di risposta richiede reply_to_id (un ID messaggio da m365_list_emails, m365_search_emails o m365_read_email) e solo body: destinatari e oggetto provengono dall'originale. Mostra prima un'anteprima: imposta confirm=true per salvare la bozza; confermando due volte si salvano due bozze. Nessun allegato. Richiede un account Microsoft 365 collegato con il permesso Mail.ReadWrite: un account collegato prima che esistesse questo strumento risponde consent_required finché non viene collegato di nuovo. Per inviare subito usa m365_send_email o m365_reply_email; per una bozza nell'app Mail del Mac usa create_draft.

Input obbligatori

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per m365_create_draft. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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

Windows

Scopo

Crea una BOZZA di email nella cartella Bozze del tuo account Microsoft 365, perché tu la rivedi e la invii da te. Non invia mai. Mostra prima un'anteprima: imposta confirm=true per creare la bozza; confermando due volte si creano due bozze. Con reply_to_id la bozza è una risposta a quel messaggio e ne mantiene destinatari e oggetto (ometti to, cc e subject). Un account collegato prima che esistesse questo strumento deve essere collegato di nuovo (connect_m365_account) per consentire le bozze.

Input obbligatori

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per m365_create_draft. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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