Listes de l'agenda

Nom de l'outilget_agenda_lists
Lecture seuleIdempotent

Description

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

Renvoie, pour le planning ou le calendrier, les types d'événement, les états de chantier (planning) et les ressources (personnes et matériel) avec leur identifiant, à passer aux outils de création et de modification d'événements. isDefault marque le type retenu quand typeId est omis ; isCurrentUser désigne l'utilisateur connecté.

Accès requis

Paramètres

NomTypePrésenceDescription
kindstringobligatoireplanning ou calendar : écran dont on veut les listes.

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
typesobject[]Types d'événement de l'écran (typeId).
types[].idintegerIdentifiant à passer en typeId.
types[].namestringpeut être nullNom affiché dans l'application (chantier, rendez-vous, congé…).
types[].isPrivatebooleanVrai pour le type « privé » : le contenu de l'événement reste caché aux autres utilisateurs.
types[].isDefaultbooleanVrai pour le type retenu quand typeId est omis.
siteStatesobject[]États de chantier (siteStateId), pour le planning ; vide pour le calendrier.
siteStates[].idintegerIdentifiant à passer en siteStateId.
siteStates[].namestringpeut être nullNom affiché dans l'application (planifié, validé…).
siteStates[].typeIdintegerpeut être nullType d'événement (id de types) auquel l'état est réservé ; vide : état valable pour tous les types.
resourcesobject[]Personnes et matériel à qui affecter un événement (resourceIds).
resources[].idintegerIdentifiant à passer dans resourceIds.
resources[].namestringpeut être nullNom de la personne ou du matériel.
resources[].groupstringpeut être nullGroupe de ressources (ouvriers, bureau, matériel…).
resources[].isPersonbooleanVrai pour une personne, faux pour du matériel.
resources[].isCurrentUserbooleanVrai pour l'utilisateur connecté lui-même.

Annotations MCP

AnnotationValeurSignification
titleListes de l'agendaNom 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": "get_agenda_lists",
  "title": "Listes de l'agenda",
  "description": "Renvoie, pour le planning ou le calendrier, les types d'événement, les états de chantier (planning) et les ressources (personnes et matériel) avec leur identifiant, à passer aux outils de création et de modification d'événements. isDefault marque le type retenu quand typeId est omis ; isCurrentUser désigne l'utilisateur connecté.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "kind": {
        "description": "planning ou calendar : écran dont on veut les listes.",
        "type": "string"
      }
    },
    "required": [
      "kind"
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "types": {
        "description": "Types d'événement de l'écran (typeId).",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "description": "Identifiant à passer en typeId.",
              "type": "integer"
            },
            "name": {
              "description": "Nom affiché dans l'application (chantier, rendez-vous, congé…).",
              "type": [
                "string",
                "null"
              ]
            },
            "isPrivate": {
              "description": "Vrai pour le type « privé » : le contenu de l'événement reste caché aux autres utilisateurs.",
              "type": "boolean"
            },
            "isDefault": {
              "description": "Vrai pour le type retenu quand typeId est omis.",
              "type": "boolean"
            }
          },
          "required": [
            "id"
          ]
        }
      },
      "siteStates": {
        "description": "États de chantier (siteStateId), pour le planning ; vide pour le calendrier.",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "description": "Identifiant à passer en siteStateId.",
              "type": "integer"
            },
            "name": {
              "description": "Nom affiché dans l'application (planifié, validé…).",
              "type": [
                "string",
                "null"
              ]
            },
            "typeId": {
              "description": "Type d'événement (id de types) auquel l'état est réservé ; vide : état valable pour tous les types.",
              "type": [
                "integer",
                "null"
              ]
            }
          },
          "required": [
            "id"
          ]
        }
      },
      "resources": {
        "description": "Personnes et matériel à qui affecter un événement (resourceIds).",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "description": "Identifiant à passer dans resourceIds.",
              "type": "integer"
            },
            "name": {
              "description": "Nom de la personne ou du matériel.",
              "type": [
                "string",
                "null"
              ]
            },
            "group": {
              "description": "Groupe de ressources (ouvriers, bureau, matériel…).",
              "type": [
                "string",
                "null"
              ]
            },
            "isPerson": {
              "description": "Vrai pour une personne, faux pour du matériel.",
              "type": "boolean"
            },
            "isCurrentUser": {
              "description": "Vrai pour l'utilisateur connecté lui-même.",
              "type": "boolean"
            }
          },
          "required": [
            "id"
          ]
        }
      }
    },
    "required": [
      "types",
      "siteStates",
      "resources"
    ]
  },
  "annotations": {
    "title": "Listes de l'agenda",
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": true
  }
}