Modelo da esteira: etapas, finais e conexões
Uma esteira é uma sequência de etapas, cada uma executada por um agente. Ao terminar, a etapa escolhe um final declarado — e é ele que decide o que vem depois.
Modelo da esteira: etapas, finais e conexões
Camada funcional
Uma esteira é uma sequência de etapas, e cada uma é executada por um agente da organização como um trabalho de verdade. Ao terminar, a etapa escolhe um dos finais declarados — e é o final escolhido que decide o que vem depois: continuar, pular para outra etapa, voltar e repetir, ou encerrar.
A decisão que sustenta o resto
Quem decide o caminho é a esteira, nunca o modelo. O agente diz o que aconteceu, escolhendo entre os finais que aquela etapa declara; a esteira decide o que fazer com isso.
Isso separa duas responsabilidades que costumam ser confundidas — e é o que faz o fluxo ser previsível: o mesmo final leva sempre ao mesmo lugar.
As peças
| Peça | O que é |
|---|---|
| Etapa | Um agente com instruções próprias, os finais que ele pode escolher e, se quiser, os campos que ele deve devolver |
| Final | Um desfecho declarado, com o nome que a pessoa vê e a explicação que o agente lê para decidir qual escolher |
| Conexão | Liga uma etapa à seguinte, por final escolhido ou por erro |
| Instruções gerais | Um preâmbulo que vale para todas as etapas, para não repetir o mesmo texto em cada uma |
| Desenho | A posição das etapas no mapa. É só visual: mover uma caixa não muda o comportamento nem cria versão nova |
Etapa de condição: decidir sem gastar um agente
Escolher caminho por critério objetivo — "o título contém tal palavra", "a prioridade é maior que três" — não precisa de agente. A esteira resolve sozinha: avalia as regras, escolhe o final e segue em frente. É instantâneo e não custa nada.
Sem isso, uma triagem simples viraria conversa: um trabalho inteiro de agente para avaliar se um texto contém uma palavra — caro, lento, e sujeito a variação onde deveria haver regra.
- As regras são avaliadas em ordem, e a primeira que bate decide.
- Um final padrão é obrigatório, para o caso de nenhuma regra bater.
- Dá para comparar texto (contém, começa com, é igual, está vazio) e número (maior, menor). Texto ignora maiúsculas por padrão.
- Os dois lados da comparação aceitam o resultado de etapas anteriores, então comparar uma etapa com a outra sai de graça.
- Condição não tem agente nem instruções — e o editor recusa se você preencher os dois.
Passar informação de uma etapa para outra
As instruções de cada etapa podem citar o que a esteira já sabe: o que a iniciou, o que uma etapa anterior devolveu, o final que ela escolheu, o motivo de uma falha.
Na tela isso não aparece como código: vira uma pastilha legível, e o menu só oferece etapas que vieram antes no fluxo — não dá para citar o que ainda não aconteceu.
Um cuidado importante: informação que não chegou vira vazio, e não erro. Uma etapa que esperava um dado ausente continua rodando, com um pedaço a menos da instrução. Por isso o editor marca em âmbar toda referência que aponta para lugar nenhum — é o aviso de que a instrução vai chegar incompleta ao agente.
Depois do primeiro disparo, o editor passa a oferecer os campos que realmente vieram no evento, com o valor do último disparo como dica. Você escolhe da lista em vez de adivinhar o nome.
Limites
Ajustáveis por esteira: quantas etapas uma execução pode percorrer no total, quanto tempo cada etapa pode levar e quanto tempo a execução inteira pode durar.
Fixos: quantas etapas, conexões, finais e campos uma esteira comporta, o tamanho das instruções, quantas vezes uma etapa pode repetir, quantas regras cabem numa condição, e quantas execuções e gatilhos ficam ativos ao mesmo tempo. Todos avisam com mensagem clara quando são atingidos — em vez de a esteira parar sem explicação.
Etapa de condição conta no total de etapas como qualquer outra, mesmo custando quase nada: é o freio contra uma sequência de condições disparando sem fim.
Execução da esteira: caminho, erro e recuperação
O que acontece depois que a esteira começa: como o caminho é escolhido, o que roda em paralelo, o que fazer quando uma etapa falha e como uma execução travada é recuperada.
Servidores MCP
Como acrescentar ferramenta a um agente sem mudar o produto: conectar a um servidor de MCP, por endereço ou por pacote.