Skip to main content
O nodo AI Task faz uma chamada a um modelo de linguagem (LLM) para processar informações e retornar um resultado estruturado. Ao contrário do nodo AI Agent, que mantém uma conversa contínua com o usuário, o AI Task executa uma tarefa direcionada e retorna seu resultado sem interagir diretamente com o usuário.

​
Quando usar AI Task vs AI Agent

​
Configuração

O AI Task usa os mesmos campos de configuração que o AI Agent:
  • Modelo: LLM a usar
  • Instruções: Prompt que define qual tarefa executar
  • Temperatura: Controle de criatividade (0 = preciso, 1 = criativo)
  • Bases de conhecimento: Documentos e datastores para contexto
  • MCPs e Ferramentas: Ferramentas externas disponíveis
Ver detalhes de configuração de modelo e instruções

​
Reter a conversa enquanto aguarda

Por padrão, enquanto o AI Task aguarda a resposta do modelo, o usuário fica livre: se ele escrever, a mensagem é atendida pelo roteador do projeto e pode iniciar outro fluxo na mesma conversa. Uma chamada a um modelo pode levar dezenas de segundos, então, para evitar isso, abra a aba Avançado e habilite Reter a conversa enquanto aguarda: o usuário permanece neste workflow até o nó terminar ou a retenção expirar.
As mensagens que o usuário envia enquanto a conversa está retida não entram no fluxo: são sempre descartadas, então os nós seguintes —incluindo um Agente IA— não verão o que ele escreveu.

​
Quanto tempo dura

A conversa é liberada assim que o nó termina, tanto pela saída de sucesso quanto pela de erro, e o fluxo continua. Como garantia, a retenção dura no máximo 5 minutos: se o modelo demorar mais, o usuário volta a conversar com o roteador mesmo que o nó continue em execução.

​
Quando não se aplica

  • Nós dentro de uma Tool: só o workflow que conversa com o usuário pode retê-lo, então a opção é ignorada em um AI Task executado dentro de uma Tool. Nesse caso, habilite-a no nó Tool do workflow; consulte Sua primeira Ferramenta.
  • Conversas com um operador: se um agente humano assumir a conversa, as mensagens dele não passam pela retenção.
  • Usuário já retido: se outro nó —por exemplo, uma Pausa ou uma Tool com a mesma opção— já estiver retendo o usuário, essa retenção é mantida e este nó não a substitui.
Os testes a partir do canvas também aplicam a retenção, como em produção.

​
Diferença principal: resposta estruturada

O AI Task não precisa da função end_function como o AI Agent. Em vez disso, ele retorna diretamente um resultado em formato JSON que você pode salvar na memória para usar em nodos subsequentes (por exemplo, em um nodo Condicional). Instruções: O resultado é salvo na memória e você pode usar um nodo Condicional para direcionar o fluxo com base na categoria detectada.