Um Agent Workflow conecta o Brain, os Super Agents e etapas de decisão em um único processo repetível. Monte-o em um canvas visual e depois execute-o e acompanhe cada etapa.
Para entender o que são os Agent Workflows e quanto custam, veja o guia ClickUp Agent Workflows.
O recurso Agent Workflows está em beta.
A disponibilidade e os limites do recurso variam conforme o plano e a função do usuário. Veja a seção Disponibilidade e limites, no fim desta página.
O ClickApp de IA precisa estar ativado no seu Workspace.
Abrir os Agent Workflows
Para abrir os Agent Workflows:
- Na Barra Lateral Inicial, clique em IA para abrir o Hub de IA.
- Na barra lateral de IA, clique em Workflows.
Quando a página Workflows abrir, você verá cartões de workflows prontos no topo da página e, abaixo deles, uma tabela com os seus workflows atuais. A tabela tem as seguintes colunas:
- Name (Nome)
- Created by (Criado por)
- Date created (Data de criação)
- Sharing (Compartilhamento)
- Last updated (Última atualização)
Use os seguintes controles para encontrar um workflow:
| Ação | Como fazer |
|---|---|
| Alternar entre os layouts de tabela e de grade | Clique no ícone de tabela ou de grade na extremidade direita da linha de abas acima da tabela. |
| Filtrar workflows | Clique em All Workflows (Todos os workflows) ou em Created by me (Criados por mim) acima da tabela. |
| Pesquisar workflows | Clique no ícone de pesquisa na linha de abas acima da tabela. |
Criar um workflow
Você pode criar um workflow do zero ou usar um pronto.
Peça ao Brain para criar um workflow para você!
Criar um workflow do zero
Para criar um novo workflow:
- No canto superior direito, clique em New workflow (Novo workflow).
- Na barra de ferramentas do editor, clique no nome do workflow e digite um novo nome.
No seu novo workflow, uma etapa Trigger (Gatilho) já está no canvas. Para voltar aos seus workflows, clique no ícone de voltar na extremidade esquerda da barra de ferramentas do editor.
Usar um workflow pronto
Para começar com um workflow pronto, clique em Use blueprint (Usar modelo) em um dos cartões no topo da página.
Para ver uma execução de exemplo, clique em Try it (Experimentar) no cartão Get started (Comece agora).
Adicionar etapas ao workflow
O painel de workflows fica à esquerda do canvas. No topo do painel, clique na aba Steps (Etapas) para ver as etapas que você pode adicionar. Para encontrar uma, digite em Search steps and agents (Pesquisar etapas e agentes), abaixo das abas.
Para adicionar uma etapa ao workflow:
- Na aba Steps do painel de workflows, clique em uma etapa para adicioná-la ao canvas.
- No canvas, clique na etapa para abrir as configurações dela na barra lateral direita.
Escolha entre as seguintes etapas:
- Agent (Agente): executa o Brain ou um Super Agent com as instruções que você escrever.
- Approval (Aprovação): pausa até que uma pessoa dê a aprovação.
- Run workflow (Executar workflow): executa outro workflow dentro deste.
- Condition (Condição): pergunta à IA qual caminho seguir. Escreva uma pergunta e dê nome às ramificações. A IA seleciona uma ramificação para continuar.
- Merge (Mesclar): junta os caminhos novamente.
Para configurar uma etapa Agent:
- Adicione uma etapa Agent ao canvas.
- No canvas, clique na etapa Agent para abrir as configurações dela na barra lateral direita.
- Edite a etapa usando as opções da barra lateral direita. As opções variam conforme a etapa.
O tipo da etapa, como Condition, aparece no topo da barra lateral direita. Um selo de configuração ao lado do nome do workflow, na barra de ferramentas do editor, conta as etapas que ainda precisam ser configuradas. O mesmo selo aparece no topo da barra lateral direita de cada etapa que precisa de configuração.
Clique com o botão direito em uma etapa no canvas para abrir o menu dela:
- Configurar
- Duplicar
- Excluir
Para adicionar, remover, mover e organizar as etapas no canvas, use os seguintes controles:
| Ação | Como fazer |
|---|---|
| Adicionar uma etapa depois de outra | Passe o cursor sobre ela no canvas e clique em Add next step (Adicionar próxima etapa), o ícone de adição abaixo dela. Depois, selecione uma etapa no menu Add a step (Adicionar uma etapa). |
| Adicionar uma etapa arrastando | Arraste a partir do ponto de conexão na parte inferior de uma etapa até um espaço vazio. Depois, selecione uma etapa no menu Add a step. |
| Adicionar uma etapa entre duas etapas | Passe o cursor sobre o conector e clique em Add step here (Adicionar etapa aqui), o ícone de adição na linha. |
| Adicionar uma etapa paralela | Passe o cursor sobre uma etapa e clique em Add parallel steps (Adicionar etapas paralelas), o ícone de ramificação abaixo dela. Em um conector, o mesmo ícone mostra Add parallel path (Adicionar caminho paralelo). |
| Adicionar uma etapa em qualquer lugar do canvas | Clique com o botão direito em um espaço vazio e selecione uma etapa no menu Add a step. |
| Remover uma etapa | Clique com o botão direito nela no canvas e selecione Excluir. Você também pode clicar nela e depois em Delete node (Excluir nó), na parte inferior da barra lateral direita, ou selecioná-la e pressionar Delete. |
| Remover a conexão entre duas etapas | Passe o cursor sobre o conector e clique em Delete connection (Excluir conexão), o ícone x na linha. |
| Mover uma etapa | Arraste-a no canvas. Os conectores dela acompanham. |
| Aplicar zoom no canvas | Clique em − ou + no canto inferior esquerdo. |
| Ajustar o workflow inteiro à tela | Clique em Fit to screen (Ajustar à tela) no canto inferior esquerdo ou pressione Shift + 1. |
| Mostrar o minimapa | Clique em Show map (Mostrar mapa) no canto inferior esquerdo ou pressione M. |
| Organizar as etapas automaticamente | Clique em Auto-arrange (Organizar automaticamente) no canto inferior esquerdo. |
| Percorrer as alterações | Clique na seta de desfazer ou de refazer na barra de ferramentas do editor. |
Definir o gatilho
Para definir como o workflow começa:
- No canvas, clique na etapa Trigger ou clique em Automate (Automatizar) na barra de ferramentas do editor. As configurações do Trigger abrem na barra lateral direita.
- Escolha como o workflow começa:
- Manual: clique em Run now (Executar agora) para iniciá-lo você mesmo. Para pedir informações a cada execução, clique em Adicionar pergunta.
- Scheduled (Agendado): clique em Adicionar agendamento. Uma Automação abre com o gatilho Em um agendamento e a ação Start workflow (Iniciar workflow). O agendamento padrão é todo dia útil às 9:00. Defina Repetir, Em e Iniciando em e clique em Salvar no canto inferior direito.
- Webhook: clique em Add webhook (Adicionar webhook).
- Automated (Automatizado): clique em Adicionar Automação.
Adicionar uma pergunta no início da execução
Para fazer uma pergunta no início de cada execução:
- Clique no Trigger no canvas e depois em Adicionar pergunta na barra lateral direita. A aba Variables (Variáveis) do painel de workflows abre com a nova pergunta.
- Insira um nome e escolha um tipo, como Texto.
- Para que a execução aguarde uma resposta, ative Obrigatório.
- Para usar um valor quando a resposta ficar em branco, insira-o em Default answer (Resposta padrão).
- Para adicionar uma descrição ou um grupo, clique em Mais opções.
- Clique em Concluído na parte inferior do formulário.
Usar variáveis
A aba Variables, no topo do painel de workflows, reúne o que o workflow pede no início, o que ele salva ao longo do caminho e o que ele retorna no final.
Para adicionar uma pergunta, clique na aba Variables e depois em Adicionar pergunta.
Para adicionar uma anotação que uma etapa salva para as etapas seguintes, clique na aba Variables e depois em Add saved info (Adicionar informação salva), em Saved info (Informações salvas).
Alterar ou remover perguntas
Para alterar uma pergunta do Trigger, clique no Trigger no canvas e selecione Editar na barra lateral direita.
Para remover uma pergunta do Trigger, clique no Trigger no canvas, selecione Editar na barra lateral direita e clique em Excluir na parte inferior do formulário da pergunta.
Executar um workflow
Para executar um workflow:
- Na barra de ferramentas do editor, clique em Run Workflow (Executar workflow). Ou clique no Trigger no canvas e depois em Run now, no topo da barra lateral direita.
- Se o workflow fizer perguntas no início, responda-as no menu que abrir e clique em Start run (Iniciar execução).
A execução abre com o status e os créditos que ela usou ao lado do nome do workflow, na barra de ferramentas do editor, como Success (Sucesso) e 10 credits (10 créditos). A barra lateral direita mostra o número da execução, quando ela rodou e quanto tempo levou, além de cada etapa com o tempo dela.
Para entender quanto cada plano inclui de créditos de IA, veja o guia créditos de IA do ClickUp.
Na visualização da execução, use os seguintes controles:
| Ação | Como fazer |
|---|---|
| Ver o que a execução produziu | Clique em Result (Resultado). |
| Ver os detalhes técnicos | Clique no ícone de bug na barra de ferramentas do editor. |
| Ver execuções anteriores | Clique em Runs (Execuções) na barra de ferramentas do editor. |
| Tentar de novo uma execução que falhou | Clique em Retry run (Executar novamente). |
| Voltar à lista de execuções | Clique em Back to all runs (Voltar a todas as execuções) no topo da barra lateral direita. |
Compartilhar um workflow
Para compartilhar um workflow, clique em Compartilhar na barra de ferramentas do editor. No menu Share this Workflow (Compartilhar este workflow):
- Para copiar o link, clique em Copiar link.
- Para convidar alguém, digite o nome ou o e-mail da pessoa em Convidar por nome ou e-mail.
- Para compartilhar com todos do Workspace, ative o botão de alternância ao lado de Membros do Workspace.
- Para restringir o acesso às pessoas que você convidou, clique em Tornar privado.
Para editar um workflow compartilhado, a pessoa precisa ter permissão de Editar ou Edição total.
Duplicar, importar, exportar ou excluir um workflow
Para duplicar, importar, exportar ou excluir um workflow:
- Na barra de ferramentas do editor, clique no ícone de reticências ....
- Selecione uma ação:
- Duplicate workflow (Duplicar workflow)
- Import from JSON (Importar de JSON)
- Export as JSON (Exportar como JSON)
- Delete workflow (Excluir workflow)
Disponibilidade e limites
Disponibilidade dos Agent Workflows por plano
Os Agent Workflows estão incluídos em todos os planos. As etapas que executam o Brain ou um Super Agent usam créditos de IA. Preços e pacotes estão sujeitos a alterações. As etapas que executam o Brain estão disponíveis em todos os planos pagos.
Disponibilidade dos Agent Workflows por função de usuário
Convidados não podem criar, editar nem executar Agent Workflows. Proprietários, admins e membros podem.