Créer et gérer vos agents IA

Aperçu

Configurez des agents IA qui réagissent à l'activité de vos projets et créent des tâches, ajoutent des commentaires ou envoient des e-mails d'eux-mêmes, à partir des instructions que vous rédigez.

Un agent se compose de quatre éléments, qui ont chacun un rôle différent :

• Les Instructions indiquent à l'agent ce qu'il doit faire, avec vos propres mots et avec autant de détails que vous le souhaitez. C'est là que le travail réel est décrit.
• Les Déclencheurs déterminent quand l'agent commence à vérifier. Ils ne déterminent pas s'il agit.
• Les Actions fixent la limite de ce que l'agent est autorisé à faire. Elles ne déterminent pas ce qu'il fait.
• Le Projet est le seul projet que l'agent surveille, et les seules données qu'il peut lire.

Les déclencheurs et les actions posent le cadre ; les instructions font le travail à l'intérieur. Par exemple, pour qu'un agent commente lorsqu'une tâche est résolue, donnez-lui le déclencheur Tâche mise à jour afin qu'il vérifie à chaque modification d'une tâche, et indiquez dans les instructions qu'il ne doit agir que lorsque le statut devient Résolu.

Voici les événements qu'un agent peut utiliser comme déclencheurs :

• Tâche créée
• Tâche mise à jour
• Commentaire ajouté à la tâche
• Fichier téléchargé (dans Documents)
• Nouvelle version du fichier (dans Documents)

Un agent lit toujours les tâches et les documents de son projet pour trouver les informations dont il a besoin. Il fonctionne avec les autorisations de l'utilisateur qui l'a créé et qui en est le propriétaire. Gardez-le à l'esprit si vous avez des informations confidentielles dans des tâches ou des documents, et précisez clairement dans les instructions ce que l'agent doit faire et partager, et ce qu'il ne doit pas faire.

Voici les actions qu'un agent peut être autorisé à effectuer :

• Créer une tâche
• Ajouter un commentaire (dans une tâche)
• Envoyer un e-mail (aux membres du projet)

Tout ce qu'un agent crée porte son nom : une tâche ou un commentaire qu'il rédige affiche le nom de l'agent au nom de la personne qui l'a créé. En savoir plus dans Recognise Work Done by AI Agents.

Vous pouvez également définir des instructions globales à l'échelle du compte qui s'appliquent à tous les agents, et gérer les notifications des agents pour l'ensemble du compte. En savoir plus dans Configure AI Agents for your Account.

Non pris en charge dans la version actuelle :

• Modifier ou supprimer des tâches, des documents ou des plans existants. Un agent ne fait que créer.
• S'exécuter selon une planification. Un agent réagit uniquement aux événements de son projet.
• Travailler sur plusieurs projets. Chaque agent s'exécute dans un seul projet : créez un agent par projet à couvrir.
• Envoyer des e-mails à des personnes extérieures au projet. Les e-mails ne peuvent être envoyés qu'aux membres du projet.

Cette fonctionnalité consomme votre limite d'utilisation de l'IA. En savoir plus dans Limites d'utilisation de l'IA et mises à niveau.

En savoir plus sur Protection de la vie privée et sécurité pour les fonctionnalités de l'IA.

Accès aux agents IA

1. Cliquez sur Agents IA

Vous voyez les agents de votre compte :

Créer un agent

Un agent a besoin de quatre éléments avant de pouvoir s'exécuter : des instructions, un projet, au moins un déclencheur et au moins une action. Jusqu'à ce que tous soient en place, l'agent reste un brouillon, et un brouillon ne s'exécute jamais.

Vous pouvez rédiger un agent de zéro ou partir de l'un des quatre modèles fournis avec votre compte.

De zéro

Pour créer un nouvel agent sans modèle :

1. Cliquez sur Créer un nouvel agent
   
2. Rédigez les instructions, p. ex. Créer des sous-tâches à partir des commentaires signalant des travaux inachevés
   En savoir plus ci-dessous dans Rédiger les instructions.
