Crie o seu primeiro pipeline

O que vai criar

No final deste tutorial, terá:

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

Pré-requisitos: Despache o seu primeiro agente concluído, para ter um agente com um adaptador e um modelo.

Um pipeline é um DAG de passos. Os modelos definem o grafo; as execuções são concretizações dele. Para o modelo conceptual subjacente, leia Pipelines e automatização; para o vocabulário completo dos passos, Tipos de passo de pipeline.

Passo 1: Criar um modelo

1. Aceda a Definições → Espaço de trabalho → Modelos de pipeline
2. Prima Novo modelo

O editor abre num esqueleto pré-preenchido 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 existe nenhuma caixa de diálogo de id nem nenhum campo de descrição.

O canvas não está vazio. Um novo modelo vem pré-ligado como Trigger → Step → terminal, em que «Step» é um nó de agente de prompt e o terminal é um sentinela invisível que o editor volta a ligar a todos os sumidouros alcançáveis.

Configure o Step que já lá está.

Passo 2: Configurar o passo

1. Clique no nó Step no canvas
2. No painel Configuração do nó, à direita, defina:
   • Agente: o seu agente do tutorial anterior
   • Modelo de prompt: «Verifica o código no branch atual quanto a problemas de qualidade. Lista o que encontrares.»
3. Deixe Gatilhos de como está — o nó já está ligado para disparar depois do Trigger

Passo 3: Guardar

Prima Guardar no cabeçalho do editor.

Ponto de verificação. A legenda «Alterações não guardadas» desaparece.

Passo 4: Permitir execuções manuais

1. Clique no mosaico tracejado Adicionar um gatilho no canvas (ou arraste Execução manual da secçã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.»

Isto não é opcional e é fácil de deixar passar. Um modelo novo é criado sem nenhuma linha de disparador, por isso, enquanto não ativar isto, a página de execução não o lista e não há nada para iniciar. O interruptor escreve o disparador de imediato; não espera por outra gravação.

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.

Passo 5: Executar

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

Ponto de verificação. Uma notificação temporária confirma que a execução arrancou e o Control Center abre o detalhe da execução.

O motor cria o registo da execução, conclui o disparador, agenda o passo, despacha o agente e conclui a execução quando o ramo de entrada do terminal termina.

Passo 6: Inspecionar o resultado

Clique no passo da execução para abrir o respetivo painel de detalhe:

• As marcas temporais Iniciado e Concluído e a Duração
• Entrada: o estado passado para o passo
• Saída: o que o passo produziu — aqui, a resposta do agente
• Atividade do agente, com uma ligação para a conversa que o passo conduziu

Ponto de verificação. O passo aparece como concluído e a sua saída contém a revisão do agente.

Adicionar mais passos

Os nós adicionam-se arrastando uma entrada da biblioteca de nós à esquerda para o canvas, ou premindo Adicionar passo (+) logo a seguir a um nó. Arraste da porta de saída de um nó para outro nó para os ligar, ou selecione o novo nó e marque o respetivo passo a montante em Gatilhos de.

O nó terminal não é desenhado e não pode ser selecionado. O editor volta a ligá-lo a todos os sumidouros alcançáveis, pelo que um nó que adicione depois do Step pré-preenchido continua a ser executado.

Resumo

Criou um modelo, configurou o nó de agente de prompt com que ele foi pré-preenchido, guardou-o, tornou-o executável à mão, iniciou uma execução e leu a entrada e a saída do passo.

Os pipelines tornam-se muito maiores do que isto — routers condicionais, ramos paralelos, nós de junção, fan-out de tipo for each, portões humanos —, mas a forma nunca muda: passos num DAG, a passar estado.

Seguinte: Ligue o Slack ao seu espaço de trabalho, o último tutorial desta sequência.

• Configurar disparadores de pipeline para iniciar pipelines a partir de eventos ou de uma programação
• Pipelines e automatização para o modelo conceptual subjacente
• Tipos de passo de pipeline para cada tipo de passo