Créer votre premier pipeline

Ce que vous allez créer

À la fin de ce tutoriel, vous aurez :

• Un modèle de pipeline enregistré qui lance un agent avec un prompt
• Les exécutions manuelles activées sur ce modèle, pour pouvoir le démarrer à la main
• Une exécution terminée, avec l’entrée et la sortie de l’étape visibles

Prérequis : avoir terminé Lancer votre premier agent, de sorte que vous disposiez d’un agent muni d’un adaptateur et d’un modèle.

Un pipeline est un DAG d’étapes. Les modèles définissent le graphe ; les exécutions le mettent en œuvre. Pour le modèle qui le sous-tend, lisez Pipelines et automatisation ; pour le vocabulaire complet des étapes, Types d’étapes de pipeline.

Étape 1 : Créer un modèle

1. Allez dans Paramètres → Espace de travail → Modèles de pipeline
2. Cliquez sur Nouveau modèle

L’éditeur s’ouvre sur un squelette amorcé nommé Nouveau pipeline (id pipeline_N). Cliquez sur le titre dans l’en-tête et renommez-le — pour ce tutoriel, code_quality_check est un bon nom. Il n’y a ni boîte de dialogue d’id ni champ de description.

Le canevas n’est pas vide. Un nouveau modèle est livré précâblé sous la forme Trigger → Step → terminal, où « Step » est un nœud d’agent de prompt et le terminal est une sentinelle invisible que l’éditeur recâble vers chaque puits atteignable.

Vous configurez le Step déjà présent.

Étape 2 : Configurer l’étape

1. Cliquez sur le nœud Step du canevas
2. Dans le panneau Configuration du nœud à droite, définissez :
   • Agent : votre agent du tutoriel précédent
   • Modèle de prompt : « Examinez le code de la branche actuelle pour déceler des problèmes de qualité. Énumérez ce que vous trouvez. »
3. Laissez Déclencheurs depuis tel quel — le nœud est déjà câblé pour se déclencher après Trigger

Étape 3 : Enregistrer

Appuyez sur Enregistrer dans l’en-tête de l’éditeur.

Point de contrôle. La légende « Modifications non enregistrées » disparaît.

Étape 4 : Autoriser les exécutions manuelles

1. Cliquez sur la tuile en pointillés Ajouter un déclencheur du canevas (ou faites glisser Exécution manuelle depuis la section Déclencheurs de la bibliothèque de nœuds) et choisissez Exécution manuelle.
2. Sélectionnez ce nœud. Dans l’inspecteur à droite, activez Activé — « Afficher sur la page d’exécution et lancer à la main. »

Cette activation n’est pas facultative et il est facile de l’oublier. Un nouveau modèle est créé sans aucune ligne de déclencheur, donc tant que vous ne l’activez pas, la page d’exécution ne le listera pas et il n’y aura rien à démarrer. L’interrupteur écrit le déclencheur immédiatement ; il n’attend pas un autre enregistrement.

Le même interrupteur se trouve derrière Exécution manuelle dans l’en-tête de l’éditeur, aux côtés des entrées déclarées du modèle.

Étape 5 : L’exécuter

1. Cliquez sur Pipelines dans la barre latérale
2. Cliquez sur Exécuter le pipeline dans l’en-tête
3. Choisissez code_quality_check dans le rail de gauche
4. Cliquez sur Exécuter le pipeline dans le formulaire — votre modèle ne déclare aucune entrée, donc il n’y a rien à remplir

Point de contrôle. Une notification confirme que l’exécution a démarré et Control Center ouvre le détail de l’exécution.

Le moteur crée l’enregistrement de l’exécution, termine le déclencheur, planifie l’étape, lance l’agent et termine l’exécution quand la branche entrante du terminal se termine.

Étape 6 : Inspecter le résultat

Cliquez sur l’étape dans l’exécution pour ouvrir son panneau de détail :

• Les horodatages Démarré et Terminé, et la Durée
• Entrée : l’état transmis à l’étape
• Sortie : ce qu’elle a produit — ici, la réponse de l’agent
• Activité de l’agent, avec un lien vers la conversation menée par l’étape

Point de contrôle. L’étape est indiquée comme terminée et sa sortie contient la révision de l’agent.

Ajouter d’autres étapes

Les nœuds s’ajoutent en faisant glisser une entrée de la bibliothèque de nœuds, à gauche, sur le canevas, ou en appuyant sur Ajouter une étape (+) juste après un nœud. Faites glisser depuis le port de sortie d’un nœud vers un autre pour les relier, ou sélectionnez le nouveau nœud et cochez son étape en amont sous Déclencheurs depuis.

Le nœud terminal n’est pas dessiné et ne peut pas être sélectionné. L’éditeur le recâble vers chaque puits atteignable, de sorte qu’un nœud que vous ajoutez après le Step amorcé s’exécute quand même.

Récapitulatif

Vous avez créé un modèle, configuré le nœud d’agent de prompt amorcé à sa création, l’avez enregistré, l’avez rendu exécutable à la main, avez lancé une exécution et avez consulté l’entrée et la sortie de l’étape.

Les pipelines peuvent devenir bien plus imposants que cela — routeurs conditionnels, branches parallèles, nœuds de jonction, déploiement en éventail for-each, validations humaines — mais la forme ne change jamais : des étapes dans un DAG, qui transmettent l’état.

Suivant : Relier Slack à votre espace de travail, le dernier tutoriel de cette séquence.

• Configurer des déclencheurs de pipeline pour démarrer des pipelines à partir d’événements ou d’une planification
• Pipelines et automatisation pour le modèle qui les sous-tend
• Types d’étapes de pipeline pour chaque type d’étape