Planifier un événement

Nom de l'outilcreate_planning_event
Écriture

Description

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

Crée dans le planning Oxygenius un événement (chantier, visite…) sur un jour ou sur plusieurs jours consécutifs, aux mêmes heures chaque jour, affecté à des personnes ou à du matériel (get_agenda_lists avec kind planning donne les types, états de chantier et ressources). Lié à un dossier, il a lieu par défaut à l'adresse de son chantier. Avant l'appel, annoncer précisément l'événement (jours, heures, personnes) et attendre l'accord de l'utilisateur. Aucune confirmation n'est envoyée au client ; les personnes affectées sont prévenues par l'application. Ne pas rappeler l'outil après un succès : chaque appel crée un nouvel événement. Renvoie le premier jour créé.

Accès requis

Paramètres

NomTypePrésenceDescription
subjectstringobligatoireObjet de l'événement (ex. Pose des châssis).
datestring (date)obligatoirePremier jour (AAAA-MM-JJ).
startTimestringobligatoireHeure de début, heure locale belge (HH:mm, ex. 07:30).
endTimestringobligatoireHeure de fin, le même jour (HH:mm).
resourceIdsinteger[]obligatoireRessources affectées (champ id de resources dans get_agenda_lists), 20 au plus.
endDatestring (date)facultatifDernier jour, pour un événement de plusieurs jours consécutifs (31 jours au plus).
typeIdintegerfacultatifType d'événement (id de types) ; par défaut, le type marqué isDefault.
siteStateIdintegerfacultatifÉtat de chantier (id de siteStates) ; par défaut, le premier état valable pour le type.
dossierIdintegerfacultatifDossier lié (champ id de search_dossiers).
estimateIdsinteger[]facultatifDevis du dossier à lier (champ id de search_estimates), 10 au plus.
locationstringfacultatifLieu ; par défaut, l'adresse du chantier du dossier lié.
descriptionstringfacultatifDescription, en texte simple.

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
descriptionstringpeut être nullDescription de l'événement (masquée pour un événement privé d'autrui).
dossierSiteAddressstringpeut être nullAdresse du chantier du dossier lié.
dossierClientstringpeut être nullClient (tiers propriétaire) du dossier lié.
estimatesobject[]Devis liés à l'événement (vide sans accès aux devis).
estimates[].estimateIdintegerIdentifiant du devis (à passer à get_estimate).
estimates[].referencestringpeut être nullRéférence du devis.
idintegerIdentifiant de l'événement (à passer à get_planning_event ou get_calendar_event).
kindstringplanning ou calendar : écran d'origine de l'événement.
subjectstringpeut être nullObjet de l'événement ; « Privé » pour l'événement privé d'un autre utilisateur.
startstring (date-time)Début, en heure locale belge avec son décalage UTC (ex. 2026-10-14T08:00:00+02:00).
endstring (date-time)Fin, en heure locale belge avec son décalage UTC.
typestringpeut être nullType d'événement (chantier, rendez-vous, congé, intervention…).
siteStatestringpeut être nullÉtat de chantier (planifié, validé…), pour le planning.
locationstringpeut être nullLieu saisi sur l'événement (masqué pour un événement privé d'autrui).
isPrivatebooleanVrai pour un événement privé.
dossierIdintegerpeut être nullIdentifiant du dossier lié (à passer à get_dossier).
dossierReferencestringpeut être nullRéférence du dossier lié.
dossierIndicationstringpeut être nullIntitulé court du dossier lié.
assigneesstring[]Personnes affectées à cette occurrence.

Annotations MCP

