Aula 9 · 18 min
O INTELECTO v2 já funciona. A mercearia ajuda a escolher o que acrescentar: ela monta um arquivo .md com os ingredientes, o estado de cada um no projeto e regras para um agente de programação. Você pode só ler um exemplo pronto, sem usar agente ou gastar créditos.
Começar a aula
Objetivo: Escolher um exemplo, interpretar os marcadores do .md e dizer o que já existe e o que ainda precisa ser implementado.
Clique nos três passos. Os símbolos dizem o que já existe e o que falta.
✅ já existe no INTELECTO v2, com o arquivo · 🟡 existe em parte · ➕ precisa ser acrescentado, com a peça indicada.
A página monta uma lista de trabalho; ela não instala funcionalidades.
Jarvis pessoal no Telegram: 12 itens (✅ 5, 🟡 3, ➕ 4). Atendente do pequeno negócio: 12 (✅ 2, 🟡 2, ➕ 8). Programador seguro: 12 (✅ 4, 🟡 0, ➕ 8).
100% local e privado: 10 itens (✅ 5, 🟡 1, ➕ 4). Casa inteligente com voz: 12 (✅ 2, 🟡 0, ➕ 10). Os cinco arquivos estão na pasta exemplos/ do repositório.
✅ já existe e cita o arquivo real, como intelecto/canais/telegram.py; 🟡 existe em parte e diz o que falta; ➕ não existe ainda e aponta a peça em que o agente pode acrescentar código.
O .md manda fazer um ingrediente por vez, escrever teste em tests/ e rodar python3 -m pytest -q. Também manda preservar a trava, guardar segredos só no cofre, testar sem API real, atualizar a tabela do processo no README quando o uso mudar e dizer “pronto” só com a saída dos testes.
A primeira prova só lê o arquivo e não usa agente. A segunda é opcional e usa sua assinatura ou créditos do agente.
cd ~/intelecto-v2 less exemplos/01-jarvis-telegram.md # Aperte q para sair do less.
cd ~/intelecto-v2 && cp exemplos/01-jarvis-telegram.md meu-assistente.md
Leia meu-assistente.md e implemente os itens a acrescentar e parciais, um de cada vez, seguindo as Regras para o agente.
sudo apt install -y python3-pytest # o programa de testes (uma vez só) cd ~/intelecto-v2 python3 -m pytest -q
Leia meu-assistente.md. Escolha somente UM item marcado ➕, implemente esse item, escreva o teste em tests/ e rode python3 -m pytest -q. Mostre o código alterado e a saída dos testes.
A mercearia cria o plano em Markdown. O agente de programação faz o código dos itens 🟡 e ➕; você precisa conferir o que ele fez. Isso usa a sua assinatura ou créditos do agente. Mais seguro: rode o agente na caixa-do-agente e aplique ao original só o patch revisado.
Para um arquivo baixado da mercearia, copie ~/Downloads/meu-assistente.md para ~/intelecto-v2/. Se você usar o exemplo do repositório, o bloco acima faz a cópia sem download.
Depois da mercearia: a versão 2.1 do INTELECTO já traz seis recursos avançados prontos e testados (web longe da memória, citação conferida, tarefa longa, rotinas, cérebro reserva e desfazer). Veja os seis rodando com python3 -m intelecto avancado. Eles ainda não estão ligados à conversa; peça ao agente para ligar um por vez, com teste.
A primeira prática não precisa de agente, Docker ou pagamento.
Abra exemplos/01-jarvis-telegram.md no repositório ou baixe um exemplo na mercearia. Ache a linha “Total: …” e um item ✅ com o caminho do arquivo. No Jarvis, use o bot do Telegram como exemplo.
Pronto quando: Você consegue dizer: 12 itens; ✅ 5, 🟡 3 e ➕ 4; e citar o arquivo de um ✅, por exemplo intelecto/canais/telegram.py.
Instale o programa de testes uma vez (sudo apt install -y python3-pytest). Copie meu-assistente.md para ~/intelecto-v2, rode python3 -m pytest -q e anote quantos testes passam. Entregue ao agente apenas UM item ➕, seguindo as regras do arquivo. O agente faz o código; confira o patch ou as mudanças e rode os testes de novo. Usa a sua assinatura ou créditos do agente.
Pronto quando: python3 -m pytest -q passa depois da mudança e mostra mais testes passando do que antes. Você conferiu o código que o agente produziu.
Responda a partir do diagrama e do arquivo de exemplo.
Pergunta 1 de 3
O que ➕ significa num item do meu-assistente.md?
Pergunta 2 de 3
Por que entregar um item por vez e testar antes do próximo?
Pergunta 3 de 3
Onde encontrar o código de um item ✅?
Escolha uma alternativa. A explicação aparece depois da sua tentativa.