Anunciamos US$ 3,2M em rodada pré-seed · OneVC · Maya · Norte Ventures Leia →
Voltar ao blog

Agentic loop:
o que é e como funciona o ciclo de um agente de IA

Em resumo

Um agente recebe a tarefa de explicar por que o ERP registra mais unidades de um item do que o sistema do armazém contou no inventário. Cada consulta que ele faz depende do resultado da anterior. Essa sequência tem nome: agentic loop, o ciclo agêntico em que o sistema chama o modelo, executa a ação indicada e devolve o resultado ao contexto até um critério de parada. Cada volta consome tokens, e o número de voltas depende do contexto que o agente encontra. É aí que entra o Company Brain, a camada que conhece a empresa: quais dados existem, onde vivem, como se relacionam e quem pode ver o quê.

O agentic loop repete chamada, ação e resultado até uma condição de parada

O agentic loop é o mecanismo de software que executa um agente de IA. O modelo produz texto estruturado indicando a próxima ação: chamar uma ferramenta, consultar um dado, pedir confirmação a uma pessoa ou encerrar. O código ao redor do modelo, chamado de orquestrador, executa a ação, anexa o resultado ao contexto e chama o modelo de novo. A regra de parada fica nesse código.

Cada volta do ciclo passa pelas mesmas seis etapas

No caso da divergência de estoque, uma volta segue esta ordem:

  1. Objetivo: explicar a diferença de saldo de um item em uma filial, com as condições de término.
  2. Montagem do contexto: instrução, ferramentas, dados já obtidos e resultados anteriores entram na chamada.
  3. Chamada ao modelo: o modelo indica a próxima ação, como consultar as movimentações do item desde o último inventário.
  4. Execução: o orquestrador verifica a permissão e roda a consulta.
  5. Incorporação do resultado: a resposta da ferramenta entra no contexto da próxima chamada.
  6. Verificação de parada: se nenhum critério foi atingido, começa outra volta.

Em uma das voltas, as notas de entrada mostram uma devolução recebida no armazém e sem lançamento no ERP. O modelo indica o ajuste, e o ciclo pausa até a aprovação do controle de estoque.

Etapas do agentic loop em anel, da montagem do contexto à verificação de parada
Cada volta do agentic loop passa pelas mesmas seis etapas

Chamada única e fluxo fixo têm número de passos conhecido de antemão

Uma chamada única ao modelo recebe uma entrada e devolve uma saída, com custo previsível. Um fluxo fixo de automação executa uma sequência escrita por uma pessoa, como abrir uma tarefa para o almoxarifado quando o saldo diverge. O agentic loop define a sequência durante a execução, e o número de chamadas ao modelo só é conhecido no fim. Essa flexibilidade transfere ao projeto a tarefa de limitar custo e duração.

Critérios de parada definem quando o agentic loop termina

O orquestrador verifica a cada volta condições explícitas de término:

  • Objetivo atingido: a resposta final atende ao formato definido na tarefa.
  • Limite de iterações: um teto de voltas por execução.
  • Limite de custo ou de tempo: um orçamento de tokens ou um prazo máximo.
  • Erro: ferramenta indisponível ou resultado inválido repetido encerra a execução com o motivo registrado.
  • Aprovação humana: a ação seguinte exige confirmação de uma pessoa.

Sem esses critérios, o laço pode girar sem fim. Cada volta repetida soma custo sem aproximar a tarefa do objetivo.

Cada volta reenvia o contexto acumulado e aumenta o consumo de tokens

Na maioria das implementações, o modelo não guarda estado entre chamadas. Cada volta reenvia a instrução, a descrição das ferramentas e todos os resultados obtidos até ali. Como o contexto acumulado entra em todas as chamadas seguintes, o custo total cresce mais rápido que o número de voltas.

Em 2024, pesquisadores da Princeton University mostraram que agentes de ponta podem ser desnecessariamente complexos e caros, custando muito mais que alternativas simples com acurácia parecida e defenderam medir custo e acurácia juntos. Na empresa, o custo de um agentic loop depende de quantas voltas a tarefa exige, de quanto contexto entra em cada volta e de qual modelo roda cada chamada.

Custo por volta no agentic loop, com resultados acumulados reenviados a cada chamada
No agentic loop, cada volta reenvia os resultados acumulados e o consumo de tokens cresce

As falhas do ciclo se acumulam com o número de voltas

Algumas falhas aparecem com frequência em um agentic loop longo:

  • Repetição de ferramenta: a mesma consulta volta com parâmetros quase iguais, porque o resultado anterior veio ambíguo.
  • Perda do objetivo: os resultados intermediários ocupam a maior parte do contexto e a instrução original perde peso.
  • Resultado errado ou desatualizado: a ação parte de um saldo lido antes de uma movimentação recente.
  • Conteúdo externo: texto lido em documento ou e-mail pode trazer instruções embutidas, risco conhecido como injeção de prompt.

Pontos de aprovação colocam uma pessoa dentro do ciclo

Consultar saldo é leitura. Lançar um ajuste de estoque altera o resultado contábil da filial. O desenho do ciclo separa essas classes de ação e coloca um ponto de aprovação antes das de maior consequência. Ali, o ciclo pausa e mostra à pessoa responsável a ação proposta e a origem de cada dado.

O Company Brain reduz as voltas gastas para descobrir o que é cada registro

Com dados crus, boa parte das voltas serve para descobrir o básico. O item tem um código no ERP e outro no armazém. O ERP conta em caixas, e o armazém conta em unidades. Cada tentativa de conciliar isso é uma volta paga.

O Company Brain entrega esse trabalho resolvido. O grafo de conhecimento liga o item do ERP ao item do armazém e às notas de entrada. A ontologia do negócio registra a unidade de medida de cada sistema e a regra de conversão. O contexto chega via MCP, o protocolo aberto que conecta modelos a fontes de dados, com a permissão herdada do sistema de origem. Cada consulta fica registrada com a fonte, e com menos voltas parte das chamadas pode rodar em modelos de custo menor.

Agentic loop com dados crus comparado ao agentic loop que consulta o Company Brain via MCP
Com o contexto resolvido no Company Brain, o agentic loop gasta menos voltas em descoberta

O agentic loop depende de ferramentas bem descritas e de fontes corretas

Ferramentas com descrição vaga continuam gerando chamadas erradas. Um saldo lançado com atraso no ERP continua sendo a informação que o agente recebe. Limites e pontos de aprovação seguem como responsabilidade de quem projeta o ciclo.

O primeiro agentic loop em produção começa pelo desenho do ciclo

O ponto de partida é uma tarefa frequente com fontes conhecidas, como a investigação de divergências de estoque. Antes do primeiro teste, o desenho registra objetivo, formato da resposta, limite de voltas e de tokens, critérios de parada e ponto de aprovação. O registro das voltas de cada execução mostra onde o agente gastou chamadas em descoberta, e esse é o primeiro contexto a resolver.

Receba os próximos artigos sobre arquitetura de contexto para IA