AnnotationValeurSignification
titlePlanifier un événementNom lisible affiché par le client MCP.
readOnlyHintnonL'outil ne modifie rien.
destructiveHintnonL'outil peut modifier ou supprimer des données existantes, ou déclencher une action irréversible.
idempotentHintnonRappeler 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": "create_planning_event",
  "title": "Planifier un événement",
  "description": "Crée dans le planning Oxygenius un événement (chantier, visite…) sur un jour ou sur plusieurs jours consécutifs, aux mêmes heures chaque jour, affecté à des personnes ou à du matériel (get_agenda_lists avec kind planning donne les types, états de chantier et ressources). Lié à un dossier, il a lieu par défaut à l'adresse de son chantier. Avant l'appel, annoncer précisément l'événement (jours, heures, personnes) et attendre l'accord de l'utilisateur. Aucune confirmation n'est envoyée au client ; les personnes affectées sont prévenues par l'application. Ne pas rappeler l'outil après un succès : chaque appel crée un nouvel événement. Renvoie le premier jour créé.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "subject": {
        "description": "Objet de l'événement (ex. Pose des châssis).",
        "type": "string"
      },
      "date": {
        "description": "Premier jour (AAAA-MM-JJ).",
        "type": "string",
        "format": "date"
      },
      "startTime": {
        "description": "Heure de début, heure locale belge (HH:mm, ex. 07:30).",
        "type": "string"
      },
      "endTime": {
        "description": "Heure de fin, le même jour (HH:mm).",
        "type": "string"
      },
      "resourceIds": {
        "description": "Ressources affectées (champ id de resources dans get_agenda_lists), 20 au plus.",
        "type": "array",
        "items": {
          "type": "integer"
        }
      },
      "endDate": {
        "description": "Dernier jour, pour un événement de plusieurs jours consécutifs (31 jours au plus).",
        "type": [
          "string",
          "null"
        ],
        "format": "date",
        "default": null
      },
      "typeId": {
        "description": "Type d'événement (id de types) ; par défaut, le type marqué isDefault.",
        "type": [
          "integer",
          "null"
        ],
        "default": null
      },
      "siteStateId": {
        "description": "État de chantier (id de siteStates) ; par défaut, le premier état valable pour le type.",
        "type": [
          "integer",
          "null"
        ],
        "default": null
      },
      "dossierId": {
        "description": "Dossier lié (champ id de search_dossiers).",
        "type": [
          "integer",
          "null"
        ],
        "default": null
      },
      "estimateIds": {
        "description": "Devis du dossier à lier (champ id de search_estimates), 10 au plus.",
        "type": [
          "array",
          "null"
        ],
        "items": {
          "type": "integer"
        },
        "default": null
      },
      "location": {
        "description": "Lieu ; par défaut, l'adresse du chantier du dossier lié.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "description": {
        "description": "Description, en texte simple.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      }
    },
    "required": [
      "subject",
      "date",
      "startTime",
      "endTime",
      "resourceIds"
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "description": {
        "description": "Description de l'événement (masquée pour un événement privé d'autrui).",
        "type": [
          "string",
          "null"
        ]
      },
      "dossierSiteAddress": {
        "description": "Adresse du chantier du dossier lié.",
        "type": [
          "string",
          "null"
        ]
      },
      "dossierClient": {
        "description": "Client (tiers propriétaire) du dossier lié.",
        "type": [
          "string",
          "null"
        ]
      },
      "estimates": {
        "description": "Devis liés à l'événement (vide sans accès aux devis).",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "estimateId": {
              "description": "Identifiant du devis (à passer à get_estimate).",
              "type": "integer"
            },
            "reference": {
              "description": "Référence du devis.",
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "estimateId"
          ]
        }
      },
      "id": {
        "description": "Identifiant de l'événement (à passer à get_planning_event ou get_calendar_event).",
        "type": "integer"
      },
      "kind": {
        "description": "planning ou calendar : écran d'origine de l'événement.",
        "type": "string"
      },
      "subject": {
        "description": "Objet de l'événement ; « Privé » pour l'événement privé d'un autre utilisateur.",
        "type": [
          "string",
          "null"
        ]
      },
      "start": {
        "description": "Début, en heure locale belge avec son décalage UTC (ex. 2026-10-14T08:00:00+02:00).",
        "type": "string",
        "format": "date-time"
      },
      "end": {
        "description": "Fin, en heure locale belge avec son décalage UTC.",
        "type": "string",
        "format": "date-time"
      },
      "type": {
        "description": "Type d'événement (chantier, rendez-vous, congé, intervention…).",
        "type": [
          "string",
          "null"
        ]
      },
      "siteState": {
        "description": "État de chantier (planifié, validé…), pour le planning.",
        "type": [
          "string",
          "null"
        ]
      },
      "location": {
        "description": "Lieu saisi sur l'événement (masqué pour un événement privé d'autrui).",
        "type": [
          "string",
          "null"
        ]
      },
      "isPrivate": {
        "description": "Vrai pour un événement privé.",
        "type": "boolean"
      },
      "dossierId": {
        "description": "Identifiant du dossier lié (à passer à get_dossier).",
        "type": [
          "integer",
          "null"
        ]
      },
      "dossierReference": {
        "description": "Référence du dossier lié.",
        "type": [
          "string",
          "null"
        ]
      },
      "dossierIndication": {
        "description": "Intitulé court du dossier lié.",
        "type": [
          "string",
          "null"
        ]
      },
      "assignees": {
        "description": "Personnes affectées à cette occurrence.",
        "type": "array",
        "items": {
          "type": "string"
        }
      }
    },
    "required": [
      "id",
      "kind",
      "start",
      "end",
      "isPrivate"
    ]
  },
  "annotations": {
    "title": "Planifier un événement",
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false,
    "readOnlyHint": false
  }
}