Aller au contenu
Tous les outils

m365_create_draft

Microsoft 365 · macOS · Windows

Effet: écriture. État: disponibilité conditionnelle.

«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.

macOS

Objectif

À utiliser lorsque l’utilisateur veut qu’un e-mail soit préparé dans son compte Microsoft 365 / Outlook sans l’envoyer : il enregistre un brouillon dans le dossier Brouillons de ce compte, que la personne relit et envoie depuis Outlook. N’envoie jamais rien. Un nouveau message prend subject et body (to et cc facultatifs) ; un brouillon de réponse prend reply_to_id (un ID de message issu de m365_list_emails, m365_search_emails ou m365_read_email) et body uniquement — ses destinataires et son objet viennent de l’original. Affiche d’abord un aperçu — définissez confirm=true pour enregistrer le brouillon ; confirmer deux fois enregistre deux brouillons. Pas de pièces jointes. Nécessite un compte Microsoft 365 connecté avec l’autorisation Mail.ReadWrite : un compte connecté avant l’existence de cet outil répond consent_required jusqu’à sa reconnexion. Pour envoyer tout de suite, utilisez m365_send_email ou m365_reply_email ; pour un brouillon dans l’app Mail du Mac, utilisez create_draft.

Entrées requises

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.

Schéma technique canonique en anglais — 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"
}

Exemple documentaire

Exemple de documentation pour m365_create_draft. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

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

Windows

Objectif

Crée un BROUILLON d’e-mail dans le dossier Brouillons de votre compte Microsoft 365, que vous relisez et envoyez vous-même. Il n’envoie jamais. Affiche d’abord un aperçu — définissez confirm=true pour créer le brouillon ; confirmer deux fois crée deux brouillons. Avec reply_to_id, le brouillon est une réponse à ce message et conserve ses destinataires et son objet (omettez to, cc et subject). Un compte connecté avant l’existence de cet outil doit être reconnecté (connect_m365_account) pour autoriser les brouillons.

Entrées requises

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.

Schéma technique canonique en anglais — 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"
}

Exemple documentaire

Exemple de documentation pour m365_create_draft. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

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