Rechercher des dossiers
search_dossiersDescription
Liste ou recherche les dossiers (chantiers) de l'entreprise de l'utilisateur dans Oxygenius. La recherche porte sur la référence et l'intitulé du dossier, ses références externes, l'adresse du chantier, ainsi que le nom, la référence, l'adresse et le téléphone des tiers liés. Tous les mots du terme doivent être trouvés ; la casse et les accents sont ignorés. Les résultats sont triés du dossier le plus récent au plus ancien. Seuls les dossiers que l'utilisateur peut voir dans Oxygenius sont renvoyés. Utiliser get_dossier pour le détail d'un dossier.
Accès requis
- Permission :
dossier.list.view - 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 : référence de dossier, nom ou référence du client, rue, localité, code postal, téléphone… Laisser vide pour lister les dossiers les plus récents. |
status | string | facultatif | Filtre facultatif sur le libellé du statut du dossier (correspondance partielle). |
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 technique du dossier. | |
items[].reference | string | peut être null | Référence du dossier, telle qu'affichée dans Oxygenius. |
items[].indication | string | peut être null | Intitulé court du dossier (indication). |
items[].status | string | peut être null | Libellé du statut du dossier. |
items[].siteType | string | peut être null | Type de chantier. |
items[].isActive | boolean | Faux si le dossier est désactivé. | |
items[].client | object | peut être null | Client (tiers propriétaire) du dossier. |
items[].client.id | integer | Identifiant technique du tiers. | |
items[].client.reference | string | peut être null | Référence du tiers. |
items[].client.name | string | Dénomination : société, sinon prénom et nom. | |
items[].siteAddress | string | peut être null | Adresse du chantier. |
items[].externalReference1 | string | peut être null | Référence externe 1 (référence client). |
items[].externalReference2 | string | peut être null | Référence externe 2. |
items[].manager | string | peut être null | Nom du gestionnaire du dossier. |
items[].creationDate | string (date) | peut être null | Date de création du dossier (AAAA-MM-JJ). |
Annotations MCP
| Annotation | Valeur | Signification |
|---|---|---|
title | Rechercher des dossiers | 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_dossiers",
"title": "Rechercher des dossiers",
"description": "Liste ou recherche les dossiers (chantiers) de l'entreprise de l'utilisateur dans Oxygenius. La recherche porte sur la référence et l'intitulé du dossier, ses références externes, l'adresse du chantier, ainsi que le nom, la référence, l'adresse et le téléphone des tiers liés. Tous les mots du terme doivent être trouvés ; la casse et les accents sont ignorés. Les résultats sont triés du dossier le plus récent au plus ancien. Seuls les dossiers que l'utilisateur peut voir dans Oxygenius sont renvoyés. Utiliser get_dossier pour le détail d'un dossier.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"description": "Mots-clés : référence de dossier, nom ou référence du client, rue, localité, code postal, téléphone… Laisser vide pour lister les dossiers les plus récents.",
"type": [
"string",
"null"
],
"default": null
},
"status": {
"description": "Filtre facultatif sur le libellé du statut du dossier (correspondance partielle).",
"type": [
"string",
"null"
],
"default": null
},
"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 technique du dossier.",
"type": "integer"
},
"reference": {
"description": "Référence du dossier, telle qu'affichée dans Oxygenius.",
"type": [
"string",
"null"
]
},
"indication": {
"description": "Intitulé court du dossier (indication).",
"type": [
"string",
"null"
]
},
"status": {
"description": "Libellé du statut du dossier.",
"type": [
"string",
"null"
]
},
"siteType": {
"description": "Type de chantier.",
"type": [
"string",
"null"
]
},
"isActive": {
"description": "Faux si le dossier est désactivé.",
"type": "boolean"
},
"client": {
"description": "Client (tiers propriétaire) du dossier.",
"type": [
"object",
"null"
],
"properties": {
"id": {
"description": "Identifiant technique du tiers.",
"type": "integer"
},
"reference": {
"description": "Référence du tiers.",
"type": [
"string",
"null"
]
},
"name": {
"description": "Dénomination : société, sinon prénom et nom.",
"type": "string"
}
},
"required": [
"id",
"name"
]
},
"siteAddress": {
"description": "Adresse du chantier.",
"type": [
"string",
"null"
]
},
"externalReference1": {
"description": "Référence externe 1 (référence client).",
"type": [
"string",
"null"
]
},
"externalReference2": {
"description": "Référence externe 2.",
"type": [
"string",
"null"
]
},
"manager": {
"description": "Nom du gestionnaire du dossier.",
"type": [
"string",
"null"
]
},
"creationDate": {
"description": "Date de création du dossier (AAAA-MM-JJ).",
"type": [
"string",
"null"
],
"format": "date"
}
},
"required": [
"id",
"isActive"
]
}
}
},
"required": [
"totalCount",
"offset",
"limit",
"hasMore",
"items"
]
},
"annotations": {
"title": "Rechercher des dossiers",
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false,
"readOnlyHint": true
}
}