Agente por peças|INEMA.CLUB-PRO

Aula 1 · 12 min

O mapa do agente, e o objetivo do seu

No chat, você pede e a IA devolve texto; quem faz é você. Um agente recebe o pedido sozinho, faz a tarefa e confere antes de dizer pronto. Nesta aula você vê as peças de um agente num mapa só, baixa o kit e escreve o objetivo do seu.

Começar a aula
Peças de um mecanismo organizadas sobre uma mesa clara, prontas para montar.

Nesta aula você vai

  1. 1A diferença entre o chat e um agente
  2. 2As nove peças do mapa, e em que aula cada uma entra
  3. 3Escrever o objetivo antes de escrever código

Objetivo: baixar o kit, confirmar o login do Codex e escrever o objetivo.md: o que o agente faz, o que não faz e quando está pronto.

Você está aquias peças acesas são as desta aula

Clique em cada bloco do diagrama para ver o que ele faz.

01Chat ou agente?

Clique em Próximo passo: o mesmo pedido, nos dois caminhos.

02O que você precisa

Três coisas. Clique em cada uma.

1. O terminal

O kit roda no terminal, com o Python 3 que já vem no Linux e no Mac. No Windows, use o WSL, que é um Linux dentro do Windows.

No kit, nada além do Python: nenhuma biblioteca para instalar.

03Baixe o kit

Rode no terminal. A primeira linha da saída tem de ser Logged in.

Terminal · baixar o kit
cd ~ && git clone -q https://github.com/inematds/agente-por-pecas-kit && cd agente-por-pecas-kit
git checkout -q aula1
codex login status && cat objetivo.md
Exemplo do repositório
Logged in using ChatGPT
# Objetivo do meu agente

## O que ele faz
Recebe pedidos pelo chat, pelo Telegram e por arquivos numa pasta, e devolve a resposta ou faz a tarefa
(anotar na lista, ler um arquivo, lembrar de um fato).

## O que ele NÃO faz
- Não mexe em nada fora da pasta `trabalho/`.
- Não substitui arquivo que já existe sem o meu OK.
- Não responde a quem não é o dono no Telegram.

## Quando está pronto
- Um pedido exato ("adicione pão na lista") é feito pela receita, sem chamar o modelo.
- Um pedido aberto ("resuma notas.txt") passa pelo modelo e o verificador confere o resultado.
- Se o verificador reprovar 3 vezes, o agente cancela e avisa.

04O curso em vídeo

Em dois minutos e meio: por que um agente de verdade só diz pronto depois de conferir, as peças que ele tem e o juiz que cancela depois de 3 tentativas.

Agente por peças, em vídeo · 2 min 30 sPágina do vídeo com roteiro →

05Prática: o objetivo do seu agente

Faça na ordem.

E1 · O kit na sua máquina

5 min

Instale o Codex, faça o codex login e rode o bloco acima.

Pronto quando: a saída começa com Logged in using ChatGPT e mostra o objetivo.md do kit.

E2 · O seu objetivo

10 min

Abra o objetivo.md e reescreva as três partes para o agente que você quer: o que ele faz, o que não faz e quando está pronto.

Pronto quando: o arquivo tem as três partes, e a parte "Quando está pronto" tem pelo menos uma frase que dá para conferir (um arquivo, uma palavra, um número).

06Teste o que aprendeu

A explicação aparece depois da sua resposta.

Pergunta 1 de 4

Qual é a diferença central entre o chat e um agente?

07Resumo da aula

ChatResponde texto; quem faz é você.
AgenteRecebe, faz e confere antes de dizer pronto.
ObjetivoFaz, não faz e quando está pronto, com algo que dá para conferir.
Próxima aula