Actif ai functional Revu le 2026-07-30 ai/ai-tool-calling-time-pack.md

Outils IA — Pack Time (Gestion des temps CRM)

À quoi ça sert

Le pack time permet aux assistants IA d'ISI-APP de gérer la saisie de temps CRM par conversation. C'est le premier pack d'outils IA à introduire des opérations d'écriture : créer, modifier, supprimer un temps depuis un dialogue avec l'IA, sans passer par les formulaires habituels.

Concrètement, un utilisateur peut demander à son assistant : « Saisis-moi 2 heures hier sur la mission Alpha, catégorie Dev » et l'IA exécute la saisie.

Outils disponibles

Outil	Action	Rôle
`times_search`	Lecture	Rechercher des temps avec filtres (utilisateur, mission, catégorie, dates, statut)
`time_get`	Lecture	Consulter le détail d'un temps précis
`time_create`	Création	Saisir un nouveau temps
`time_update`	Modification	Modifier un temps existant
`time_delete`	Suppression	Supprimer un temps

Comment l'utiliser

Le pack time s'active sur un assistant IA depuis /admin/ai (formulaire d'assistant, section Outils IA disponibles). Pré-requis : l'utilisateur doit avoir le module b2b activé.

Cas d'usage typiques

« Liste mes temps de la semaine dernière »
« Combien de temps ai-je passé sur la mission X ce mois-ci ? »
« Saisis 3h aujourd'hui sur la mission Alpha, catégorie Réunion »
« Supprime le temps que j'ai saisi hier par erreur »
« Modifie mon temps de ce matin pour passer de 2h à 4h »

Périmètre de visibilité

Utilisateur standard : ne voit et ne manipule que ses propres temps.
Administrateur d'équipe (crm_param.is_admin = 1) : voit et peut agir sur ses temps et ceux des utilisateurs des équipes qu'il administre.

Règles métier (écriture)

Action	Règle
Créer un temps pour soi	Toujours autorisé
Créer un temps pour quelqu'un d'autre	Droit de création requis (module 62100101)
Modifier son propre temps	Autorisé tant que le temps n'est pas validé (`tpstate ≠ VAL`)
Modifier le temps de quelqu'un d'autre	Droit de modification requis
Supprimer son propre temps	Autorisé uniquement si le temps est en cours de programmation (`tpstate = PROG`)
Supprimer le temps d'autrui	Droit de suppression requis

Synchronisation Outlook

Si l'utilisateur a connecté son compte Microsoft (Graph), les temps saisis via l'IA sont automatiquement publiés sur son calendrier Outlook, comme via les formulaires classiques. Le type d'événement Outlook dépend du type de temps :

Type de temps	Apparence dans Outlook
Absent	Absent du bureau
Occupé	Occupé
Provisoire	Provisoire / À confirmer
(vide)	Disponible

Les modifications (mise à jour, suppression) sont également propagées à Outlook.

Si la synchronisation Outlook échoue, la saisie en base reste effective : le temps est bien enregistré. L'assistant vous l'annonce alors explicitement, en précisant la cause — connexion Outlook expirée (il faut reconnecter Outlook depuis votre profil), ou refus signalé par Microsoft. Vous n'avez donc pas à ressaisir le temps : seule la publication dans l'agenda est à reprendre.

Comportements automatiques

À chaque création/modification/suppression d'un temps, les totaux de la mission concernée sont recalculés automatiquement (idem flow historique).
En cas de changement de mission lors d'une modification, les totaux de l'ancienne et de la nouvelle mission sont recalculés.

Limitations connues (MVP)

Pas de récurrence : impossible de demander à l'IA « saisis 2h tous les lundis du mois ». À gérer via les formulaires classiques.
Pas d'envoi d'email de validation d'absence depuis l'IA — ce mail n'est déclenché que par les formulaires.
Pas de validation administrative d'un temps via l'IA — la validation passe par l'interface admin standard.

Doc technique : .claude/technical-docs/ai/ai-tool-calling-time-pack.md