Que fait log_work ?
Un agent n’a pas besoin de chercher des identifiants avant de saisir. Il appelle directement log_work avec une description et ce qu’il sait par ailleurs. Half5 retrouve le client, le projet et l’activité, ou pose une question en cas de doute.
La saisie arrive à votre nom avec le statut « Pas encore approuvé ». Le contrôle reste ainsi entre vos mains ou celles de votre valideur, même quand c’est l’agent qui a rempli la saisie. Pour connecter un agent, voyez Saisir ses heures avec Claude, ChatGPT ou Cursor.
Quels champs l’agent transmet-il ?
Seule la description est obligatoire. Le reste aide Half5 à choisir le bon client et la bonne durée. Si un champ manque, Half5 ne le remplit pas au hasard.
| Champ | Obligatoire | Contenu |
|---|---|---|
description | Oui | Une ligne de 3 à 500 caractères lisible par un client, dans votre langue, sans noms de fichiers ni de classes. Elle peut figurer sur une facture. |
date | Non | today, yesterday ou une date (AAAA-MM-JJ). Sans date, c’est aujourd’hui. |
minutes | Non | Durée en minutes, de 1 à 1 440. À omettre si la durée n’est pas connue. |
start_time, end_time | Non | Heure de début et de fin au format HH:MM. |
customer, project, activity | Non | Nom, nom commercial ou référence. Un projet détermine aussi le client. |
repository | Non | Remote Git, propriétaire/dépôt ou nom du dossier. Jamais un chemin local complet. |
branch, commit_subjects | Non | La branche et jusqu’à 10 titres de commits, comme indices supplémentaires pour le client et le projet. |
session_id | Non | L’identifiant de session de l’agent, seulement s’il le connaît vraiment. |
Quels sont les résultats possibles ?
Chaque appel se termine par l’un de quatre statuts. Chacun demande une réaction différente de l’agent.
| Résultat | Signification | Ce que fait l’agent |
|---|---|---|
created | La saisie est enregistrée, en statut non approuvé. | Vous dit en une phrase ce qui a été saisi et pourquoi sur ce client. |
preview | Un essai à blanc : voici ce qui serait saisi. Rien n’est enregistré. | Vous montre la proposition. |
needs_confirmation | Half5 a un doute, par exemple sur le client, ou la durée manque (question sur la durée avec une proposition). | Vous pose la question et ne saisit qu’après votre choix, avec exactement l’option choisie. |
duplicate | Le même travail est déjà saisi. | Ne le saisit pas une seconde fois. |
Sans durée, Half5 n’enregistre rien. La proposition va par exemple de la fin de votre dernière saisie du jour jusqu’à maintenant ; vous la confirmez ou l’ajustez.
Comment Half5 choisit-il le client et le projet ?
D’abord le client, puis le projet au sein de ce client. Half5 pèse les indices disponibles et ne saisit directement que si un client ressort clairement. Sinon, l’agent vous demande de choisir parmi vos combinaisons récentes de client et de projet.
- Ce que vous indiquez. Un client ou un projet nommé l’emporte sur tout le reste.
- Votre mémoire des dépôts. Half5 retient, pour chaque utilisateur, quel dépôt appartient à quel client, à partir des saisies que vous avez confirmées ou déplacées.
- Le nom du dépôt. Comparé aux noms (commerciaux), étiquettes et domaines e-mail de vos clients, ainsi qu’aux noms de projets.
- Votre propre historique. Les descriptions précédentes qui mentionnent le dépôt, la branche ou un numéro de ticket, et les clients sur lesquels vous saisissez souvent et récemment.
- La description, la branche et les commits. Comme indice supplémentaire, pas comme décision.
Comment fonctionne la mémoire des dépôts ?
Cette mémoire vous appartient. Quand vous saisissez via un agent, déplacez une telle saisie vers un autre client ou enregistrez du travail d’agent dans l’application de bureau, Half5 retient quel dépôt appartient à quel client. La fois suivante, l’agent n’a pas besoin de demander.
Si la description cite clairement un autre client que votre mémoire, Half5 ne saisit pas à l’aveugle : l’agent vous demande lequel des deux est le bon. Avec le paramètre d’organisation « Apprendre de collègues », Half5 peut aussi suggérer un client sur lequel un collègue a saisi le même dépôt. Cela reste une suggestion ; l’agent vous demande toujours d’abord, et votre propre mémoire prime.
Quels outils existent à côté de log_work ?
Le serveur propose cinq outils. Tous agissent uniquement sur vos propres heures, avec les clients, projets et activités que vous avez le droit de voir dans votre organisation.
| Outil | Rôle | Limites |
|---|---|---|
log_work | Saisir du travail | Les nouvelles saisies arrivent en statut non approuvé |
search_customers_projects | Chercher clients, projets et activités par nom, nom commercial, étiquette ou domaine e-mail | Lecture seule ; inutile avant log_work |
list_entries | Afficher vos propres saisies avec les totaux par jour | Lecture seule ; 31 jours maximum à la fois |
update_entry | Modifier une de vos saisies | Uniquement les saisies pas encore validées, et seulement à votre demande |
delete_entry | Supprimer une de vos saisies | Uniquement les saisies pas encore validées, après confirmation |
Une fois une saisie validée, l’agent ne peut plus la modifier. Cela se fait dans Half5.
Comment Half5 s'y prend
Dans Paramètres → « Agents liés », vous voyez pour chaque connexion le nom du client, s’il est vérifié, sa dernière utilisation et ce qu’il peut faire (voir les heures, saisir des heures). « Dissocier » retire son accès.
La même page affiche votre « Mémoire du dépôt ». Vous effacez une association avec « Oublier … », ou repartez de zéro avec « Tout oublier ». Le traitement de ces données est décrit dans Confidentialité et agents IA.
Questions fréquentes
L’agent doit-il appeler search_customers_projects avant de saisir ?
Non. log_work retrouve lui-même le client et le projet. L’outil de recherche sert à des questions comme « quels projets a ce client ? » ou à lever l’ambiguïté d’un nom.
Que se passe-t-il si l’agent envoie deux fois la même saisie ?
Half5 reconnaît la même saisie et renvoie duplicate au lieu d’en créer une seconde. L’agent ne doit alors pas saisir à nouveau.
L’agent transmet-il mon code ou mes noms de fichiers ?
Il ne devrait pas. Le serveur demande explicitement aux agents de ne jamais envoyer de chemins de fichiers ni de code ; la description est une ligne lisible par un client, et le dépôt n’est transmis que par son nom.
La mémoire d’un collègue peut-elle décider sur quel client vont mes heures ?
Non. La mémoire d’un collègue donne au mieux une suggestion, et seulement si « Apprendre de collègues » est activé. L’agent vous pose alors d’abord la question.
L’agent peut-il encore modifier des heures validées ?
Non. update_entry et delete_entry ne fonctionnent que sur vos propres saisies pas encore validées. Les heures validées se modifient dans Half5.
