Modifier une de mes tâches

Nom de l'outilupdate_my_task
ÉcritureDestructifIdempotent

Description

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

Modifie dans Oxygenius une tâche que l'utilisateur connecté a créée et qui est encore à traiter : contenu, urgence (épinglage), date de planification, destinataire (réaffectation, notifiée) ou type. Seuls les paramètres fournis changent ; le contenu fourni remplace le contenu actuel. Le type doit rester proposé pour le destinataire (list_task_types). L'application refuse de modifier la tâche de quelqu'un d'autre ou une tâche déjà traitée. Avant l'appel, annoncer précisément la modification à l'utilisateur et attendre son accord. Renvoie la tâche à jour.

Accès requis

Paramètres

NomTypePrésenceDescription
taskIdintegerobligatoireIdentifiant de la tâche (champ id de search_tasks, get_my_tasks ou get_task).
descriptionstringfacultatifNouveau contenu, en texte brut (retours à la ligne permis, HTML non interprété). Remplace le contenu actuel.
isUrgentbooleanfacultatifVrai pour marquer la tâche urgente (épinglée), faux pour retirer l'urgence.
scheduledForstring (date)facultatifDate de planification (AAAA-MM-JJ, après aujourd'hui) : la tâche n'est à traiter qu'à partir de ce jour.
removeSchedulebooleanfacultatifVrai pour retirer la planification : la tâche est à traiter tout de suite.
Par défaut : false
assigneeIdintegerfacultatifIdentifiant du nouveau destinataire (champ id de search_users).
taskTypeIdintegerfacultatifIdentifiant du nouveau type de tâche (champ id de list_task_types).

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
stepstringNature de l'étape : creation, reply (réponse) ou transfer (transfert).
threadobject[]Étapes de l'échange (création, réponses, transferts, clôture), par ordre chronologique, la tâche demandée comprise.
thread[].taskIdintegerpeut être nullIdentifiant de la tâche (absent pour une clôture).
thread[].stepstringcreation, reply (réponse), transfer (transfert) ou closure (clôture).
thread[].fromstringpeut être nullAuteur de l'étape.
thread[].tostringpeut être nullDestinataire (absent pour une clôture).
thread[].datestring (date-time)Date de l'étape, en heure locale belge.
thread[].descriptionstringpeut être nullContenu, en texte (tronqué).
idintegerIdentifiant de la tâche (à passer à get_task).
statusstringopen (à traiter), scheduled (planifiée : visible du destinataire à partir de scheduledFor) ou done (traitée : répondue, transférée ou clôturée).
typestringpeut être nullType de tâche (catégorie), ex. Commande, Facturation.
titlestringpeut être nullTitre, rarement renseigné.
descriptionstringpeut être nullContenu de la tâche, en texte (tronqué dans les listes).
isUrgentbooleanVrai pour une tâche urgente (épinglée).
isOverduebooleanVrai pour une tâche à traiter en retard : échéance dépassée, ou sans échéance, créée il y a plus de 5 jours (règle de l'application).
fromstringpeut être nullExpéditeur (« Système (automatique) » pour une tâche créée par un traitement automatique).
tostringpeut être nullDestinataire.
createdAtstring (date-time)Date de création, en heure locale belge avec son décalage UTC.
dueDatestring (date)peut être nullÉchéance (AAAA-MM-JJ), rarement renseignée.
scheduledForstring (date)peut être nullDate à partir de laquelle une tâche planifiée apparaît chez son destinataire (AAAA-MM-JJ).
completedAtstring (date-time)peut être nullDate à laquelle la tâche a été traitée, en heure locale belge.
dossierIdintegerpeut être nullIdentifiant du dossier lié (à passer à get_dossier).
dossierReferencestringpeut être nullRéférence du dossier lié.
dossierIndicationstringpeut être nullIntitulé court du dossier lié.

Annotations MCP

AnnotationValeurSignification
titleModifier une de mes tâchesNom 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_my_task",
  "title": "Modifier une de mes tâches",
  "description": "Modifie dans Oxygenius une tâche que l'utilisateur connecté a créée et qui est encore à traiter : contenu, urgence (épinglage), date de planification, destinataire (réaffectation, notifiée) ou type. Seuls les paramètres fournis changent ; le contenu fourni remplace le contenu actuel. Le type doit rester proposé pour le destinataire (list_task_types). L'application refuse de modifier la tâche de quelqu'un d'autre ou une tâche déjà traitée. Avant l'appel, annoncer précisément la modification à l'utilisateur et attendre son accord. Renvoie la tâche à jour.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "taskId": {
        "description": "Identifiant de la tâche (champ id de search_tasks, get_my_tasks ou get_task).",
        "type": "integer"
      },
      "description": {
        "description": "Nouveau contenu, en texte brut (retours à la ligne permis, HTML non interprété). Remplace le contenu actuel.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "isUrgent": {
        "description": "Vrai pour marquer la tâche urgente (épinglée), faux pour retirer l'urgence.",
        "type": [
          "boolean",
          "null"
        ],
        "default": null
      },
      "scheduledFor": {
        "description": "Date de planification (AAAA-MM-JJ, après aujourd'hui) : la tâche n'est à traiter qu'à partir de ce jour.",
        "type": [
          "string",
          "null"
        ],
        "format": "date",
        "default": null
      },
      "removeSchedule": {
        "description": "Vrai pour retirer la planification : la tâche est à traiter tout de suite.",
        "type": "boolean",
        "default": false
      },
      "assigneeId": {
        "description": "Identifiant du nouveau destinataire (champ id de search_users).",
        "type": [
          "integer",
          "null"
        ],
        "default": null
      },
      "taskTypeId": {
        "description": "Identifiant du nouveau type de tâche (champ id de list_task_types).",
        "type": [
          "integer",
          "null"
        ],
        "default": null
      }
    },
    "required": [
      "taskId"
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "step": {
        "description": "Nature de l'étape : creation, reply (réponse) ou transfer (transfert).",
        "type": "string"
      },
      "thread": {
        "description": "Étapes de l'échange (création, réponses, transferts, clôture), par ordre chronologique, la tâche demandée comprise.",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "taskId": {
              "description": "Identifiant de la tâche (absent pour une clôture).",
              "type": [
                "integer",
                "null"
              ]
            },
            "step": {
              "description": "creation, reply (réponse), transfer (transfert) ou closure (clôture).",
              "type": "string"
            },
            "from": {
              "description": "Auteur de l'étape.",
              "type": [
                "string",
                "null"
              ]
            },
            "to": {
              "description": "Destinataire (absent pour une clôture).",
              "type": [
                "string",
                "null"
              ]
            },
            "date": {
              "description": "Date de l'étape, en heure locale belge.",
              "type": "string",
              "format": "date-time"
            },
            "description": {
              "description": "Contenu, en texte (tronqué).",
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "step",
            "date"
          ]
        }
      },
      "id": {
        "description": "Identifiant de la tâche (à passer à get_task).",
        "type": "integer"
      },
      "status": {
        "description": "open (à traiter), scheduled (planifiée : visible du destinataire à partir de scheduledFor) ou done (traitée : répondue, transférée ou clôturée).",
        "type": "string"
      },
      "type": {
        "description": "Type de tâche (catégorie), ex. Commande, Facturation.",
        "type": [
          "string",
          "null"
        ]
      },
      "title": {
        "description": "Titre, rarement renseigné.",
        "type": [
          "string",
          "null"
        ]
      },
      "description": {
        "description": "Contenu de la tâche, en texte (tronqué dans les listes).",
        "type": [
          "string",
          "null"
        ]
      },
      "isUrgent": {
        "description": "Vrai pour une tâche urgente (épinglée).",
        "type": "boolean"
      },
      "isOverdue": {
        "description": "Vrai pour une tâche à traiter en retard : échéance dépassée, ou sans échéance, créée il y a plus de 5 jours (règle de l'application).",
        "type": "boolean"
      },
      "from": {
        "description": "Expéditeur (« Système (automatique) » pour une tâche créée par un traitement automatique).",
        "type": [
          "string",
          "null"
        ]
      },
      "to": {
        "description": "Destinataire.",
        "type": [
          "string",
          "null"
        ]
      },
      "createdAt": {
        "description": "Date de création, en heure locale belge avec son décalage UTC.",
        "type": "string",
        "format": "date-time"
      },
      "dueDate": {
        "description": "Échéance (AAAA-MM-JJ), rarement renseignée.",
        "type": [
          "string",
          "null"
        ],
        "format": "date"
      },
      "scheduledFor": {
        "description": "Date à partir de laquelle une tâche planifiée apparaît chez son destinataire (AAAA-MM-JJ).",
        "type": [
          "string",
          "null"
        ],
        "format": "date"
      },
      "completedAt": {
        "description": "Date à laquelle la tâche a été traitée, en heure locale belge.",
        "type": [
          "string",
          "null"
        ],
        "format": "date-time"
      },
      "dossierId": {
        "description": "Identifiant du dossier lié (à passer à get_dossier).",
        "type": [
          "integer",
          "null"
        ]
      },
      "dossierReference": {
        "description": "Référence du dossier lié.",
        "type": [
          "string",
          "null"
        ]
      },
      "dossierIndication": {
        "description": "Intitulé court du dossier lié.",
        "type": [
          "string",
          "null"
        ]
      }
    },
    "required": [
      "step",
      "id",
      "status",
      "isUrgent",
      "isOverdue",
      "createdAt"
    ]
  },
  "annotations": {
    "title": "Modifier une de mes tâches",
    "destructiveHint": true,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  }
}