Exécuter une tâche et examiner le résultat

Créer une tâche

Ouvrez la page Tâches d'un projet, ou l'onglet Tâches de la console d'une instance, et créez-en une. Vous lui donnez :

• Un titre et une description. Ce qui doit changer, en langage courant. Le détail aide : la même demande accompagnée de deux phrases de contexte donne un bien meilleur plan que la demande seule.
• L'instance dans laquelle travailler. Elle détermine quel code l'agent lit et sur quelle branche le résultat est poussé.
• Des compétences et des pièces jointes, en option. Les compétences sont vos conventions maison, les pièces jointes sont les fichiers que l'agent doit avoir pour le contexte, comme une spécification ou une capture d'écran du problème.

Créer des tâches demande la permission de tâches d'agent. Si l'abonnement du projet est impayé et que le projet est passé en lecture seule, la création de tâches est refusée comme toutes les autres actions.

Viser l'instance de production exige que vous tapiez confirm au moment de créer la tâche, et celle-ci est enregistrée comme tâche de production à partir de là.

Lire le plan

L'agent prend la tâche en charge, lit le code et renvoie un plan. À ce stade, rien n'a encore été modifié.

Lisez le plan lui-même, pas seulement sa première ligne. C'est votre seule occasion de repérer un malentendu avant que du code soit écrit, et le coût de cette lecture est bien inférieur à celui d'un mauvais changement à défaire ensuite.

Puis choisissez :

• Approuver et exécuter : l'agent applique le plan.
• Demander des modifications : décrivez ce qui ne va pas et il replanifie, avec votre retour en main.
• Replanifier : relance la planification telle quelle, utile quand la première tentative a échoué plutôt que dérapé. Replanifier avec des indications fait la même chose avec une note de votre part.
• Annuler la tâche : arrête tout.

Approuver demande la permission d'approbation des plans.

Il arrive que l'agent signale le plan comme bloqué : il a estimé qu'il ne peut pas faire le travail sans risque, ou que la demande n'est pas assez claire. Un plan bloqué attend toujours une personne, même sur un projet où l'exécution automatique est activée.

Ce qui atterrit dans git

Une fois que vous approuvez, l'agent effectue le changement dans le conteneur de l'instance, le committe et le pousse sur la branche de cette instance. Ce push redéploie l'instance, le résultat tourne donc là où vous pouvez le regarder.

Il n'y a pas de pull request. Le commit va directement sur la branche depuis laquelle l'instance est déployée, c'est pourquoi l'instance que vous choisissez compte et pourquoi la production est protégée derrière deux confirmations.

Si l'exécution se termine sans qu'il y ait eu besoin de changer quoi que ce soit, elle le dit au lieu d'inventer un commit.

Quand le résultat n'est pas le bon

Utilisez Lancer un nouveau cycle sur la tâche. Décrivez ce qui ne va pas et l'agent planifie un correctif, en s'appuyant sur le code qu'il a déjà poussé plutôt qu'en repartant de zéro. Vous approuvez le nouveau plan avant que quoi que ce soit ne s'exécute, et le commit existant reste sur la branche.

Les cycles sont comptés sur la tâche, vous pouvez donc voir combien de passages un travail a demandés et ce que chacun a changé.

Quand quelque chose se passe mal

• L'instance ne démarre pas avec ce que l'exécution a committé. CICDoo déplace ces commits sur une branche de secours, réinitialise la branche de l'instance et remet Odoo en route. Rien n'est poussé et rien n'est perdu : le travail est sur la branche de secours si vous en voulez.
• Le push échoue. Le travail reste dans l'arbre de travail du conteneur au lieu de disparaître.
• L'exécution atteint la limite d'usage de votre fournisseur. La tâche se met en pause et vous indique quand la limite est réinitialisée. Reprendre poursuit le plan approuvé à partir de ce point : c'est le même cycle, interrompu, pas un nouveau.
• L'exécution cesse de donner signe de vie. Si un conteneur meurt en plein travail, la tâche est marquée comme échouée plutôt que laissée en suspens indéfiniment. Si l'agent se manifeste en retard après cela, le résultat est tout de même récupéré.

Suivre la consommation

L'onglet Consommation de la tâche liste chaque exécution qui la compose : quel cycle et quelle phase, qui l'a déclenchée, le résultat, les tokens en entrée et en sortie, et le temps que cela a pris. La page /agent agrège tout cela sur l'ensemble des projets, avec des graphiques sur les 30 derniers jours, 90 jours ou 12 mois.

Les nouvelles tentatives et les échecs sont comptés aussi. C'est volontaire : ils consomment du vrai temps d'agent, et une tâche qui a demandé quatre tentatives doit se voir comme telle.

Étapes suivantes

Pour savoir comment ce temps est mesuré et payé, voir Temps d'agent et recharges. Pour activer la fonctionnalité et connecter une CLI, voir Configurer les tâches de l'agent.

Si vous êtes bloqué, ouvrez un ticket de support depuis la page Tickets ou le widget de chat.