Transférer une tâche

Tool nametransfer_task
WriteDestructive

Transfers a to-do task to another person; the original task is closed.

Description

Exact text sent to the model by tools/list (French, the language of the data):

Transfère dans Oxygenius une tâche à traiter à une autre personne (search_users) : elle lui est adressée avec le même contenu, type et urgence, et la tâche d'origine est traitée (définitivement). L'application n'accepte que les tâches que l'utilisateur voit, liées à un dossier. Avant l'appel, annoncer le transfert et attendre l'accord de l'utilisateur. Renvoie la tâche transférée, avec le transfert dans son échange.

Required access

Parameters

NameTypePresenceDescription
taskIdintegerrequiredIdentifiant de la tâche (champ id de search_tasks, get_my_tasks ou get_task).
assigneeIdintegerrequiredIdentifiant du nouveau destinataire (champ id de search_users).

Result

The result is returned as structured content (structuredContent) matching the output schema below, and as JSON text for clients that do not read structured content. An error comes back with isError: true and a French message that explains what to fix.

Result fields
NameTypePresenceDescription
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[].taskIdintegernullableIdentifiant de la tâche (absent pour une clôture).
thread[].stepstringcreation, reply (réponse), transfer (transfert) ou closure (clôture).
thread[].fromstringnullableAuteur de l'étape.
thread[].tostringnullableDestinataire (absent pour une clôture).
thread[].datestring (date-time)Date de l'étape, en heure locale belge.
thread[].descriptionstringnullableContenu, 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).
typestringnullableType de tâche (catégorie), ex. Commande, Facturation.
titlestringnullableTitre, rarement renseigné.
descriptionstringnullableContenu 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).
fromstringnullableExpéditeur (« Système (automatique) » pour une tâche créée par un traitement automatique).
tostringnullableDestinataire.
createdAtstring (date-time)Date de création, en heure locale belge avec son décalage UTC.
dueDatestring (date)nullableÉchéance (AAAA-MM-JJ), rarement renseignée.
scheduledForstring (date)nullableDate à partir de laquelle une tâche planifiée apparaît chez son destinataire (AAAA-MM-JJ).
completedAtstring (date-time)nullableDate à laquelle la tâche a été traitée, en heure locale belge.
dossierIdintegernullableIdentifiant du dossier lié (à passer à get_dossier).
dossierReferencestringnullableRéférence du dossier lié.
dossierIndicationstringnullableIntitulé court du dossier lié.

MCP annotations

AnnotationValueMeaning
titleTransférer une tâcheHuman-readable name shown by the MCP client.
readOnlyHintnoThe tool changes nothing.
destructiveHintyesThe tool may change or delete existing data, or trigger an irreversible action.
idempotentHintnoCalling it again with the same arguments has no further effect.
openWorldHintnoThe tool reads e-mails or document content, or reaches an external service.

JSON definition

Exact tools/list entry
{
  "name": "transfer_task",
  "title": "Transférer une tâche",
  "description": "Transfère dans Oxygenius une tâche à traiter à une autre personne (search_users) : elle lui est adressée avec le même contenu, type et urgence, et la tâche d'origine est traitée (définitivement). L'application n'accepte que les tâches que l'utilisateur voit, liées à un dossier. Avant l'appel, annoncer le transfert et attendre l'accord de l'utilisateur. Renvoie la tâche transférée, avec le transfert dans son échange.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "taskId": {
        "description": "Identifiant de la tâche (champ id de search_tasks, get_my_tasks ou get_task).",
        "type": "integer"
      },
      "assigneeId": {
        "description": "Identifiant du nouveau destinataire (champ id de search_users).",
        "type": "integer"
      }
    },
    "required": [
      "taskId",
      "assigneeId"
    ]
  },
  "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": "Transférer une tâche",
    "destructiveHint": true,
    "idempotentHint": false,
    "openWorldHint": false,
    "readOnlyHint": false
  }
}