P1 · As 7 peças com as suas palavras
15 minCopie a tabela acima e preencha cada linha com uma frase sua e a pasta onde a peça fica.
Pronto quando: as sete linhas estão preenchidas e nenhuma frase foi copiada do texto da aula.
Aula 1 · 15 min
As sete peças de um Jarvis
Todo agente, do mais simples ao mais caro, tem as mesmas sete peças: uma porta, um coração, uma identidade, um cérebro, uma memória, mãos e um cofre. Quem conhece as peças escolhe melhor, gasta menos e não fica preso a um produto. O INTELECTO é o nosso exemplo: pequeno de propósito, para dar para ler.
Começar a aula
Nesta aula você vai
- 1O caminho de uma mensagem, do Telegram ao modelo e de volta
- 2O que cada uma das sete peças faz
- 3Por que o loop com freio separa um agente de um chatbot
- 4Como os contratos deixam trocar uma peça sem mexer no resto
Objetivo: explicar o caminho de uma mensagem e dizer, para cada uma das sete peças, o que ela faz e onde fica no INTELECTO.
01Sete peças, um caminho
Role a página: cada etapa acende uma peça.
Role a página: cada etapa abaixo acende a sua parte do diagrama.
- 1/8
Canal
É por onde você conversa. No INTELECTO é o Telegram: um token e pronto, sem endereço público na internet. O agente pergunta ao Telegram se chegou mensagem nova, divide respostas acima de 4 mil caracteres e mostra o "digitando" enquanto pensa.
- 2/8
Loop
Recebe a mensagem, pensa, usa uma ferramenta se precisar, olha o resultado e pensa de novo, até responder com texto. Tem freio: no máximo cinco rodadas de ferramenta por mensagem. Passou disso, ele é obrigado a responder.
- 3/8
Identidade
Quatro arquivos simples na pasta workspace: a alma, as regras, o seu perfil e os fatos iniciais. A cada mensagem o agente lê os quatro. Mudou o texto, mudou o assistente, sem programar.
- 4/8
Cérebro
O modelo de IA. Na nuvem, o OpenRouter: uma chave dá acesso a mais de cem modelos. No seu computador, o Ollama: sem custo por mensagem e sem mandar nada para fora.
- 5/8
Memória
Guarda o que importa num banco SQLite na sua máquina, com busca por palavras, sem custo de API. A cada mensagem busca o que é relevante e põe no contexto.
- 6/8
Ferramentas
Sem ferramentas ele só conversa; com elas ele faz. No núcleo: ler e escrever arquivo, listar pasta, rodar comando, salvar e buscar na memória. Cada ferramenta se descreve sozinha, e o modelo lê essa descrição para decidir usá-la.
- 7/8
Cofre
Chaves de API cifradas e presas à máquina, lista de comandos proibidos, tempo-limite de 60 segundos por comando e um log de auditoria com tudo o que ele executou.
- 8/8
O caminho inteiro
Você escreve no Telegram. O loop junta identidade e memória, manda ao modelo, executa a ferramenta que ele pedir, dentro dos limites do cofre, e a resposta volta pelo mesmo canal.
As mesmas sete peças aparecem no INTELECTO, no OpenClaw, no Hermes ou num Jarvis feito por você.
02Três ideias que seguram as peças
Clique em cada aba.
1. Um dono só
O INTELECTO é um assistente pessoal para um dono. Não é multiusuário, não depende de nuvem, não precisa de Docker, não tem painel web e não é caixa-preta.
O plano prevê umas três mil linhas e sete dependências: dá para ler.
Teste da caixa-preta
Consigo explicar o que acontece entre a minha mensagem e a resposta? Se não, é caixa-preta.
2. Loop com freio
Um chatbot responde e esquece. Um agente pensa, age com uma ferramenta, olha o resultado e pensa de novo.
Sem teto, um agente pode ficar girando e gastando sem terminar. Por isso o freio de cinco rodadas.
Regra do loop
No máximo 5 rodadas de ferramenta por mensagem; depois disso, responder com texto.
3. Contratos
Cada peça é definida por um contrato: o canal tem começar, enviar e parar; o provedor recebe a conversa e as ferramentas e devolve a resposta.
Quer WhatsApp no lugar do Telegram, ou Ollama no lugar do OpenRouter? É outro arquivo com o mesmo contrato.
Na prática
Nova ferramenta = arquivo novo no mesmo modelo. O registro encontra sozinho, sem mexer no núcleo.
4. Comece pequeno
O guia de funcionalidades organiza tudo em oito corredores: identidade, segurança, canais, memória, automação, integrações, skills e arquitetura.
Você não precisa de tudo. Agendamento e busca na web, por exemplo, estão no plano da próxima fase.
Montagem mínima
Loop + um cérebro + um canal + um SOUL básico. Memória entra logo em seguida.
03Onde cada peça mora
A árvore do núcleo que o agente constrói no exemplo do repositório.
exemplo-jarvis · pastas
jarvis/ channels/ # a porta: terminal e Telegram agent/ # o coração: loop.py e context.py providers/ # o cérebro: contrato + modelo de teste memory/ # a memória: SQLite com busca tools/ # as mãos: arquivos, comando, memória security/ # o cofre: segredos e lista de bloqueio workspace/ SOUL.md AGENTS.md USER.md MEMORY.md # a identidade
Minha tabela das 7 peças
| Peça | O que faz (com as minhas palavras) | Onde fica | |-------------|------------------------------------|-----------| | Canal | | | | Loop | | | | Identidade | | | | Cérebro | | | | Memória | | | | Ferramentas | | | | Cofre | | |
Exemplo do repositório
- Você escreve no Telegram.
- O canal recebe e entrega ao loop.
- O loop monta o contexto: SOUL + AGENTS + USER e as memórias relevantes.
- O modelo responde ou pede uma ferramenta; o loop executa e devolve (até 5 rodadas).
- A resposta volta pelo canal.
Chatbot: responde, esquece quando a conversa acaba, não tem identidade, não age, não conhece você.
Jarvis: lembra de conversas passadas, tem nome e valores escritos, usa ferramentas e conhece o seu contexto.
04Prática: mapeie as peças
Antes de construir, entenda o que vai construir.
P2 · O caminho em voz alta
5 minExplique para alguém (ou grave um áudio) o caminho de uma mensagem do Telegram até a resposta.
Pronto quando: você citou canal, loop, identidade, memória, modelo e ferramenta na ordem certa, sem olhar.
05As sete peças em vídeo
O Nei abre o INTELECTO peça por peça.
INTELECTO: as 7 peças de um agente de IA · 7 min 46 sPágina do vídeo com roteiro →
06Teste o que aprendeu
A explicação aparece depois da sua resposta.
Pergunta 1 de 4
O que faz um agente deixar de ser só um chatbot?competência
Correto
É o loop que transforma conversa em ação. O modelo pode ser o mesmo; o que muda é poder usar ferramentas e olhar o resultado antes de responder.Não é essa
É o loop que transforma conversa em ação. O modelo pode ser o mesmo; o que muda é poder usar ferramentas e olhar o resultado antes de responder.Rever: Três ideias que seguram as peçasPergunta 2 de 4
Para que serve o limite de cinco rodadas de ferramenta?
Correto
O teto obriga o agente a responder depois de cinco rodadas. Um loop curto, legível e com teto é o que separa um agente útil de um que gasta sem parar.Não é essa
O teto obriga o agente a responder depois de cinco rodadas. Um loop curto, legível e com teto é o que separa um agente útil de um que gasta sem parar.Rever: Sete peças, um caminhoPergunta 3 de 4
Você quer trocar o Telegram pelo WhatsApp. O que muda?
Correto
Cada peça é um contrato. Um canal novo implementa as mesmas três funções e o loop nem percebe a troca.Não é essa
Cada peça é um contrato. Um canal novo implementa as mesmas três funções e o loop nem percebe a troca.Rever: Três ideias que seguram as peçasPergunta 4 de 4
Onde mora a personalidade do assistente?
Correto
SOUL, AGENTS, USER e MEMORY são texto simples. O agente lê os quatro a cada mensagem: mudou o texto, mudou o assistente.Não é essa
SOUL, AGENTS, USER e MEMORY são texto simples. O agente lê os quatro a cada mensagem: mudou o texto, mudou o assistente.Rever: Onde cada peça moraTeste concluído
Você acertou {a} de {n}. Acertando todas, a aula é marcada como concluída.Escolha uma alternativa. A explicação aparece depois da sua tentativa.