Rechercher des tâches
search_tasksDescription
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
- Au moins une de ces permissions :
dashboard.tasksWidget.viewoudossier-detail.tab.task - Sans ces conditions, l'outil n'apparaît pas dans
tools/listet son appel est refusé.
Paramètres
| Nom | Type | Présence | Description |
|---|---|---|---|
query | string | facultatif | Mots-clés : contenu, titre, type de tâche, référence ou intitulé du dossier. |
status | string | facultatif | open (à traiter, défaut), scheduled (planifiées), done (traitées : répondues, transférées ou clôturées) ou all. |
dossierId | integer | facultatif | Identifiant d'un dossier pour n'avoir que ses tâches. |
assignee | string | facultatif | Nom ou prénom du destinataire. |
sender | string | facultatif | Nom ou prénom de l'expéditeur. |
overdueOnly | boolean | facultatif | Seulement les tâches à traiter en retard (faux par défaut). |
limit | integer | facultatif | Nombre de résultats souhaités (10 par défaut, plafonné par le serveur). |
offset | integer | facultatif | Nombre de résultats à sauter pour la pagination (0 par défaut). |
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
| Nom | Type | Présence | Description |
|---|---|---|---|
totalCount | integer | Nombre total d'éléments correspondant aux critères. | |
offset | integer | Position du premier élément de la page. | |
limit | integer | Taille de page appliquée (le serveur plafonne la valeur demandée). | |
hasMore | boolean | Vrai s'il reste des éléments : rappeler l'outil avec offset = offset + limit. | |
items | object[] | Éléments de la page. | |
items[].id | integer | Identifiant de la tâche (à passer à get_task). | |
items[].status | string | open (à traiter), scheduled (planifiée : visible du destinataire à partir de scheduledFor) ou done (traitée : répondue, transférée ou clôturée). | |
items[].type | string | peut être null | Type de tâche (catégorie), ex. Commande, Facturation. |
items[].title | string | peut être null | Titre, rarement renseigné. |
items[].description | string | peut être null | Contenu de la tâche, en texte (tronqué dans les listes). |
items[].isUrgent | boolean | Vrai pour une tâche urgente (épinglée). | |
items[].isOverdue | boolean | 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). | |
items[].from | string | peut être null | Expéditeur (« Système (automatique) » pour une tâche créée par un traitement automatique). |
items[].to | string | peut être null | Destinataire. |
items[].createdAt | string (date-time) | Date de création, en heure locale belge avec son décalage UTC. | |
items[].dueDate | string (date) | peut être null | Échéance (AAAA-MM-JJ), rarement renseignée. |
items[].scheduledFor | string (date) | peut être null | Date à partir de laquelle une tâche planifiée apparaît chez son destinataire (AAAA-MM-JJ). |
items[].completedAt | string (date-time) | peut être null | Date à laquelle la tâche a été traitée, en heure locale belge. |
items[].dossierId | integer | peut être null | Identifiant du dossier lié (à passer à get_dossier). |
items[].dossierReference | string | peut être null | Référence du dossier lié. |
items[].dossierIndication | string | peut être null | Intitulé court du dossier lié. |
Annotations MCP
| Annotation | Valeur | Signification |
|---|---|---|
title | Rechercher des tâches | Nom lisible affiché par le client MCP. |
readOnlyHint | oui | L'outil ne modifie rien. |
destructiveHint | non | L'outil peut modifier ou supprimer des données existantes, ou déclencher une action irréversible. |
idempotentHint | oui | Rappeler l'outil avec les mêmes arguments n'a pas d'effet supplémentaire. |
openWorldHint | non | L'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
}
}