Rechercher des tâches

Nom de l'outilsearch_tasks
Lecture seuleIdempotent

Description

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

Liste ou recherche les tâches Oxygenius (demandes adressées d'un utilisateur à un autre, souvent liées à un dossier), urgentes d'abord puis les plus récentes. Par défaut : les tâches à traiter. Seules les tâches visibles dans l'application sont renvoyées : celles dont l'utilisateur est destinataire, expéditeur ou créateur, et avec le droit de voir les tâches des autres, toutes celles des dossiers. Pour « mes tâches », préférer get_my_tasks. Utiliser get_task pour le détail et l'historique de l'échange.

Accès requis

Paramètres

NomTypePrésenceDescription
querystringfacultatifMots-clés : contenu, titre, type de tâche, référence ou intitulé du dossier.
statusstringfacultatifopen (à traiter, défaut), scheduled (planifiées), done (traitées : répondues, transférées ou clôturées) ou all.
dossierIdintegerfacultatifIdentifiant d'un dossier pour n'avoir que ses tâches.
assigneestringfacultatifNom ou prénom du destinataire.
senderstringfacultatifNom ou prénom de l'expéditeur.
overdueOnlybooleanfacultatifSeulement les tâches à traiter en retard (faux par défaut).
Par défaut : false
limitintegerfacultatifNombre de résultats souhaités (10 par défaut, plafonné par le serveur).
Par défaut : 10
offsetintegerfacultatifNombre de résultats à sauter pour la pagination (0 par défaut).
Par défaut : 0

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
totalCountintegerNombre total d'éléments correspondant aux critères.
offsetintegerPosition du premier élément de la page.
limitintegerTaille de page appliquée (le serveur plafonne la valeur demandée).
hasMorebooleanVrai s'il reste des éléments : rappeler l'outil avec offset = offset + limit.
itemsobject[]Éléments de la page.
items[].idintegerIdentifiant de la tâche (à passer à get_task).
items[].statusstringopen (à traiter), scheduled (planifiée : visible du destinataire à partir de scheduledFor) ou done (traitée : répondue, transférée ou clôturée).
items[].typestringpeut être nullType de tâche (catégorie), ex. Commande, Facturation.
items[].titlestringpeut être nullTitre, rarement renseigné.
items[].descriptionstringpeut être nullContenu de la tâche, en texte (tronqué dans les listes).
items[].isUrgentbooleanVrai pour une tâche urgente (épinglée).
items[].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).
items[].fromstringpeut être nullExpéditeur (« Système (automatique) » pour une tâche créée par un traitement automatique).
items[].tostringpeut être nullDestinataire.
items[].createdAtstring (date-time)Date de création, en heure locale belge avec son décalage UTC.
items[].dueDatestring (date)peut être nullÉchéance (AAAA-MM-JJ), rarement renseignée.
items[].scheduledForstring (date)peut être nullDate à partir de laquelle une tâche planifiée apparaît chez son destinataire (AAAA-MM-JJ).
items[].completedAtstring (date-time)peut être nullDate à laquelle la tâche a été traitée, en heure locale belge.
items[].dossierIdintegerpeut être nullIdentifiant du dossier lié (à passer à get_dossier).
items[].dossierReferencestringpeut être nullRéférence du dossier lié.
items[].dossierIndicationstringpeut être nullIntitulé court du dossier lié.

Annotations MCP

AnnotationValeurSignification
titleRechercher des tâchesNom 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.
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": "search_tasks",
  "title": "Rechercher des tâches",
  "description": "Liste ou recherche les tâches Oxygenius (demandes adressées d'un utilisateur à un autre, souvent liées à un dossier), urgentes d'abord puis les plus récentes. Par défaut : les tâches à traiter. Seules les tâches visibles dans l'application sont renvoyées : celles dont l'utilisateur est destinataire, expéditeur ou créateur, et avec le droit de voir les tâches des autres, toutes celles des dossiers. Pour « mes tâches », préférer get_my_tasks. Utiliser get_task pour le détail et l'historique de l'échange.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "description": "Mots-clés : contenu, titre, type de tâche, référence ou intitulé du dossier.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "status": {
        "description": "open (à traiter, défaut), scheduled (planifiées), done (traitées : répondues, transférées ou clôturées) ou all.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "dossierId": {
        "description": "Identifiant d'un dossier pour n'avoir que ses tâches.",
        "type": [
          "integer",
          "null"
        ],
        "default": null
      },
      "assignee": {
        "description": "Nom ou prénom du destinataire.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "sender": {
        "description": "Nom ou prénom de l'expéditeur.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "overdueOnly": {
        "description": "Seulement les tâches à traiter en retard (faux par défaut).",
        "type": "boolean",
        "default": false
      },
      "limit": {
        "description": "Nombre de résultats souhaités (10 par défaut, plafonné par le serveur).",
        "type": "integer",
        "default": 10
      },
      "offset": {
        "description": "Nombre de résultats à sauter pour la pagination (0 par défaut).",
        "type": "integer",
        "default": 0
      }
    }
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "totalCount": {
        "description": "Nombre total d'éléments correspondant aux critères.",
        "type": "integer"
      },
      "offset": {
        "description": "Position du premier élément de la page.",
        "type": "integer"
      },
      "limit": {
        "description": "Taille de page appliquée (le serveur plafonne la valeur demandée).",
        "type": "integer"
      },
      "hasMore": {
        "description": "Vrai s'il reste des éléments : rappeler l'outil avec offset = offset + limit.",
        "type": "boolean"
      },
      "items": {
        "description": "Éléments de la page.",
        "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": [
      "totalCount",
      "offset",
      "limit",
      "hasMore",
      "items"
    ]
  },
  "annotations": {
    "title": "Rechercher des tâches",
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": true
  }
}