Crea la tua prima pipeline

Che cosa creerai

Al termine di questo tutorial avrai:

• Un modello di pipeline salvato che invia un agente con un prompt
• Le esecuzioni manuali attivate su di esso, così da poterlo avviare a mano
• Un’esecuzione completata, con l’input e l’output del passaggio visibili

Prerequisiti: Invia il tuo primo agente completato, così da avere un agente con un adattatore e un modello.

Una pipeline è un DAG di passaggi. I modelli definiscono il grafo; le esecuzioni lo mettono in atto. Per il modello che sta dietro, leggi Pipeline e automazione; per il vocabolario completo dei passaggi, Tipi di passaggio delle pipeline.

Passaggio 1: crea un modello

1. Vai in Impostazioni → Spazio di lavoro → Modelli di pipeline
2. Fai clic su Nuovo modello

L’editor si apre su uno scheletro preimpostato chiamato Nuova pipeline (id pipeline_N). Fai clic sul titolo nell’intestazione e rinominalo — per questo tutorial, code_quality_check è un buon nome. Non c’è alcuna finestra di dialogo per l’id e nessun campo per la descrizione.

Il canvas non è vuoto. Un nuovo modello arriva pre-cablato come Trigger → Step → terminal, dove «Step» è un nodo agente con prompt e il terminal è una sentinella invisibile che l’editor ricollega a ogni sink raggiungibile.

Il passaggio che devi configurare è lo Step già presente.

Passaggio 2: configura il passaggio

1. Fai clic sul nodo Step sul canvas
2. Nel pannello Configurazione nodo a destra, imposta:
   • Agente: il tuo agente del tutorial precedente
   • Template del prompt: «Rivedi il codice sul branch corrente per problemi di qualità. Elenca ciò che trovi.»
3. Lascia Triggers from invariato — il nodo è già cablato per attivarsi dopo Trigger

Passaggio 3: salva

Premi Salva nell’intestazione dell’editor.

Punto di controllo. La dicitura «Modifiche non salvate» scompare.

Passaggio 4: consenti le esecuzioni manuali

1. Fai clic sulla tile tratteggiata Aggiungi un trigger sul canvas (oppure trascina Esecuzione manuale dalla sezione Trigger della libreria nodi) e scegli Esecuzione manuale.
2. Seleziona quel nodo. Nell’inspector a destra, attiva Attivato — «Mostra nella pagina di esecuzione e avvia manualmente.»

Non è facoltativo ed è facile dimenticarsene. Un nuovo modello viene creato con nessuna riga di trigger, quindi finché non lo attivi la pagina di esecuzione non lo elenca e non c’è nulla da avviare. L’interruttore scrive il trigger immediatamente; non attende un altro salvataggio.

Lo stesso interruttore si trova dietro Esecuzione manuale nell’intestazione dell’editor, accanto agli input dichiarati del modello.

Passaggio 5: avviala

1. Fai clic su Pipelines nella barra laterale
2. Fai clic su Esegui pipeline nell’intestazione
3. Scegli code_quality_check nella barra di sinistra
4. Fai clic su Esegui pipeline nel modulo — il tuo modello non dichiara input, quindi non c’è nulla da compilare

Punto di controllo. Un toast conferma l’avvio dell’esecuzione e Control Center apre il dettaglio dell’esecuzione.

Il motore crea il record dell’esecuzione, completa il trigger, pianifica il passaggio, invia l’agente e completa l’esecuzione quando il ramo in entrata del terminal termina.

Passaggio 6: ispeziona il risultato

Fai clic sul passaggio nell’esecuzione per aprire il suo pannello di dettaglio:

• Gli orari di Avviato e Completato e la Durata
• Input: lo stato passato al passaggio
• Output: ciò che ha prodotto — qui, la risposta dell’agente
• Attività dell’agente, con un link alla conversazione che il passaggio ha condotto

Punto di controllo. Il passaggio risulta completato e il suo output contiene la revisione dell’agente.

Aggiungere altri passaggi

I nodi si aggiungono trascinando una voce dalla libreria nodi a sinistra sul canvas, oppure premendo Aggiungi passaggio (+) subito dopo un nodo. Trascina dalla porta di output di un nodo su un altro nodo per collegarli, oppure seleziona il nuovo nodo e spunta il suo passaggio a monte sotto Triggers from.

Il nodo terminal non viene disegnato e non può essere selezionato. L’editor lo ricollega a ogni sink raggiungibile, quindi un nodo che aggiungi dopo lo Step preimpostato viene comunque eseguito.

Riepilogo

Hai creato un modello, configurato il nodo agente con prompt con cui è stato preimpostato, l’hai salvato, reso eseguibile manualmente, avviato un’esecuzione e letto l’input e l’output del passaggio.

Le pipeline diventano molto più grandi di così — router condizionali, rami paralleli, nodi di join, fan-out for-each, gate umani — ma la forma non cambia mai: passaggi in un DAG, che trasmettono stato.

Avanti: Collega Slack al tuo spazio di lavoro, l’ultimo tutorial di questa sequenza.

• Configura i trigger delle pipeline per avviare le pipeline da eventi o da una pianificazione
• Pipeline e automazione per il modello che sta sotto
• Tipi di passaggio delle pipeline per ogni tipo di passaggio