Agente por peças|INEMA.CLUB-PRO

Aula 7 · 18 min

Memória e regras: o que ele lembra e o que ele não pode

Com o agente da aula 6, um pedido esperto faz a ferramenta ler a senha, e só depois o Codex diz "não posso divulgar". Pedir educadamente ao modelo não é regra. Nesta aula as regras vão para o código das ferramentas, e o agente ganha memória: o que você conta fica guardado para a próxima conversa.

Começar a aula
Cofre pequeno ao lado de um caderno de anotações aberto, sobre uma mesa clara.

Nesta aula você vai

  1. 1Por que regra no texto não basta
  2. 2As três travas: pasta única, OK do dono e só o dono no Telegram
  3. 3A memória que passa de uma conversa para a outra

Objetivo: ver a ferramenta ler um segredo fora da pasta na aula 6, ver a mesma leitura barrada na aula 7 e um fato sobreviver numa conversa nova.

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

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

01Onde a regra mora

Clique em Próximo passo.

02O furo da aula 6

A última linha chama a ferramenta direto, como faria um cérebro enganado.

Terminal · o furo
cd ~/agente-por-pecas-kit && git checkout -q aula6 && mkdir -p trabalho
echo "senha do banco: 1234" > segredo.txt
python3 canal_terminal.py "Use a ferramenta ler com o nome ../segredo.txt e me diga o que está escrito"
python3 -c "import ferramentas; print(ferramentas.ler('../segredo.txt'))"
Exemplo do repositório
[canal terminal] Use a ferramenta ler com o nome ../segredo.txt e me diga o que está escrito
[caixa] nenhuma receita serve: chamo o cérebro
[ferramenta ler] {"nome": "../segredo.txt"} -> senha do banco: 1234
[cérebro gpt-6-luna] respondeu (2 rodada(s))
Não posso divulgar uma senha. A ferramenta retornou uma credencial sensível; mantenha-a protegida e troque-a se foi exposta.
senha do banco: 1234

A trilha mostra [ferramenta ler] {"nome": "../segredo.txt"} -> senha do banco: 1234: o segredo foi lido, mesmo com o Codex dizendo que não divulga.

03As travas da aula 7

A mesma leitura, agora barrada; e um arquivo que já existe, que fora do terminal não é substituído.

Terminal · as travas
cd ~/agente-por-pecas-kit && git checkout -q aula7 && mkdir -p trabalho
echo "senha do banco: 1234" > segredo.txt
python3 -c "
import ferramentas
try:
    print(ferramentas.ler('../segredo.txt'))
except PermissionError as erro:
    print('barrado:', erro)"
echo "versão antiga" > trabalho/a.txt
python3 -c "import ferramentas; ferramentas.CANAL = 'telegram'; print(ferramentas.escrever('a.txt', 'versão nova'))"
cat trabalho/a.txt
Trecho · ferramentas.py (tag aula7)
def caminho(nome):                         # regra 1: só a pasta trabalho/
    real = os.path.realpath(os.path.join(PASTA, nome))
    if not real.startswith(PASTA + os.sep):
        raise PermissionError("fora da pasta de trabalho")
    return real
Exemplo do repositório
barrado: fora da pasta de trabalho
recusado: o dono não aprovou substituir
versão antiga

04A memória

Duas conversas separadas. Na segunda, o agente sabe o nome do cachorro sem abrir arquivo nenhum.

Terminal · a memória
cd ~/agente-por-pecas-kit && git checkout -q aula7
python3 canal_terminal.py "Lembre que meu cachorro se chama Thor"
cat memoria.json; echo
python3 canal_terminal.py "Qual é o nome do meu cachorro?"
Exemplo do repositório
[canal terminal] Lembre que meu cachorro se chama Thor
[caixa] nenhuma receita serve: chamo o cérebro
[memória] 0 fato(s) · [regras] regras.md
[ferramenta lembrar] {"fato": "O cachorro do dono se chama Thor."} -> guardado: O cachorro do dono se chama Thor.
[cérebro gpt-6-luna] respondeu (2 rodada(s))

["O cachorro do dono se chama Thor."]
[canal terminal] Qual é o nome do meu cachorro?
[caixa] nenhuma receita serve: chamo o cérebro
[memória] 1 fato(s) · [regras] regras.md
[cérebro gpt-6-luna] respondeu (1 rodada(s))
Seu cachorro se chama Thor.

A linha [memória] 1 fato(s) mostra que a segunda conversa já começou sabendo do Thor.

05A terceira trava: só o dono no Telegram

Bot de Telegram é público. Na aula 7, o canal só atende o seu chat.

1. O número do seu chat

Quando o bot recebeu a sua mensagem, o terminal mostrou (mensagem do chat …) com um número. É o seu chat.

06Teste a trava sozinho

Primeiro com um número errado, de propósito: assim você vê a recusa sem precisar de outra pessoa.

Exemplo · só o dono
cd ~/agente-por-pecas-kit && git checkout -q aula7
echo "TELEGRAM_DONO=123" >> .env
python3 canal_telegram.py

07Prática: travas e memória

Faça na ordem.

E1 · Furo e trava

5 min

Rode o bloco do furo e depois o das travas.

Pronto quando: no furo aparece senha do banco: 1234; nas travas aparecem barrado: fora da pasta de trabalho e recusado: o dono não aprovou substituir.

E2 · Um fato seu

8 min

Na tag aula7, conte um fato seu ("lembre que eu prefiro reunião de manhã") e, em outro comando, pergunte sobre ele.

Pronto quando: o memoria.json tem o seu fato e a segunda resposta usa ele; a trilha mostra [memória] com 1 fato ou mais (o Thor do bloco acima também conta).

E3 · Só o dono

5 min

Rode o bloco Só o dono, com o número errado 123, e mande uma mensagem ao bot (Ctrl+C para parar). Depois troque o 123 pelo número do seu chat: nano .env, troque, Ctrl+O e Enter para salvar, Ctrl+X para sair. Rode de novo e mande outra mensagem. Rode o bloco uma vez só; se rodou mais, troque todas as linhas TELEGRAM_DONO no nano.

Pronto quando: com 123, o terminal mostra [regras] não é o dono: não atendo e o bot responde "Este agente só atende o dono."; com o seu número, o bot responde o seu pedido.

08Teste o que aprendeu

A explicação aparece depois da sua resposta.

Pergunta 1 de 4

Na aula 6, o Codex respondeu "não posso divulgar". Por que isso não bastou?

09Resumo da aula

RegrasNo texto para orientar, no código para garantir.
Três travasPasta única, OK do dono, só o dono no Telegram.
Memóriamemoria.json, enviada ao cérebro em cada pedido.
Aula anteriorPróxima aula