Assistentes de Workflow
Assistentes de workflow são uma forma avançada de assistentes de IA. Em vez de uma conversa totalmente aberta, o usuário percorre uma sequência definida de passos que são orientados pela IA. Isso torna possível acompanhar processos complexos de várias etapas — do começo ao fim, passo a passo.
O que é um assistente de workflow?
Um assistente de workflow funciona com base em um diagrama de fluxo visual de nós conectados por setas. Cada nó executa uma tarefa específica:
| Tipo de nó | Descrição |
|---|---|
| Início / Fim | Ponto de partida e de chegada do workflow |
| Avaliar | Analisa o contexto e armazena informações na memória do fluxo |
| Condição | Avalia uma expressão e direciona o fluxo na direção correta |
| LLM | Invoca um modelo de linguagem para uma tarefa específica (opcional: aguarda entrada) |
| Aprovação | Faz uma pergunta sim/não e direciona o fluxo com base na resposta |
O estado do workflow é salvo automaticamente após cada etapa. Quando o usuário fornece entrada, o workflow retoma exatamente de onde parou — mesmo após fechar o navegador.
Como usar um assistente de workflow?
Inicie uma nova conversa e escolha um assistente de workflow na lista. O assistente guiará automaticamente por todas as etapas. Em algumas etapas, o assistente aguarda sua resposta; em outras etapas, ele prossegue de forma independente sem entrada.
À direita da janela de chat você verá o botão Workflow. Clique nele para abrir um painel com todas as etapas e seu status atual (espera, ativo, pronto, espera por entrada, pulado, erro).
Você pode encerrar o chat a qualquer momento e retomar depois. O workflow continuará de onde parou.
Exemplo: assistente de Deep Research
O assistente de Deep Research é um exemplo de assistente de workflow disponível em todos os ambientes. Ele guia o usuário por um processo de pesquisa aprofundada:
- Definir o tema — a IA pergunta sobre o tema da pesquisa e o nível de profundidade desejado
- Formular perguntas de busca — a IA formula perguntas de busca direcionadas
- Realizar a pesquisa — a IA realiza a pesquisa e coleta informações
- Gerar relatório — a IA redige um relatório de pesquisa estruturado
- Concluir — o usuário avalia o relatório e pode fazer perguntas adicionais
Criar um assistente de workflow
Administradores podem compor assistentes de workflow na área de administração via Assistentes → Novo assistente → Assistente de workflow. Você pode começar com uma tela em branco ou usar uma preset existente como base.
Os assistentes de workflow podem ser compartilhados com grupos e colegas, assim como os assistentes comuns. Ao compartilhar com colegas, o AI-Public pode enviar automaticamente uma notificação por e-mail para que os destinatários saibam que o assistente de workflow está disponível.
Configurações gerais
Ao criar ou editar um workflow, configure no painel de configurações o seguinte para o workflow inteiro:
- Modelo (Model): O modelo de IA que será usado por todas as etapas.
- Ferramentas (Tools): Quais ferramentas estão disponíveis (por exemplo, Registro, Busca na Internet). Etapas podem desativar ferramentas habilitadas globalmente por etapa.
- Servidores MCP: Integrações externas.
- Documentos e imagens: Arquivos que as etapas de LLM podem consultar.
Criar uma node de triagem
Uma node de avaliação analisa a entrada do usuário e armazena valores estruturados na memória (por exemplo, rota, assunto). Configure:
- Um prompt do sistema que descreva o que deve ser analisado.
- O cronograma de saída: campos com nome e tipo (
string,number,boolean,enum).
Os valores armazenados ficam disponíveis como state.campo nas nodes condicionais.
Configurar uma node de condição
Uma node de condição lê a memória do workflow e envia o fluxo para a próxima etapa correta por meio de expressões CEL:
| Comportamento desejado | Expressão |
|---|---|
Campo é true | state.suficiente_info == true |
| Campo tem valor | state.rota == "relatório" |
| Limiar numérico | state.score > 7 |
Cada ramificação tem uma conexão própria para a próxima node.
Registro em workflows
Ative a ferramenta de Registro nas configurações gerais e adicione no prompt do sistema de uma etapa uma instrução para registrar resultados. O usuário verá os documentos registrados através do botão de Registro (📄) na barra de ferramentas.
Recuperar conversa
Não está satisfeito com a direção da conversa? Com o botão de restauração em uma mensagem anterior você pode voltar o workflow para aquele ponto. Todas as mensagens após isso serão removidas e o workflow continuará a partir daquele momento exato.
A restauração é permanente — as mensagens excluídas não podem ser recuperadas.
Arquivos e subagentes em workflows
Um workflow pode pedir ao usuário que envie arquivos, por exemplo, um documento-fonte, modelo de avaliação, contrato, documento de política ou formulário preenchido. O usuário pode enviar um novo arquivo ou escolher um arquivo existente no Gerenciamento de Arquivos. Arquivos adicionados via um formulário de workflow ficam disponíveis para o assistente naquele chat, mas não são automaticamente selecionados para perguntas comuns no chat.
Novos arquivos são processados primeiro antes de o workflow prosseguir com confiabilidade. Se um arquivo obrigatório ainda estiver sendo processado ou falhou, o usuário deve esperar ou escolher/enviar o arquivo novamente.
O nó Subagent executa a mesma tarefa em paralelo para múltiplos itens. Use-o quando um workflow precisa processar uma lista, por exemplo, um documento, participante, colaborador, cliente, caso ou formulário por execução. O subagente recebe sempre o item atual em um contexto isolado. Portanto, faça com que prompts se refiram explicitamente ao item atual e evite instruções que processem vários itens ao mesmo tempo.
Nó de passagem
Um nó de passagem não executa uma tarefa de IA e não mostra uma saída visível. Ele apenas encaminha o workflow para a próxima etapa. Use-o para reunir rotas de forma organizada, por exemplo quando um caminho ignora uma etapa e depois volta para a rota principal.
Um nó de passagem deve ter pelo menos uma conexão de entrada e uma conexão de saída. Ele não aparece como uma etapa de conteúdo separada no painel de progresso do workflow.
