Crie seu primeiro pipeline

O que você vai construir

Ao final deste tutorial, você terá:

• Um modelo de pipeline salvo que despacha um agente com um prompt
• Execuções manuais ativadas nele, para que ele possa ser iniciado manualmente
• Uma execução concluída, com a entrada e a saída da etapa visíveis

Pré-requisitos: Despache seu primeiro agente concluído, para que você tenha um agente com um adaptador e um modelo.

Um pipeline é um DAG de etapas. Os modelos definem o grafo; as execuções são as rodadas desse grafo. Para entender o modelo por trás disso, leia Pipelines e automação; para o vocabulário completo de etapas, Tipos de etapa de pipeline.

Etapa 1: Criar um modelo

1. Acesse Configurações → Espaço de trabalho → Modelos de pipeline
2. Clique em Novo modelo

O editor abre em um esqueleto já montado chamado Novo pipeline (id pipeline_N). Clique no título no cabeçalho e renomeie-o — para este tutorial, code_quality_check é um bom nome. Não há diálogo de id nem campo de descrição.

O canvas não vem em branco. Um modelo novo já vem ligado como Trigger → Step → terminal, em que “Step” é um nó de agente de prompt e o terminal é uma sentinela invisível que o editor recabla para cada sumidouro alcançável.

Você configura o Step que já está lá.

Etapa 2: Configurar a etapa

1. Clique no nó Step no canvas
2. No painel Configuração do nó à direita, defina:
   • Agente: seu agente do tutorial anterior
   • Modelo de prompt: “Revise o código no branch atual em busca de problemas de qualidade. Liste o que encontrar.”
3. Deixe Triggers from como está — o nó já está ligado para disparar depois do Trigger

Etapa 3: Salvar

Pressione Salvar no cabeçalho do editor.

Ponto de verificação. A legenda “Alterações não salvas” desaparece.

Etapa 4: Permitir execuções manuais

1. Clique no bloco tracejado Adicionar um gatilho no canvas (ou arraste Execução manual da seção Gatilhos da biblioteca de nós) e escolha Execução manual.
2. Selecione esse nó. No inspetor à direita, ative Ativado — “Mostrar na página de execução e iniciar manualmente.”

Isso não é opcional e é fácil de passar batido. Um modelo novo é criado sem nenhuma linha de gatilho, então até você ativar isso a página de execução não vai listá-lo e não há nada para iniciar. O interruptor grava o gatilho imediatamente; ele não espera outro salvamento.

O mesmo interruptor está por trás de Execução manual no cabeçalho do editor, onde fica ao lado das entradas declaradas do modelo.

Etapa 5: Executar

1. Clique em Pipelines na barra lateral
2. Clique em Executar pipeline no cabeçalho
3. Escolha code_quality_check na barra à esquerda
4. Clique em Executar pipeline no formulário — seu modelo não declara entradas, então não há nada para preencher

Ponto de verificação. Um toast confirma que a execução começou e o Control Center abre os detalhes da execução.

O motor cria o registro da execução, conclui o gatilho, agenda a etapa, despacha o agente e conclui a execução quando o ramo de entrada do terminal termina.

Etapa 6: Inspecionar o resultado

Clique na etapa dentro da execução para abrir o painel de detalhes dela:

• Horários de Iniciado e Concluído e a Duração
• Entrada: o estado passado para a etapa
• Saída: o que ela produziu — aqui, a resposta do agente
• Atividade do agente, com um link para a conversa que a etapa conduziu

Ponto de verificação. A etapa consta como concluída e a saída dela traz a revisão do agente.

Adicionar mais etapas

Nós são adicionados arrastando um item da biblioteca de nós à esquerda para o canvas, ou pressionando Adicionar passo (+) logo depois de um nó. Arraste da porta de saída de um nó para outro nó para conectá-los, ou selecione o novo nó e marque a etapa a montante dele em Triggers from.

O nó terminal não é desenhado e não pode ser selecionado. O editor o recabla para cada sumidouro alcançável, então um nó que você adicionar depois do Step inicial ainda será executado.

Recapitulação

Você criou um modelo, configurou o nó de agente de prompt com que ele foi semeado, salvou-o, tornou-o executável manualmente, iniciou uma execução e leu a entrada e a saída da etapa.

Pipelines ficam muito maiores do que isso — roteadores condicionais, ramos paralelos, nós de junção, distribuição for-each, portões humanos —, mas a forma nunca muda: etapas em um DAG, passando estado.

A seguir: Conecte o Slack ao seu espaço de trabalho, o último tutorial desta sequência.

• Configurar gatilhos de pipeline para iniciar pipelines a partir de eventos ou de um agendamento
• Pipelines e automação para o modelo por baixo
• Tipos de etapa de pipeline para cada tipo de etapa