3. Cliquez sur Suivant
   
4. Ajouter un Projet, des Déclencheurs et des Actions
   En savoir plus ci-dessous dans Définir le projet, Définir les déclencheurs et Définir les actions.
   
5. Cliquez sur Vérifier et tester
   
6. Cliquez sur Exécution test
   En savoir plus ci-dessous dans Tester l'agent.
   
7. Cliquez sur Activer l'agent
   En savoir plus ci-dessous dans Activer l'agent.
   

À partir d'un modèle

Quatre agents prêts à l'emploi sont fournis avec votre compte. Chacun est entièrement rédigé, avec ses instructions, son déclencheur et ses actions déjà définis : il ne manque que le projet.

Pour créer un agent à partir d'un modèle :

1. Cliquez sur Créer un nouvel agent
   
2. Sous Nos modèles, cliquez sur le modèle que vous souhaitez utiliser
   
3. Cliquez sur Ajouter sous Projet
   
4. Sélectionnez le projet
5. Cliquez sur Enregistrer
   
6. Vérifiez le Nom de l'agent, la Description et les Instructions, et modifiez-les si vous le souhaitez.
7. Cliquez sur Exécution test
   
8. Cliquez sur Activer l'agent
   

Configurer et modifier un agent

Tout ce dont un agent a besoin se définit sur son propre écran : nom, description, instructions, projet, déclencheurs et actions.

Pour modifier un agent à l'état de brouillon :

1. Cliquez sur l'agent
   

Pour modifier un agent actif ou en pause :

1. Cliquez sur l'agent
   
2. Cliquez sur Modifier l'agent
   

Les agents archivés ne peuvent pas être modifiés. Vous devez d'abord les restaurer.

L'écran de l'agent est le même que vous créiez un nouvel agent ou que vous en modifiiez un existant. Vous pouvez y ajouter ou modifier les éléments suivants :

1. Nom de l'agent (doit être unique : si le nom est déjà pris, un numéro est ajouté)
2. Description
3. Instructions – en savoir plus ci-dessous dans Rédiger les instructions
4. Projet – en savoir plus ci-dessous dans Définir le projet
5. Déclencheurs – en savoir plus ci-dessous dans Définir les déclencheurs
6. Actions – en savoir plus ci-dessous dans Définir les actions

L'écran de l'agent, avec le panneau Testing à droite :

L'enregistrement des modifications ne change pas le statut de l'agent. Les agents restent en brouillon, en pause ou actifs.

Rédiger les instructions

Les instructions sont le cœur de l'agent : tout ce qu'il fait en découle. Rédigez-les comme vous expliqueriez la tâche à un collègue.

Par exemple :

• « Lorsqu'une tâche est créée sans date d'échéance, ajoute un commentaire pour la demander. »
• « Lorsqu'une tâche passe à Résolu, vérifie les photos et commente si la correction n'est pas documentée. »

Pour rédiger les instructions :

1. Dans Instructions, décrivez ce que l'agent doit faire.
   
2. Facultatif : cliquez sur Réécrire à l'aide de l'IA pour obtenir une suggestion de l'IA reformulant vos instructions plus clairement.
   
3. Facultatif : vous pouvez conserver la suggestion, l'annuler avec Annuler ou rédiger votre propre version.
   

Les instructions peuvent comporter jusqu'à 4 000 caractères.

Pour agrandir le champ de saisie des instructions :

1. Cliquez sur l'icône Développer
   

Pour réduire le champ de saisie agrandi :

1. Cliquez sur l'icône Réduire
   

Définir le projet

Un agent s'exécute dans un seul projet et ne lit jamais rien en dehors de celui-ci.

Pour modifier le projet :

1. Sous Projet, cliquez sur Modifier
   
2. Sélectionnez le projet dans lequel l'agent s'exécute
3. Cliquez sur Enregistrer
   

Définir les déclencheurs

Un déclencheur est l'événement qui lance une exécution. Un agent peut avoir plusieurs déclencheurs et s'exécute dès que l'un des événements définis se produit.

