Modifier un brouillon de courriel

Nom de l'outilupdate_email_draft
ÉcritureDestructifIdempotent

Description

Texte exact envoyé au modèle par tools/list :

Modifie un brouillon de courriel : destinataires, objet, message, type, boîte d'envoi. Seuls les champs fournis changent ; le message remplace celui écrit par ces outils, la signature et le message cité restent. Avant l'appel, annoncer précisément la modification et attendre l'accord de l'utilisateur. Seul un brouillon que l'utilisateur a créé change ; rien n'est envoyé (prepare_email_send puis send_email).

Accès requis

Paramètres

NomTypePrésenceDescription
emailIdintegerobligatoireBrouillon (champ id de create_email_draft).
tostringfacultatifDestinataires, qui remplacent les actuels. Adresses séparées par des virgules ; les reprendre des tiers (search_tiers, get_tiers) ou du personnel plutôt que les deviner.
ccstringfacultatifCopie, qui remplace l'actuelle ; chaîne vide pour la vider.
bccstringfacultatifCopie cachée, qui remplace l'actuelle ; chaîne vide pour la vider.
subjectstringfacultatifNouvel objet.
bodystringfacultatifNouveau message, en texte simple.
typestringfacultatifType de courriel, par son nom (availableTypes du brouillon).
fromGeneralMailboxbooleanfacultatifVrai : boîte générale de la société ; faux : boîte de l'utilisateur.

Résultat

Le résultat est renvoyé en contenu structuré (structuredContent), conforme au schéma de sortie ci-dessous, et en texte JSON pour les clients qui ne lisent pas le contenu structuré. Une erreur est renvoyée avec isError: true et un message en français qui explique quoi corriger.

Champs du résultat
NomTypePrésenceDescription
idintegerIdentifiant du brouillon (emailId des autres outils).
fromstringpeut être nullBoîte d'envoi : celle de l'utilisateur ou la boîte générale de la société.
tostringpeut être nullDestinataires.
ccstringpeut être nullDestinataires en copie.
bccstringpeut être nullDestinataires en copie cachée.
subjectstringpeut être nullObjet.
typestringpeut être nullType de courriel (obligatoire pour l'envoi).
dossierIdintegerpeut être nullDossier lié.
bodystringpeut être nullCorps du courriel en texte (signature et message cité compris), tronqué s'il est long.
attachmentsobject[]Pièces jointes.
attachments[].documentIdintegerIdentifiant du document (à passer à read_document ou get_document_download_link).
attachments[].namestringpeut être nullNom du fichier.
attachments[].contentTypestringpeut être nullType MIME.
attachments[].sizeBytesintegerTaille en octets.
attachments[].isInlinebooleanVrai pour une image intégrée au corps (logo, signature).
sendsDocumentstringpeut être nullDevis, facture ou note de crédit qu'envoie ce courriel (une facture ou une note de crédit passe au statut Envoyé à l'envoi, sauf facture déjà payée), ou vide.
availableTypesstring[]Types de courriel proposés (paramètre type), hors commandes fournisseur.

Annotations MCP

AnnotationValeurSignification
titleModifier un brouillon de courrielNom lisible affiché par le client MCP.
readOnlyHintnonL'outil ne modifie rien.
destructiveHintouiL'outil peut modifier ou supprimer des données existantes, ou déclencher une action irréversible.
idempotentHintouiRappeler l'outil avec les mêmes arguments n'a pas d'effet supplémentaire.
openWorldHintnonL'outil lit des courriels ou le contenu d'un document, ou contacte un service extérieur.

Définition JSON

Entrée exacte de tools/list
{
  "name": "update_email_draft",
  "title": "Modifier un brouillon de courriel",
  "description": "Modifie un brouillon de courriel : destinataires, objet, message, type, boîte d'envoi. Seuls les champs fournis changent ; le message remplace celui écrit par ces outils, la signature et le message cité restent. Avant l'appel, annoncer précisément la modification et attendre l'accord de l'utilisateur. Seul un brouillon que l'utilisateur a créé change ; rien n'est envoyé (prepare_email_send puis send_email).",
  "inputSchema": {
    "type": "object",
    "properties": {
      "emailId": {
        "description": "Brouillon (champ id de create_email_draft).",
        "type": "integer"
      },
      "to": {
        "description": "Destinataires, qui remplacent les actuels. Adresses séparées par des virgules ; les reprendre des tiers (search_tiers, get_tiers) ou du personnel plutôt que les deviner.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "cc": {
        "description": "Copie, qui remplace l'actuelle ; chaîne vide pour la vider.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "bcc": {
        "description": "Copie cachée, qui remplace l'actuelle ; chaîne vide pour la vider.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "subject": {
        "description": "Nouvel objet.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "body": {
        "description": "Nouveau message, en texte simple.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "type": {
        "description": "Type de courriel, par son nom (availableTypes du brouillon).",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "fromGeneralMailbox": {
        "description": "Vrai : boîte générale de la société ; faux : boîte de l'utilisateur.",
        "type": [
          "boolean",
          "null"
        ],
        "default": null
      }
    },
    "required": [
      "emailId"
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "id": {
        "description": "Identifiant du brouillon (emailId des autres outils).",
        "type": "integer"
      },
      "from": {
        "description": "Boîte d'envoi : celle de l'utilisateur ou la boîte générale de la société.",
        "type": [
          "string",
          "null"
        ]
      },
      "to": {
        "description": "Destinataires.",
        "type": [
          "string",
          "null"
        ]
      },
      "cc": {
        "description": "Destinataires en copie.",
        "type": [
          "string",
          "null"
        ]
      },
      "bcc": {
        "description": "Destinataires en copie cachée.",
        "type": [
          "string",
          "null"
        ]
      },
      "subject": {
        "description": "Objet.",
        "type": [
          "string",
          "null"
        ]
      },
      "type": {
        "description": "Type de courriel (obligatoire pour l'envoi).",
        "type": [
          "string",
          "null"
        ]
      },
      "dossierId": {
        "description": "Dossier lié.",
        "type": [
          "integer",
          "null"
        ]
      },
      "body": {
        "description": "Corps du courriel en texte (signature et message cité compris), tronqué s'il est long.",
        "type": [
          "string",
          "null"
        ]
      },
      "attachments": {
        "description": "Pièces jointes.",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "documentId": {
              "description": "Identifiant du document (à passer à read_document ou get_document_download_link).",
              "type": "integer"
            },
            "name": {
              "description": "Nom du fichier.",
              "type": [
                "string",
                "null"
              ]
            },
            "contentType": {
              "description": "Type MIME.",
              "type": [
                "string",
                "null"
              ]
            },
            "sizeBytes": {
              "description": "Taille en octets.",
              "type": "integer"
            },
            "isInline": {
              "description": "Vrai pour une image intégrée au corps (logo, signature).",
              "type": "boolean"
            }
          },
          "required": [
            "documentId",
            "sizeBytes",
            "isInline"
          ]
        }
      },
      "sendsDocument": {
        "description": "Devis, facture ou note de crédit qu'envoie ce courriel (une facture ou une note de crédit passe au statut Envoyé à l'envoi, sauf facture déjà payée), ou vide.",
        "type": [
          "string",
          "null"
        ]
      },
      "availableTypes": {
        "description": "Types de courriel proposés (paramètre type), hors commandes fournisseur.",
        "type": "array",
        "items": {
          "type": "string"
        }
      }
    },
    "required": [
      "id"
    ]
  },
  "annotations": {
    "title": "Modifier un brouillon de courriel",
    "destructiveHint": true,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  }
}