Créer une tâche

Tool namecreate_task
Write

Creates a task on a project for one or more people (one task each, each notified).

Description

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

Crée dans Oxygenius une tâche sur un dossier, adressée par l'utilisateur connecté à une ou plusieurs personnes (une tâche par personne, chacune notifiée). Les personnes viennent de search_users, le type de list_task_types (il doit être proposé pour chaque destinataire). Avant l'appel, annoncer précisément la tâche (destinataires, type, dossier, contenu, urgence, planification) et attendre l'accord de l'utilisateur ; ne pas rappeler l'outil après un succès, chaque appel crée de nouvelles tâches. Renvoie les tâches créées.

Required access

Parameters

NameTypePresenceDescription
assigneeIdsinteger[]requiredIdentifiants des destinataires (champ id de search_users), 10 au plus.
taskTypeIdintegerrequiredIdentifiant du type de tâche (champ id de list_task_types).
dossierIdintegerrequiredIdentifiant du dossier de la tâche (champ id de search_dossiers).
descriptionstringrequiredContenu de la tâche, en texte brut (retours à la ligne permis, HTML non interprété).
isUrgentbooleanoptionalVrai pour une tâche urgente (épinglée) ; faux par défaut.
Default : false
scheduledForstring (date)optionalDate de planification (AAAA-MM-JJ, après aujourd'hui) : la tâche n'apparaît chez ses destinataires qu'à partir de ce jour. Sans date, elle est à traiter tout de suite.

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
tasksobject[]Tâches créées, une par destinataire, dans l'ordre des destinataires demandés.
tasks[].idintegerIdentifiant de la tâche (à passer à get_task).
tasks[].statusstringopen (à traiter), scheduled (planifiée : visible du destinataire à partir de scheduledFor) ou done (traitée : répondue, transférée ou clôturée).
tasks[].typestringnullableType de tâche (catégorie), ex. Commande, Facturation.
tasks[].titlestringnullableTitre, rarement renseigné.
tasks[].descriptionstringnullableContenu de la tâche, en texte (tronqué dans les listes).
tasks[].isUrgentbooleanVrai pour une tâche urgente (épinglée).
tasks[].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).
tasks[].fromstringnullableExpéditeur (« Système (automatique) » pour une tâche créée par un traitement automatique).
tasks[].tostringnullableDestinataire.
tasks[].createdAtstring (date-time)Date de création, en heure locale belge avec son décalage UTC.
tasks[].dueDatestring (date)nullableÉchéance (AAAA-MM-JJ), rarement renseignée.
tasks[].scheduledForstring (date)nullableDate à partir de laquelle une tâche planifiée apparaît chez son destinataire (AAAA-MM-JJ).
tasks[].completedAtstring (date-time)nullableDate à laquelle la tâche a été traitée, en heure locale belge.
tasks[].dossierIdintegernullableIdentifiant du dossier lié (à passer à get_dossier).
tasks[].dossierReferencestringnullableRéférence du dossier lié.
tasks[].dossierIndicationstringnullableIntitulé court du dossier lié.

MCP annotations

AnnotationValueMeaning
titleCréer une tâcheHuman-readable name shown by the MCP client.
readOnlyHintnoThe tool changes nothing.
destructiveHintnoThe 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": "create_task",
  "title": "Créer une tâche",
  "description": "Crée dans Oxygenius une tâche sur un dossier, adressée par l'utilisateur connecté à une ou plusieurs personnes (une tâche par personne, chacune notifiée). Les personnes viennent de search_users, le type de list_task_types (il doit être proposé pour chaque destinataire). Avant l'appel, annoncer précisément la tâche (destinataires, type, dossier, contenu, urgence, planification) et attendre l'accord de l'utilisateur ; ne pas rappeler l'outil après un succès, chaque appel crée de nouvelles tâches. Renvoie les tâches créées.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "assigneeIds": {
        "description": "Identifiants des destinataires (champ id de search_users), 10 au plus.",
        "type": "array",
        "items": {
          "type": "integer"
        }
      },
      "taskTypeId": {
        "description": "Identifiant du type de tâche (champ id de list_task_types).",
        "type": "integer"
      },
      "dossierId": {
        "description": "Identifiant du dossier de la tâche (champ id de search_dossiers).",
        "type": "integer"
      },
      "description": {
        "description": "Contenu de la tâche, en texte brut (retours à la ligne permis, HTML non interprété).",
        "type": "string"
      },
      "isUrgent": {
        "description": "Vrai pour une tâche urgente (épinglée) ; faux par défaut.",
        "type": "boolean",
        "default": false
      },
      "scheduledFor": {
        "description": "Date de planification (AAAA-MM-JJ, après aujourd'hui) : la tâche n'apparaît chez ses destinataires qu'à partir de ce jour. Sans date, elle est à traiter tout de suite.",
        "type": [
          "string",
          "null"
        ],
        "format": "date",
        "default": null
      }
    },
    "required": [
      "assigneeIds",
      "taskTypeId",
      "dossierId",
      "description"
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "tasks": {
        "description": "Tâches créées, une par destinataire, dans l'ordre des destinataires demandés.",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "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": [
            "id",
            "status",
            "isUrgent",
            "isOverdue",
            "createdAt"
          ]
        }
      }
    },
    "required": [
      "tasks"
    ]
  },
  "annotations": {
    "title": "Créer une tâche",
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false,
    "readOnlyHint": false
  }
}