Pour modifier les déclencheurs :

1. Sous Déclencheurs, cliquez sur Modifier
   
2. Sous Source, choisissez si l'agent réagit aux Tâches ou aux Documents.
   
3. Sous Événement, choisissez l'événement qui lance l'exécution.
   
4. Cliquez sur Enregistrer
   

Chaque déclencheur correspond à une source et un événement :

Pour ajouter d'autres déclencheurs :

1. Cliquez sur + Ajouter un déclencheur
2. Sélectionnez une Source et un Événement comme décrit ci-dessus
   

Vous pouvez restreindre un déclencheur avec le Périmètre, afin que l'agent ne réagisse qu'à une partie du projet :

• Les déclencheurs de tâches peuvent être limités à un Niveau, un Formulaire, ou les deux.
• Les déclencheurs de documents peuvent être limités à un Dossier.

Pour limiter le périmètre d'un déclencheur de tâches :

1. Cliquez sur Paramètres avancés
2. Sélectionnez un Niveau et/ou un Formulaire
   

Pour limiter le périmètre d'un déclencheur de documents :

1. Cliquez sur Paramètres avancés
2. Sélectionnez un Dossier
   

Un déclencheur de documents surveille un dossier, et non un fichier unique. Pour qu'un agent réagisse à un document précis, déplacez-le dans son propre dossier et limitez le déclencheur à ce dossier.

Un déclencheur détermine quand l'agent regarde, pas s'il agit. Tâche mise à jour se déclenche à chaque modification d'une tâche ; si l'agent ne doit agir que dans certains cas, précisez-le dans les instructions, par exemple « n'agis que lorsque le statut devient Résolu ». L'agent lit l'événement, le compare à vos instructions et ne fait rien s'il ne s'applique pas.

Les événements de tâches comptent où qu'ils se produisent : une tâche créée dans l'application mobile lance l'agent tout autant qu'une tâche créée dans la Webapp.

Les déclencheurs de documents sont disponibles pour les comptes avec Gestion des documents.

Définir les actions

Les actions sont ce que l'agent est autorisé à écrire. Ajoutez celles dont il a besoin ; l'agent décide lui-même quand utiliser chacune d'elles, en fonction de vos instructions. Chaque action ne peut être ajoutée qu'une fois.

Pour modifier les actions :

1. Sous Actions, cliquez sur Modifier
   
2. Cliquez sur Ajouter une action
3. Cliquez sur Créer une tâche, Ajouter un commentaire ou Envoyer un e-mail.
   
4. Facultatif : renseignez les paramètres que l'agent doit toujours utiliser.
   Pour Créer une tâche, vous pouvez définir : Niveau, Formulaire. Et sous Définir des valeurs spécifiques pour les champs : Titre, Attributaire, Priorité, Statut
   Pour Envoyer un e-mail, vous pouvez définir : À, CC, Objet
5. Cliquez sur Enregistrer
   

Tester l'agent

Le panneau Testing liste les quatre éléments dont l'agent a besoin et coche chacun d'eux à mesure que vous les complétez. Une fois les quatre en place, vous pouvez lancer un test.

Une exécution test lit les données réelles de votre projet mais n'écrit rien. Le résultat vous montre ce que l'agent aurait créé, commenté ou envoyé. Rien n'est créé ni modifié dans votre projet. Vous pouvez tester les modifications avant de les enregistrer.

Pour tester un agent :

1. Dans le panneau Testing, cliquez sur Exécution test.
   
2. Lisez ce que l'agent aurait fait.

Un test qui se termine sans que l'agent fasse quoi que ce soit est un résultat normal. Cela signifie que l'agent a estimé qu'aucune action n'était nécessaire.

Un test consomme votre limite d'utilisation de l'IA, comme une exécution réelle.

Activer l'agent

Un agent ne commence à travailler qu'une fois que vous l'activez.

Pour activer un agent :

1. Cliquez sur Activer l'agent
   

L'agent apparaît comme Actif dans la liste et s'exécute dès lors chaque fois que l'un des événements définis dans les déclencheurs se produit.

