Carregando
0x00Lição 1 de 8

Modele o ciclo de um agente

Acompanhe uma tarefa por pensar, agir e observar - e veja por que a fonte da verdade é o ambiente, não o modelo.

20 min Questionário com 6 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • Descrever as etapas do ciclo de um agente que usa ferramentas
  • Explicar por que cada etapa precisa da verdade vinda do ambiente
  • Ler e interpretar um rastro no estilo ReAct

Nesta trilha, engenharia de ciclos significa projetar o ciclo repetido que permite a um sistema de IA avançar numa tarefa que ele não consegue terminar numa única resposta. A cada volta do ciclo:

  1. Observar - o estado atual: o objetivo, o que já foi feito, o último resultado.
  2. Pensar - o modelo decide o que fazer em seguida.
  3. Agir - o seu código executa a chamada de ferramenta escolhida.
  4. Verificar - o resultado volta para o contexto; o objetivo foi atingido, ou o ciclo deve parar?

Esse padrão ficou conhecido como ReAct (Yao et al., 2022): intercalar o raciocínio (“Thought”) com ações e as observações delas. A palavra crucial é observação: o texto Building effective agents, da Anthropic, ressalta que os agentes precisam de verdade vinda do ambiente a cada etapa - resultados de testes, respostas de APIs, conteúdo de arquivos - em vez de supor que uma ação funcionou.

Experimente

Até 15 XP

Um ciclo, passo a passo

Pedem a um agente que conserte um teste que está falhando. Avance pelo ciclo e preveja as etapas marcadas.

Mensagem 1 de 7Previsões 0/0
Controlador (o seu código)
Modelo
Ambiente
loop.py
1failing = 2
2step = 0
3while failing > 0 and step < 5:
4    step += 1
5    failing -= 1  # pretend each edit fixes one test
6    print(f"step {step}: {failing} failing")
Saída
step 1: 1 failing
step 2: 0 failing

Principais conclusões

  • O ciclo de um agente repete observar → pensar → agir → verificar até terminar ou ser parado.

  • O modelo propõe; o seu código executa, registra e decide se continua.

  • Verifique o progresso com a verdade vinda do ambiente, não com as afirmações do modelo.

Quiz da aula

6 perguntas · aprovação com 5 acertos · até 50 XP

Ao passar, você conclui a aula e mantém sua sequência. As perguntas erradas voltarão em sessões de revisão.

Pratique: escreva código em Python

Escreva código Python no editor e execute os testes com exemplos. O Python roda localmente no navegador usando WebAssembly.

Exercício 1

Interprete um rastro ReAct

+25 XP

Cada linha começa com Thought:, Action:, Observation: ou Final Answer:. Junte cada Action com a Observation que vem depois dela e imprima step N: ACTION -> OBSERVATION. Depois imprima final: ANSWER (ou final: none) e actions: K.

  • Um rastro concluído
  • Sem resposta final
main.py
Carregando editor…

O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.

Exercício 2

Rode um ciclo num ambiente

+25 XP

A linha 1 é o orçamento de etapas. A linha 2 é um objeto JSON que mapeia chamadas de ferramenta para resultados (o ambiente). Cada linha seguinte é a próxima ação do modelo. Rode o ciclo:

  • uma ação que começa com answer: imprime final: TEXT e para;
  • se o orçamento já tiver acabado, imprima stopped: step budget reached e pare;
  • caso contrário, imprima step N: ACTION -> RESULT, usando error: unknown tool call para ações que não estão no ambiente (o modelo vê o erro e pode se recuperar).

Se as ações acabarem sem uma resposta, imprima stopped: no answer.

  • Recupera-se de uma chamada ruim
  • O orçamento acaba
main.py
Carregando editor…

O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.

Dúvidas sobre esta lição

Travou em algum ponto? Pergunte. Descobriu algo? Compartilhe. Explicar também é uma ótima forma de aprender.

Carregando publicações…