Rechercher une personne
Nom de l'outil
search_usersLecture seuleIdempotent
Description
Recherche les membres actifs du personnel de l'entreprise par leur nom ou prénom, par ordre alphabétique. Renvoie l'identifiant à passer aux outils qui désignent une personne (ex. assigneeId de create_task, managerId de create_dossier), la fonction, si l'on peut lui adresser une tâche et si elle peut gérer un dossier.
Accès requis
- Au moins une de ces permissions :
dashboard.tasksWidget.viewoudossier-detail.tab.taskoudossier.new-dossier.createoudossier-detail.dossier.edit - 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 | Nom et/ou prénom (fragments acceptés, accents et casse ignorés). Vide : tout le personnel. |
taskRecipientsOnly | boolean | facultatif | Vrai pour n'avoir que les personnes à qui l'on peut adresser une tâche (faux par défaut). |
dossierManagersOnly | boolean | facultatif | Vrai pour n'avoir que les personnes qui peuvent gérer un dossier (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 personne (à passer aux outils qui désignent une personne, ex. assigneeId). | |
items[].name | string | peut être null | Nom et prénom. |
items[].function | string | peut être null | Fonction dans l'entreprise (ex. Gestionnaire, Ouvrier). |
items[].canReceiveTasks | boolean | Vrai si l'on peut lui adresser une tâche (au moins un type de tâche lui est attribué). | |
items[].canManageDossiers | boolean | Vrai si sa fonction lui permet de gérer un dossier (managerId de create_dossier et update_dossier). | |
items[].isCurrentUser | boolean | Vrai pour l'utilisateur connecté lui-même. |
Annotations MCP
| Annotation | Valeur | Signification |
|---|---|---|
title | Rechercher une personne | 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_users",
"title": "Rechercher une personne",
"description": "Recherche les membres actifs du personnel de l'entreprise par leur nom ou prénom, par ordre alphabétique. Renvoie l'identifiant à passer aux outils qui désignent une personne (ex. assigneeId de create_task, managerId de create_dossier), la fonction, si l'on peut lui adresser une tâche et si elle peut gérer un dossier.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"description": "Nom et/ou prénom (fragments acceptés, accents et casse ignorés). Vide : tout le personnel.",
"type": [
"string",
"null"
],
"default": null
},
"taskRecipientsOnly": {
"description": "Vrai pour n'avoir que les personnes à qui l'on peut adresser une tâche (faux par défaut).",
"type": "boolean",
"default": false
},
"dossierManagersOnly": {
"description": "Vrai pour n'avoir que les personnes qui peuvent gérer un dossier (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 personne (à passer aux outils qui désignent une personne, ex. assigneeId).",
"type": "integer"
},
"name": {
"description": "Nom et prénom.",
"type": [
"string",
"null"
]
},
"function": {
"description": "Fonction dans l'entreprise (ex. Gestionnaire, Ouvrier).",
"type": [
"string",
"null"
]
},
"canReceiveTasks": {
"description": "Vrai si l'on peut lui adresser une tâche (au moins un type de tâche lui est attribué).",
"type": "boolean"
},
"canManageDossiers": {
"description": "Vrai si sa fonction lui permet de gérer un dossier (managerId de create_dossier et update_dossier).",
"type": "boolean"
},
"isCurrentUser": {
"description": "Vrai pour l'utilisateur connecté lui-même.",
"type": "boolean"
}
},
"required": [
"id",
"canReceiveTasks",
"canManageDossiers",
"isCurrentUser"
]
}
}
},
"required": [
"totalCount",
"offset",
"limit",
"hasMore",
"items"
]
},
"annotations": {
"title": "Rechercher une personne",
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false,
"readOnlyHint": true
}
}