Gérer les agents

TeeckIn prend en charge deux types d'agents, selon votre flux de travail :

L'endroit où vous gérez les agents dépend du type :

• -Agents personnels : Paramètres > Agents (dans le contexte personnel)
• -Agents d'organisation : Paramètres de l'organisation > Agents

Vous pouvez créer des agents soit manuellement dans TeeckIn, soit automatiquement pendant le flux OAuth (pour des outils comme Claude Code qui prennent en charge l'authentification dans le navigateur).

Création manuelle (interface)

1. 1Cliquez sur Ajouter un agent
2. 2Sélectionnez le type d'agent (Claude Code, Cursor, etc.)
3. 3Donnez-lui un nom explicite (par ex. « Claude du MacBook de Jordan »)
4. 4Ajoutez éventuellement une description
5. 5Cliquez sur Créer

Création automatique (OAuth dans le navigateur)

Lorsque vous utilisez Claude Code ou d'autres outils qui prennent en charge l'OAuth dans le navigateur, vous pouvez créer un nouvel agent directement dans le flux d'autorisation, sans avoir à passer d'abord par les paramètres de TeeckIn.

L'écran d'autorisation affiche tous vos agents disponibles, regroupés par contexte :

• -Personnel : vos agents personnels + l'option d'en créer un nouveau
• -Organisations : chaque organisation à laquelle vous appartenez avec ses agents + l'option d'en créer un nouveau

Cela vous permet de choisir où le temps doit être suivi (sur votre compte personnel ou sur une organisation précise) directement pendant le flux OAuth.

Pour les outils qui nécessitent une authentification par identifiants client, chaque agent peut avoir jusqu'à . Plusieurs secrets sont utiles pour :

• -La rotation des secrets sans interruption
• -Différentes machines (ordinateur portable du bureau, poste à la maison)
• -Les environnements de CI/CD avec des secrets distincts

Créer des secrets supplémentaires

1. Cliquez sur la carte de l'agent pour la déplier
2. Allez dans l'onglet Secrets
3. Cliquez sur Nouveau secret
4. Ajoutez éventuellement une étiquette (par ex. « Serveur de production »)
5. Copiez immédiatement le nouveau secret : il ne sera plus affiché

Supprimer des secrets

Pour supprimer un secret, trouvez-le dans l'onglet Secrets et cliquez sur Supprimer. Le secret cesse de fonctionner immédiatement. Vous devez conserver au moins un secret.

Cliquez sur le bouton de modification de la carte d'un agent pour changer son nom ou sa description. Le type de l'agent ne peut pas être modifié après la création.

Lorsque vous supprimez un agent :

• -Tous les secrets sont invalidés immédiatement
• +Les pointages sont conservés avec toute leur attribution
• -L'agent est marqué comme inactif et masqué des listes
• +Les agents inactifs ne comptent pas dans les limites du forfait

Les pointages afficheront le nom de l'agent accompagné d'un badge « (Inactif) » dans les vues historiques.

Chaque carte d'agent affiche :

• -Dernière activité : quand l'agent a effectué son dernier appel à l'API
• -Nombre de secrets : combien de secrets actifs existent

Chaque secret indique sa dernière utilisation, ce qui vous aide à repérer et nettoyer les identifiants inutilisés.

Journal d'activité

Dépliez la carte d'un agent et cliquez sur l'onglet Journal d'activité pour voir un historique détaillé des actions de l'agent. Cela inclut :

• -Les événements de démarrage/arrêt du Timer
• -Les mises à jour des pointages
• -Les tentatives d'authentification
• -Les adresses IP (pour la surveillance de sécurité)

Les propriétaires et administrateurs peuvent configurer les paramètres des agents à l'échelle de l'organisation depuis la page de paramètres des Agents :

• -Conseils de sélection des Topics : aidez les agents à comprendre comment choisir le bon Topic en fonction du travail qu'ils réalisent
• -Taux horaire par défaut de l'agent : définissez un taux par défaut pour les heures d'agent lorsqu'elles sont incluses sur les factures
• -Inclure les heures d'agent sur les factures : contrôlez si les heures d'agent sont incluses par défaut lors de la création des factures

Par défaut, les heures d'agent ne sont pas incluses sur les factures. Lors de la création d'une facture, vous pouvez choisir de :

• -Exclure entièrement les heures d'agent (par défaut)
• -Les inclure au taux d'agent par défaut de l'organisation
• -Les inclure à un taux personnalisé pour cette facture

Chaque pointage créé par un agent est automatiquement associé à l'identité de l'agent. Cette attribution vous aide à :

• -Suivre le travail assisté par IA : savoir précisément quelles entrées ont été créées par des agents plutôt que par des humains
• -Respecter la conformité d'audit : conserver des relevés clairs de l'implication de l'IA dans votre travail
• -Prendre des décisions de facturation : identifier facilement les heures d'agent lors de la préparation des factures

Le nom de l'agent apparaît sur les pointages dans le calendrier, l'historique du Timer et les écrans de facturation. Même si un agent est supprimé par la suite, l'attribution est conservée en affichant « Agent supprimé » dans les relevés historiques.

Lorsque vous exportez vos données, les agents sont inclus pour des raisons d'exactitude historique :

• -Métadonnées de l'agent : le nom, le type et la configuration sont exportés
• -Attribution des pointages : l'agent ayant créé chaque entrée est conservé
• -Secrets : non exportés (sécurité)

À l'import

Les agents sont importés comme inactifs, car les secrets ne peuvent pas être transférés. Cela garantit que :

• +L'attribution historique est conservée avec précision
• +Les pistes d'audit restent intactes
• -Les agents importés ne peuvent pas s'authentifier tant qu'ils ne sont pas réactivés

La vue calendrier propose des options de filtrage pour séparer le travail des humains et celui des agents :

• -Tous : affiche tous les pointages, des humains comme des agents
• -Humains : affiche uniquement les entrées des membres humains de l'équipe
• -Agents : affiche uniquement les entrées des agents IA

Accédez à ces filtres en cliquant sur l'icône de filtre dans la barre d'outils du calendrier. Vous pouvez aussi les combiner avec les filtres par membre et par groupe.