Rechercher une personne

Nom de l'outilsearch_users
Lecture seuleIdempotent

Description

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

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

Paramètres

NomTypePrésenceDescription
querystringfacultatifNom et/ou prénom (fragments acceptés, accents et casse ignorés). Vide : tout le personnel.
taskRecipientsOnlybooleanfacultatifVrai pour n'avoir que les personnes à qui l'on peut adresser une tâche (faux par défaut).
Par défaut : false
dossierManagersOnlybooleanfacultatifVrai pour n'avoir que les personnes qui peuvent gérer un dossier (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 personne (à passer aux outils qui désignent une personne, ex. assigneeId).
items[].namestringpeut être nullNom et prénom.
items[].functionstringpeut être nullFonction dans l'entreprise (ex. Gestionnaire, Ouvrier).
items[].canReceiveTasksbooleanVrai si l'on peut lui adresser une tâche (au moins un type de tâche lui est attribué).
items[].canManageDossiersbooleanVrai si sa fonction lui permet de gérer un dossier (managerId de create_dossier et update_dossier).
items[].isCurrentUserbooleanVrai pour l'utilisateur connecté lui-même.

Annotations MCP

AnnotationValeurSignification
titleRechercher une personneNom 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_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
  }
}