Rechercher des dossiers

Nom de l'outilsearch_dossiers
Lecture seuleIdempotent

Description

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

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

Paramètres

NomTypePrésenceDescription
querystringfacultatifMots-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.
statusstringfacultatifFiltre facultatif sur le libellé du statut du dossier (correspondance partielle).
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 technique du dossier.
items[].referencestringpeut être nullRéférence du dossier, telle qu'affichée dans Oxygenius.
items[].indicationstringpeut être nullIntitulé court du dossier (indication).
items[].statusstringpeut être nullLibellé du statut du dossier.
items[].siteTypestringpeut être nullType de chantier.
items[].isActivebooleanFaux si le dossier est désactivé.
items[].clientobjectpeut être nullClient (tiers propriétaire) du dossier.
items[].client.idintegerIdentifiant technique du tiers.
items[].client.referencestringpeut être nullRéférence du tiers.
items[].client.namestringDénomination : société, sinon prénom et nom.
items[].siteAddressstringpeut être nullAdresse du chantier.
items[].externalReference1stringpeut être nullRéférence externe 1 (référence client).
items[].externalReference2stringpeut être nullRéférence externe 2.
items[].managerstringpeut être nullNom du gestionnaire du dossier.
items[].creationDatestring (date)peut être nullDate de création du dossier (AAAA-MM-JJ).

Annotations MCP

AnnotationValeurSignification
titleRechercher des dossiersNom 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_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
  }
}