Workflows
Workflows são pipelines de execução compostos por uma ou mais etapas. Cada etapa pode chamar um agente, definir qual entrada esse agente recebe e passar resultados adiante para compor a execução completa. Workflows podem executar agentes de forma sequencial, paralela, condicional ou em colaboração baseada em time.
Quando usar
- Use workflows para transformar tarefas repetíveis em execuções guiadas.
- Use-os quando um entregável precisa passar por mais de um agente.
- Use-os para gerar resultados que podem ser revisados, exportados, ajustados ou enviados a integrações.
- Use-os para rotinas de monitoramento, relatórios periódicos, sincronização de backlog ou outros pipelines agendados.
Antes de começar
- Confirme a organização ativa.
- Crie ou selecione os agentes que devem participar do workflow.
- Prepare bases de conhecimento se o workflow precisar de contexto documental.
- Configure adaptadores antes de usar ações de entrega por integração.
Passo a passo: navegar por workflows
- Clique em Workflows na navegação principal.
- Use a busca para encontrar um workflow.
- Filtre por tipo ou status quando necessário.
- Ordene por nome ou data.
- Clique em um card para abrir os detalhes do workflow.
Passo a passo: criar um workflow
- Clique em Criar Workflow.
- Informe nome e descrição.
- Escolha o tipo de workflow.
- Defina o idioma de saída ou mantenha a seleção automática quando disponível.
- Associe um projeto quando o workflow precisar de bases de conhecimento específicas de projeto.
- Selecione bases de conhecimento quando aplicável.
- Adicione uma ou mais etapas.
- Em cada etapa, escolha o agente responsável.
- Configure adaptadores de entrega quando necessário.
- Clique em Criar Workflow.
Entenda os principais campos
| Campo | O que significa |
|---|---|
| Tipo | Define a estrutura do workflow, como sequencial, paralela, condicional ou baseada em time. |
| Idioma de saída | Idioma preferencial para as respostas geradas. |
| Projeto | Contexto usado para habilitar bases de conhecimento relacionadas. |
| Bases de conhecimento | Fontes que podem ser consultadas durante a execução. |
| Metadados customizados | Campos adicionais de documento incluídos no contexto enviado ao agente. |
| Etapas | Lista de agentes que participam do workflow. |
| Entrada da etapa | Mensagem, template ou saída anterior passada para uma etapa de agente. |
| Chave de saída | Nome opcional usado para identificar a saída de uma etapa. |
| Adaptadores | Integrações que podem receber o resultado do workflow. |
Tipos de workflow
| Tipo | O que faz |
|---|---|
| Sequencial | Executa etapas em ordem, geralmente usando a saída de uma etapa como contexto para a próxima. |
| Paralelo | Executa várias etapas de agente independentemente quando o trabalho pode ocorrer ao mesmo tempo. |
| Condicional | Direciona a execução conforme condições configuradas ou resultados intermediários. |
| Time | Permite que vários agentes especializados colaborem em uma tarefa ou entregável compartilhado. |
Formatadores de saída
Formatadores de saída definem como os resultados de workflow são apresentados ou entregues.
| Formatador | O que produz |
|---|---|
| Texto ou Markdown | Texto formatado exibido diretamente na interface. |
| JSON Schema | Saída estruturada que segue um schema JSON definido. |
| Documento PDF gerado a partir do resultado ou template do workflow. | |
| Jira | Issues ou cards criados automaticamente a partir da saída do workflow. |
| BusinessMap | Cards criados no BusinessMap a partir da saída do workflow. |
| MCP | Entrega ou integração por Model Context Protocol quando habilitado. |
Passo a passo: executar um workflow
- Abra o workflow que deseja executar.
- Em Executar Workflow, escreva a mensagem de entrada.
- Clique em Executar.
- Aguarde a abertura da página de resultado.
- Acompanhe o status da execução e o progresso das etapas.
Passo a passo: revisar histórico de execuções
- Abra o workflow.
- Acesse Histórico de Execuções.
- Clique em uma execução para abrir o resultado.
- Use os controles de paginação quando o histórico tiver muitos registros.
Passo a passo: agendar execuções
- Abra o workflow.
- Em Execuções Agendadas, informe a expressão cron.
- Use o link de ajuda visual quando precisar entender o formato do agendamento.
- Confirme o fuso horário usado pelo agendamento.
- Escreva a mensagem ou payload que deve ser enviado a cada execução automática.
- Escolha se o agendamento deve iniciar ativo.
- Clique em Criar Agendamento.
Execuções agendadas usam o fuso configurado no agendamento ou no ambiente. Confirme o horário esperado antes de habilitar rotinas importantes.
Passo a passo: editar um agendamento
- Abra o workflow.
- Encontre o agendamento.
- Ative ou desative usando o controle exibido.
- Clique em Editar Mensagem para atualizar a mensagem enviada durante a execução.
- Clique em Salvar.
Passo a passo: excluir um workflow ou agendamento
- Abra o item que deseja remover.
- Clique em Excluir.
- Leia a mensagem de confirmação.
- Confirme apenas se tiver certeza.
cuidado
Excluir workflows ou agendamentos pode interromper rotinas usadas pela organização.
Resultado esperado
Você deve ter um workflow que usa os agentes, contexto e opções de entrega corretos, e deve conseguir executá-lo ou agendá-lo conforme as necessidades da organização.