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.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 tooltype: "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_todosemalways_includese a lista for essencial.
Para saber mais
- Tools: visão geral
- Limites e segurança
- Testar o agente
- LangChain: middlewares prontos
- Anthropic: Building effective agents
- Termos para buscar: “TodoListMiddleware”, “write_todos”, “agent planning”.