Créer votre premier pipeline

Ce que vous allez créer

À la fin de ce tutoriel, vous disposerez de :

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

Prérequis : Lancer votre premier agent terminé, de sorte que vous ayez un agent avec un adaptateur et un modèle.

Un pipeline est un DAG d’étapes. Les modèles définissent le graphe ; les exécutions en sont le déroulement. Pour le modèle sous-jacent, lisez Pipelines et automatisation ; pour le vocabulaire complet des étapes, Étapes de pipeline.

Étape 1 : Créer un modèle

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

L’éditeur s’ouvre sur un squelette prérempli 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 arrive pré-câblé en Trigger → Step → terminal, où « Step » est un nœud d’agent à 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 : « Passez en revue le code de la branche actuelle pour y détecter des problèmes de qualité. Listez ce que vous trouvez. »
3. Laissez Triggers from 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 mention « 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. »

Ce n’est pas facultatif, et c’est facile à manquer. Un nouveau modèle est créé avec 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 à lancer. L’interrupteur écrit le déclencheur immédiatement ; il n’attend pas un nouvel enregistrement.

Le même interrupteur se cache 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, il n’y a donc rien à renseigner

Point de contrôle. Une notification confirme le démarrage de l’exécution 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 lorsque 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 que l’étape a menée

Point de contrôle. L’étape s’affiche comme terminée et sa sortie contient la revue 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 nœud pour les relier, ou sélectionnez le nouveau nœud et cochez son étape amont sous Triggers from.

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

Récapitulatif

Vous avez créé un modèle, configuré le nœud d’agent à prompt avec lequel il a été prérempli, l’avez enregistré, l’avez rendu exécutable à la main, avez lancé une exécution et lu l’entrée et la sortie de l’étape.

Les pipelines deviennent bien plus grands que cela — routeurs conditionnels, branches parallèles, nœuds de jonction, éventail for-each, portails humains — mais la forme ne change jamais : des étapes dans un DAG, qui transmettent l’état.

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

• Configurer des déclencheurs de pipeline pour lancer des pipelines depuis des événements ou une planification
• Pipelines et automatisation pour le modèle sous-jacent
• Étapes de pipeline pour chaque type d’étape