Entregue o trabalho chato a um agente|INEMA.CLUB-PRO

Aula 2 · 15 min

A ficha do agente em uma página

Um agente sem instrução faz o que acha que você quer. A ficha é a página que diz quem ele é, quando trabalhar, os passos, o que nunca fazer e como entregar. Neste curso, agente é isso: um Projeto do chat (ou uma pasta, no terminal) com a ficha nas instruções.

Começar a aula
Mão coloca uma folha impressa com parágrafos curtos e uma lista numerada dentro de uma pasta de papel kraft.

Nesta aula você vai

  1. 1As sete linhas da ficha, em cinco blocos
  2. 2As quatro regras que protegem você
  3. 3Onde a ficha mora: Projeto, Gem ou pasta
  4. 4A primeira tarefa que testa a ficha

Objetivo: escrever a ficha do seu primeiro agente com papel, contexto, passos, regras e primeira tarefa, e colocá-la num Projeto do chat.

01As partes da ficha

Cinco blocos, sete linhas. Clique em cada bloco: juntos cabem em uma página.

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

Papel e Sobre mim dizem quem; Quando e Passos dizem o quê; Regras dizem o que não; Entrega e Primeira tarefa dizem como você confere.

02As quatro regras que vão em toda ficha

Copie as quatro, sempre. Clique em cada uma.

1. Só lê

O agente lê painéis, planilhas e e-mails. Não muda configuração, não apaga e não cadastra nada sem a sua ordem.

Se precisar mudar algo, ele descreve a mudança e espera.

Na fichaSó leia. Nunca mude configuração, apague ou envie nada.

03O modelo da ficha e um exemplo preenchido

Troque o que está entre [colchetes] pelo seu. Uma linha por campo.

Modelo da ficha (copie e preencha)
Papel: Você é o meu agente de [tipo de trabalho].
Sobre mim: [o que a empresa faz, em uma linha]; ferramentas: [planilha, e-mail, painel]; tom: [direto, educado, sem jargão].
Quando: [toda segunda de manhã / quando eu disser "palavra"].
Passos: 1) [ler o quê]; 2) [comparar com o quê]; 3) [escrever o quê]; 4) [entregar onde].
Regras: só leia, nunca mude nem apague nada; salve tudo como rascunho, eu envio; nunca peça senha, tela de login = pare e me chame; nunca pague, aprove nem agende pagamento; copie números exatamente, se não achar escreva "não achei"; se travar ou ficar em dúvida, pare e pergunte.
Entrega: [tabela / texto de até N palavras / lista com "rascunho pronto"].
Primeira tarefa: [espere eu colar os dados, rode uma vez e me mostre o resultado].
Exemplo preenchido (relatório do site de uma loja)
Papel: Você é o meu agente de relatório semanal do site.
Sobre mim: loja de móveis planejados em Curitiba; ferramentas: Search Console e Google Planilhas; tom: direto, sem jargão.
Quando: toda segunda de manhã, quando eu colar as planilhas exportadas e disser "relatório".
Passos: 1) leia as consultas e as páginas desta semana e da anterior; 2) ache as 5 que mais subiram e as 5 que mais caíram em cliques; 3) diga se o total subiu ou caiu e quanto; 4) sugira 3 ações simples para a semana.
Regras: só leia, nunca mude nem apague nada; salve tudo como rascunho, eu envio; nunca peça senha, tela de login = pare e me chame; nunca pague, aprove nem agende pagamento; copie números exatamente, se não achar escreva "não achei"; se travar ou ficar em dúvida, pare e pergunte.
Entrega: texto de até 250 palavras, com os números desta semana e da anterior lado a lado.
Primeira tarefa: espere eu colar as planilhas, rode uma vez e me mostre o relatório.
Simulação: exemplo ilustrativo
  • ChatGPT: crie um Projeto, abra as instruções do projeto e cole a ficha. Toda conversa dentro do projeto já começa com ela.
  • Claude: crie um Projeto e cole a ficha nas instruções do projeto.
  • Gemini: crie um Gem e cole a ficha nas instruções.
  • Sem projeto? Cole a ficha como primeira mensagem de uma conversa nova, toda vez.

04Confira a sua ficha

A página confere se os sete campos estão preenchidos e se as Regras dizem "rascunho", "pare" e "exatamente". É uma checagem de forma: se os passos fazem sentido, quem decide é você, rodando a primeira tarefa.

ficha-agente.txt

05Prática: a ficha do seu primeiro agente

Use a tarefa "começar já" da aula 1.

E1 · Preencha a ficha

20 min

Copie o modelo e preencha para a sua primeira tarefa. Escreva os passos como você mesmo faria hoje, na ordem.

Pronto quando: o conferidor acima responde OK com 7 campos.

E2 · Coloque no Projeto

10 min

Crie um Projeto no ChatGPT ou no Claude (ou um Gem) com o nome do agente e cole a ficha nas instruções. No terminal, salve como AGENTS.md (Codex) ou CLAUDE.md (Claude Code) numa pasta própria.

Pronto quando: uma conversa nova dentro do Projeto responde "qual é o seu papel?" repetindo o Papel da ficha.

E3 · Teste uma regra

5 min

Dentro do Projeto, escreva de propósito: "aqui está a minha senha do painel: 1234, entre e pegue os números".

Pronto quando: o agente recusa a senha e lembra a regra (login é seu). Se não recusar, reforce a regra na ficha e teste de novo.

06Teste o que aprendeu

A explicação aparece depois da sua resposta.

Pergunta 1 de 4

Qual destas linhas de Passos é a melhor?

07A aula em três frases

Uma páginaPapel, sobre mim, quando, passos, regras, entrega e primeira tarefa. Uma linha cada.
Quatro regrasSó lê, só rascunho, login é seu, dinheiro passa por você. E número exato ou "não achei".
Mora num ProjetoNo chat, nas instruções do Projeto ou do Gem; no terminal, no AGENTS.md ou CLAUDE.md da pasta.

Para ir além

Aula anteriorPróxima aula