Lien de téléchargement d'un document

Nom de l'outilget_document_download_link
Lecture seule

Description

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

Renvoie un lien de téléchargement direct, en lecture seule et valable quelques minutes, vers le fichier d'un document d'un dossier ou d'une pièce jointe de courriel. À n'appeler que si l'utilisateur veut le fichier, et à lui transmettre tel quel.

Accès requis

Paramètres

NomTypePrésenceDescription
documentIdintegerobligatoireIdentifiant du document (champ id de list_dossier_documents ou documentId d'une pièce jointe de get_email).

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
documentIdintegerIdentifiant du document.
namestringpeut être nullNom du fichier.
urlstringLien de téléchargement direct, en lecture seule. À transmettre tel quel à l'utilisateur ; il expire à expiresAt.
expiresAtstring (date-time)Fin de validité du lien (UTC).

Annotations MCP

AnnotationValeurSignification
titleLien de téléchargement d'un documentNom lisible affiché par le client MCP.
readOnlyHintouiL'outil ne modifie rien.
destructiveHintnonL'outil peut modifier ou supprimer des données existantes, ou déclencher une action irréversible.
idempotentHintnonRappeler 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": "get_document_download_link",
  "title": "Lien de téléchargement d'un document",
  "description": "Renvoie un lien de téléchargement direct, en lecture seule et valable quelques minutes, vers le fichier d'un document d'un dossier ou d'une pièce jointe de courriel. À n'appeler que si l'utilisateur veut le fichier, et à lui transmettre tel quel.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "documentId": {
        "description": "Identifiant du document (champ id de list_dossier_documents ou documentId d'une pièce jointe de get_email).",
        "type": "integer"
      }
    },
    "required": [
      "documentId"
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "documentId": {
        "description": "Identifiant du document.",
        "type": "integer"
      },
      "name": {
        "description": "Nom du fichier.",
        "type": [
          "string",
          "null"
        ]
      },
      "url": {
        "description": "Lien de téléchargement direct, en lecture seule. À transmettre tel quel à l'utilisateur ; il expire à expiresAt.",
        "type": "string"
      },
      "expiresAt": {
        "description": "Fin de validité du lien (UTC).",
        "type": "string",
        "format": "date-time"
      }
    },
    "required": [
      "documentId",
      "url",
      "expiresAt"
    ]
  },
  "annotations": {
    "title": "Lien de téléchargement d'un document",
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false,
    "readOnlyHint": true
  }
}