Workflows
Fluxos automatizados montados em um canvas, quando a tarefa tem etapas fixas em vez de conversa.
Um Workflow é uma sequência de etapas montada em um canvas, ligando nós que recebem dados, processam e devolvem um resultado.
Onde o Agente conversa, o Workflow executa. Quem usa preenche um formulário de entrada e recebe uma saída, sem diálogo no meio.
Agente ou Workflow
A pergunta que separa os dois é se o caminho é conhecido de antemão:
- Agente: a pessoa faz perguntas abertas e o modelo decide o que fazer a cada mensagem. Bom para dúvidas, apoio e pesquisa.
- Workflow: você sabe as etapas e a ordem delas. Bom para processar um documento, extrair campos, consultar um sistema e gerar um arquivo.
Um Workflow é mais previsível e mais fácil de auditar. Um Agente cobre casos que você não antecipou.
Os nós
O canvas oferece os nós agrupados por finalidade:
- Entrada e Saída: os dois extremos do fluxo. A Entrada define os campos do formulário que a pessoa preenche; a Saída define o que ela recebe.
- LLM: chama um modelo de IA com um prompt montado a partir do que veio antes.
- Documentos: Extrator de arquivos, Extrator de CPF, Banco de dados vetorial e Gerador de arquivos.
- Lógica: Condição, Iteração e Agregação, para desvios, repetição sobre listas e escolha entre resultados.
- Integração: Requisição HTTP, Envio de Email e Integração, para falar com sistemas de fora.
- Código: Executor de código, para transformações que nenhum nó pronto cobre.
O nó Banco de dados vetorial é o que dá acesso às Coleções dentro de um Workflow, e ele exige pelo menos uma Coleção configurada.
Rascunho, publicação e execuções
Como os Agentes, Workflows têm rascunho e versão publicada. Só a publicada fica disponível para execução por outras pessoas.
Cada execução vira um run com registro próprio: entrada, saída, etapas percorridas e erros. É por ali que se investiga um resultado estranho, etapa por etapa, em vez de adivinhar.
Onde as pessoas executam
Workflows publicados aparecem na área Agentes do módulo Chat, no ícone logo abaixo do Chat na barra de áreas.
Quem abre um workflow ali vê o formulário definido pelo nó de Entrada, executa e acompanha o resultado. Não é preciso acesso ao Admin para isso.
O nome da área confunde: Agentes, no Chat, lista Workflows publicados, não os Agentes de conversa. Os Agentes de conversa são escolhidos pelo seletor dentro da própria tela de Chat.
Próximos passos
- Entenda as Coleções que o nó vetorial consulta em Coleções e conhecimento.
- Veja as ferramentas que os nós de integração alcançam em MCPs e Integrações.