Skip to main content
A lista de tarefas deixa o agente organizar sozinho as etapas de um atendimento longo: ele escreve uma lista de passos, marca cada um como pendente, em andamento ou concluído, e segue a lista nas mensagens seguintes. Serve para atendimentos com muitas etapas que não podem ser esquecidas, como um orçamento com vários itens ou uma triagem com várias perguntas obrigatórias. Para a maioria dos agentes de WhatsApp, não ligue. Um atendimento comum (tirar dúvida, agendar, qualificar) é curto, e a lista só acrescenta chamadas e tokens.

Quando usar

Se as etapas são sempre as mesmas, prefira escrevê-las no prompt ou numa skill. A lista de tarefas vale quando as etapas mudam conforme o pedido do lead.

Onde fica no painel

Menu Agente (/project), seção Tools → Adicionar → grupo Utilidades → Lista de tarefas. Só pode existir uma por agente. Como toda mudança no agente, vale depois de Publicar.

Como configurar

Os dois campos são opcionais. Em branco, valem os textos padrão do sistema, que já são longos e calibrados.
O texto padrão de Regras permanentes inclui a regra que manda o agente escrever a resposta ao lead logo depois de atualizar a lista. Se você preencher esse campo, o padrão é substituído inteiro. Repita a regra no seu texto, por exemplo: “Depois de atualizar a lista, responda ao cliente na mensagem seguinte. Nunca termine a vez só com a atualização da lista.” Sem ela, o lead pode ficar sem resposta enquanto o agente planeja.

Como funciona por trás

  • Ligar a lista acrescenta ao agente a tool write_todos. O modelo a chama com a lista inteira de itens, cada um com um texto e um estado (pending, in_progress, completed).
  • A lista fica guardada na conversa. Na mensagem seguinte do lead, o agente ainda sabe o que falta. Encerrar o atendimento começa uma conversa nova, sem lista.
  • Cada atualização da lista é uma chamada de tool. Ela aparece no chat do lead, para a equipe, como as outras tools. Em conversas longas, isso acrescenta linhas ao histórico que o humano lê.
  • Cada atualização também conta no limite de chamadas e custa tokens.

Pelo MCP

A lista de tarefas é uma tool type: "builtin" no bloco langchain. Escrever o bloco cria uma versão não publicada do agente.

Armadilhas

  • Lead sem resposta. Sobrescrever Regras permanentes sem repetir a regra de responder logo após atualizar a lista.
  • Ligada sem necessidade. Num atendimento curto, o agente gasta chamadas planejando o que caberia numa resposta.
  • Histórico poluído. Cada atualização aparece no chat do lead como chamada de tool.
  • Filtro de tools esconde a lista. Com Filtrar tools ligado, inclua write_todos em always_include se a lista for essencial.

Para saber mais