Pour conserver l'agent sans l'activer, cliquez plutôt sur Enregistrer comme brouillon. Un brouillon ne s'exécute jamais, et vous pouvez revenir l'activer à tout moment.

Enregistrer l'agent comme brouillon au lieu de l'activer :

Chaque exécution de l'agent est enregistrée. Ouvrez le Journal d'activité pour voir ce qu'il a fait et pourquoi. En savoir plus dans Monitor AI Agents in the Activity Log.

Gérer vos agents

• Toute personne disposant de l'autorisation utilisateur Agents IA voit les agents qui s'exécutent dans les projets auxquels elle a accès, y compris les agents créés par un collègue. Il en va de même pour Agents archivés et le Journal d'activité.
• La personne qui crée un agent en est le propriétaire, et elle seule peut le modifier, le tester, l'activer, le mettre en pause, l'archiver, le restaurer ou le supprimer.

Dupliquer

La duplication crée votre propre copie d'un agent, dont vous êtes propriétaire et que vous pouvez modifier. Vous pouvez dupliquer tout agent que vous voyez, y compris celui d'un collègue : c'est ainsi que vous réutilisez l'agent de quelqu'un d'autre, ou que vous appliquez le même comportement à un second projet.

Pour dupliquer un agent :

1. Ouvrez le menu Plus de l'agent
2. Cliquez sur Dupliquer l'agent
   

La copie porte le nom de l'original suivi de (copy) et démarre en brouillon. Modifiez le projet ou ce dont vous avez besoin, puis testez-la et activez-la.

Mettre en pause

La mise en pause arrête l'exécution de l'agent et conserve tous ses paramètres, afin que vous puissiez le réactiver quand vous le souhaitez.

Pour mettre un agent en pause :

1. Ouvrez-le depuis la liste des agents
   
2. Ouvrez le menu Plus
3. Cliquez sur Mettre l'agent en pause
   

Archiver et restaurer

L'archivage déplace l'agent vers Agents archivés et arrête son exécution, sans rien supprimer.

Pour archiver un agent :

1. Ouvrez le menu Plus de l'agent
2. Cliquez sur Archiver l'agent
   

Pour restaurer un agent :

1. Cliquez sur Agents archivés
2. Ouvrez le menu Plus de l'agent
3. Cliquez sur Restaurer l'agent
   

Les agents restaurés sont toujours en pause. Activez-les quand vous êtes prêt.

Supprimer

Ne supprimez un agent que si vous êtes sûr de ne jamais vouloir le restaurer. Si vous n'êtes pas sûr, archivez-le. Ses exécutions restent dans le Journal d'activité, vous pouvez donc toujours voir ce qu'il a fait.

Pour supprimer un agent :

1. Ouvrez le menu Plus de l'agent
2. Cliquez sur Supprimer l'agent
   
3. Cliquez sur Supprimer pour confirmer
   

Lorsqu'un agent se met en pause tout seul

Un agent se met en pause tout seul dans les cas suivants :

• Votre compte a atteint sa limite d'utilisation de l'IA.
• Les exécutions ont échoué de façon répétée parce que le contenu envoyé au modèle d'IA était trop volumineux. Raccourcissez les instructions, ou orientez l'agent vers des formulaires plus petits ou moins de documents.
• L'agent a atteint sa limite d'actions au cours d'une même exécution.
• Le projet de l'agent a été archivé ou supprimé.
• Trop d'exécutions ont démarré en peu de temps.
• Le propriétaire de l'agent a été désactivé, a perdu l'autorisation Agents IA, ou a perdu l'accès au projet.

Vous recevez une notification, et l'agent reste en pause jusqu'à ce que vous le réactiviez.

Il est possible de désactiver les notifications d'échec d'exécution d'un agent ou de mise en pause automatique pour l'ensemble du compte. En savoir plus dans Configure AI Agents for your Account.

Un agent ne redémarre jamais de lui-même. Survolez le statut En pause pour voir pourquoi il s'est arrêté.