Contratos de saída de workflow e saídas específicas por branch
Os contratos de saída de workflow definem o que um workflow deve produzir quando é concluído. Todo workflow tem ou uma única saída de fallback ou um conjunto de saídas específicas por branch. O mecanismo impõe o contrato no final de uma execução, e a execução falha se o workflow produzir o tipo de saída incorreto para o branch selecionado.
Tipos de saída
O mecanismo de workflow oferece suporte a três tipos de saída:
Tipo | O que o workflow deve entregar |
|---|---|
answer | Uma resposta apenas no chat. O workflow não deve criar nem enviar um documento. |
document | Um documento gerado ou enviado. O workflow deve produzir um arquivo de documento. |
table | Uma tabela estruturada ou uma planilha. O workflow deve produzir a saída em formato de tabela. |
Saída de fallback vs saídas específicas por branch
Quando cada branch terminal de um workflow produz o mesmo entregável, configure uma única saída de fallback. Quando branches diferentes produzem entregáveis diferentes, use saídas específicas por branch.
Saída de fallback — um contrato de saída aplicado a cada branch terminal.
outputs — um contrato de saída por branch, para que o entregável corresponda ao caminho do branch seguido.
Apenas um branch de saída deve ser concluído durante uma execução. Se o workflow produzir o tipo incorreto para o branch selecionado, a execução falha com um erro explícito.
Aplicação do contrato
O mecanismo verifica a saída no final de cada execução. Falhas comuns de contrato incluem:
Produzir um documento quando o contrato do branch espera uma resposta.
Concluir sem produzir a saída de documento exigida.
Concluir sem produzir qualquer saída exigida.
Quando nenhum contrato de saída está configurado, a página de detalhes do workflow mostra a mensagem: "Nenhum contrato de saída explícito está definido."
Como configurar saídas específicas por branch
No construtor de workflow, abra a seção de saída.
Adicione um bloco de saída para cada branch que precise de um entregável distinto.
Selecione o tipo de saída de cada bloco: answer, document ou table.
Vincule cada bloco de saída ao respectivo branch de destino.
Teste o workflow para verificar se cada branch produz o tipo de saída correto.
Quando uma saída específica por branch está definida, o mecanismo verifica apenas o contrato do branch que foi selecionado. Branches não selecionados são ignorados e seus contratos de saída são desconsiderados.
O que ler a seguir
Visão geral de workflows para criar e executar workflows
Retomar uma execução de workflow aguardando entrada humana para retomar execuções pausadas a partir do chat
Playbooks para aplicar padrões rigorosos de forma consistente