Créer une tâche

Nom de l'outilcreate_task
Écriture

Description

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

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.

Accès requis

Paramètres

NomTypePrésenceDescription
assigneeIdsinteger[]obligatoireIdentifiants des destinataires (champ id de search_users), 10 au plus.
taskTypeIdintegerobligatoireIdentifiant du type de tâche (champ id de list_task_types).
dossierIdintegerobligatoireIdentifiant du dossier de la tâche (champ id de search_dossiers).
descriptionstringobligatoireContenu de la tâche, en texte brut (retours à la ligne permis, HTML non interprété).
isUrgentbooleanfacultatifVrai pour une tâche urgente (épinglée) ; faux par défaut.
Par défaut : false
scheduledForstring (date)facultatifDate 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.

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
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[].typestringpeut être nullType de tâche (catégorie), ex. Commande, Facturation.
tasks[].titlestringpeut être nullTitre, rarement renseigné.
tasks[].descriptionstringpeut être nullContenu 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[].fromstringpeut être nullExpéditeur (« Système (automatique) » pour une tâche créée par un traitement automatique).
tasks[].tostringpeut être nullDestinataire.
tasks[].createdAtstring (date-time)Date de création, en heure locale belge avec son décalage UTC.
tasks[].dueDatestring (date)peut être nullÉchéance (AAAA-MM-JJ), rarement renseignée.
tasks[].scheduledForstring (date)peut être nullDate à partir de laquelle une tâche planifiée apparaît chez son destinataire (AAAA-MM-JJ).
tasks[].completedAtstring (date-time)peut être nullDate à laquelle la tâche a été traitée, en heure locale belge.
tasks[].dossierIdintegerpeut être nullIdentifiant du dossier lié (à passer à get_dossier).
tasks[].dossierReferencestringpeut être nullRéférence du dossier lié.
tasks[].dossierIndicationstringpeut être nullIntitulé court du dossier lié.

Annotations MCP

AnnotationValeurSignification
titleCréer une tâcheNom lisible affiché par le client MCP.
readOnlyHintnonL'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": "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
  }
}