Loop do agente
O loop do agente (ciclo do agente) é o ciclo repetido no centro de um agente de IA: o modelo pede uma chamada de ferramenta, a aplicação a executa e devolve o resultado, e o modelo decide o que fazer em seguida.
Também chamado: agentic loop, tool-use loop
Por Divya Sharma · Verificado em 15 de nov. de 2026 · Como analisamos
Um modelo de linguagem não consegue executar código nem chamar uma API sozinho. Ele só produz texto, inclusive um pedido estruturado para usar uma ferramenta. O loop do agente é o código ao redor do modelo que transforma esses pedidos em ações.
Como funciona
1. Envie ao modelo a tarefa e uma lista de ferramentas. 2. O modelo responde com uma ou mais chamadas de ferramenta, ou com uma resposta final. 3. Se ele pediu ferramentas, a aplicação as executa e acrescenta os resultados à conversa. 4. Envie a conversa atualizada de volta e repita a partir do passo 2.
Na API do Claude, o loop continua enquanto o motivo de parada da resposta for tool_use e termina com qualquer outro motivo de parada. Cada chamada de ferramenta é uma ida e volta, então uma tarefa que precisa de dez chamadas de ferramenta significa pelo menos dez requisições. Os detalhes de cada requisição estão em chamada de ferramentas.
O que envolve o loop
O loop em si é curto. A maior parte da engenharia está no que o envolve: limites no número de turnos, tratamento de erros quando uma ferramenta falha, pedidos de aprovação para ações arriscadas e formas de manter a conversa dentro da janela de contexto à medida que os resultados se acumulam. Essa camada costuma ser chamada de harness do agente.
Padrões relacionados
O padrão ReAct é uma forma de estruturar o loop, alternando texto de raciocínio com ações.
Termos relacionados
- Agente de IA
- Um agente de IA é um sistema em que um modelo de linguagem decide seus próprios próximos passos: chama ferramentas, lê os resultados e repete até concluir a tarefa, em vez de seguir um roteiro fixo.
- Chamada de ferramentas
- Chamada de ferramentas (tool calling), também chamada de chamada de funções (function calling), é um recurso de APIs de modelos em que você descreve funções com um schema, o modelo responde com um pedido estruturado para chamar uma delas, e o seu código a executa e devolve o resultado.
- Harness de agente
- Um harness de agente (a estrutura de execução ao redor do modelo) é o software que transforma um modelo em um agente funcional: o loop, as ferramentas, o prompt de sistema, as permissões, o gerenciamento de contexto e quaisquer arquivos usados para levar o progresso de uma sessão para outra.
- Janela de contexto
- Uma janela de contexto (context window) é a quantidade máxima de texto, contada em tokens, que um modelo de linguagem consegue considerar de uma vez, incluindo o prompt de sistema, a conversa, os documentos, os resultados de ferramentas e a resposta que ele escreve.
- ReAct (raciocinar e agir)
- ReAct (reasoning and acting, raciocinar e agir) é um padrão de prompting em que um modelo de linguagem alterna entre escrever uma etapa de raciocínio, executar uma ação como uma busca ou chamada de ferramenta, e ler o resultado antes da próxima etapa.