Como funcionam os agentes de IA: o ciclo, passo a passo
Os agentes parecem magia nas demonstrações e canalização em produção. A razão é que a parte interessante não é a saída do modelo mas o ciclo que a consome, e esse ciclo é curto o suficiente para se ler de uma assentada.
Este guia leva um único pedido de ponta a ponta: o que o modelo vê em cada turno, o que o vosso código faz com o resultado, como volta uma ferramenta que falhou e o que para o ciclo.
Uma volta do ciclo, por ordem#
- Montar o contexto: objetivo, definições de ferramentas, factos recuperados e histórico podado.
- Pedir ao modelo o passo seguinte: responde ou pede uma chamada com argumentos.
- Validar os argumentos antes de fazer o que quer que seja — tipos, intervalos e se este chamador pode tocar naquele registo.
- Executar a ferramenta. Apanhar falhas e traduzi-las em mensagens curtas e factuais.
- Acrescentar chamada e resultado ao histórico e verificar as condições de paragem.
- Repetir, ou devolver a resposta final com o que o agente realmente fez.
O que o modelo vê e não vê#
O modelo não guarda nada do turno anterior além do que voltarem a pôr no contexto. Esse único facto explica quase todo o comportamento confuso. Se o agente esquece uma restrição de há quatro passos, foi a vossa poda que a retirou.
Escrevam os erros das ferramentas como instruções, não como diagnósticos. Não `HTTP 404`, mas `Não há cliente com este ID. Peça confirmação do número de encomenda.`
Parar: a parte que as demonstrações nunca mostram#
| Condição | Definição típica | O que acontece |
|---|---|---|
| Teto de passos | 8–15 chamadas | Devolver trabalho parcial com explicação |
| Teto de gasto | Custo fixo por execução | Parar e registar para revisão |
| Relógio | 30–120 s em uso interativo | Entregar com o que se sabe |
| Deteção de repetição | Mesma chamada e argumentos duas vezes | Forçar outro ramo ou parar |
| Portão humano | Qualquer ação irreversível | Pausar e pedir aprovação |
Ler um rasto quando algo corre mal#
Um rasto é o registo ordenado de cada contexto, decisão, chamada e resultado de uma execução. É a única ferramenta de depuração que conta e a primeira a construir. A pergunta nunca é porque é que o modelo é mau, mas que turno correu mal primeiro e o que o modelo podia ver nesse momento.
Perguntas frequentes
Quantos passos antes de parar?
Em tarefas interativas, um teto de oito a doze chamadas cobre quase tudo o que é legítimo.
Planear primeiro ou decidir passo a passo?
Tarefas curtas correm bem passo a passo. Acima de cinco passos, um plano explícito torna a execução auditável.
Porque é que o meu agente repete a mesma chamada falhada?
Quase sempre porque a mensagem de erro não traz informação acionável.
como funcionam os agentes de iaciclo do agenteraciocinar agir observarchamada de ferramentasarquitetura de agente
