E1 · Desenhe o seu Jarvis
15 minEscreva o meu-jarvis.md: nome, jeito, o que deve fazer, o que nunca deve fazer e o que precisa lembrar.
Pronto quando: o arquivo cabe numa tela e outra pessoa entenderia quem é o seu assistente.
Aula 3 · 10 min
Degrau 2: o seu Jarvis com o INTELECTO
Um assistente pessoal escrito do zero em Python, pequeno de propósito: fala com você pelo Telegram, lembra das conversas e usa um modelo na nuvem ou local. Você deixa de abrir um site para conversar: o assistente é seu.
Começar a aula
Nesta aula você vai
- 1Desenhar o assistente antes de instalar
- 2Criar o bot no Telegram
- 3Testar a memória
- 4Escolher entre nuvem e local
Objetivo: desenhar, instalar e pôr para trabalhar um assistente com memória e personalidade definidas por você.
01A arquitetura do seu assistente
Do Telegram ao modelo e de volta.
Role a página: cada etapa abaixo acende a sua parte do diagrama.
- 1/5
Você
Você conversa pelo Telegram, no celular ou no computador, como com qualquer contato.
- 2/5
Bot do Telegram
O bot é a porta de entrada. Você o cria no @BotFather com /newbot e guarda o token apenas no .env, como aprendeu no degrau 1.
- 3/5
INTELECTO
O INTELECTO recebe a mensagem, junta a personalidade e o que lembra de você e monta o pedido ao modelo. É pequeno de propósito, para você entender e mudar.
- 4/5
Modelo
O modelo gera a resposta. Na nuvem (OpenRouter) é mais forte e tem custo por uso; local (Ollama) roda no seu computador, se ele aguentar.
- 5/5
A conversa completa
Você escreve no Telegram, o INTELECTO junta personalidade e memória, o modelo responde e a resposta volta para o mesmo chat. Tudo seu, com o token guardado no .env.
Quer ver outros sistemas de assistente prontos para instalar? A área JARVIS do Eventos reúne vários.
02Do desenho à rotina
Clique em cada etapa.
1. Desenhar
Antes de instalar, escreva quem é o assistente: nome, jeito de falar, três coisas que ele deve fazer toda semana, três que nunca deve fazer e o que precisa lembrar de você.
Esse arquivo responde às perguntas da instalação.
Teste
Outra pessoa lê o arquivo e entende quem é o seu assistente.
2. Criar o bot
No Telegram, abra o @BotFather, mande /newbot e escolha nome e @usuário.
Guarde o token só no .env.
Regra do degrau 1
O token não aparece em nenhum arquivo além do .env.
3. Instalar
Clone o INTELECTO, exporte o seu briefing na página de comparação e peça ao Claude Code ou ao Codex que construa a partir dele e do doc/intelecto.md, com testes.
Use as respostas do seu meu-jarvis.md. O passo a passo completo está na aula 4 do curso do degrau 2.
Pronto quando
Você manda "oi" e ele responde com o nome e o jeito que você definiu.
4. Memória e rotina
Conte três fatos seus num dia e pergunte no dia seguinte, numa conversa nova.
Depois transforme uma tarefa da semana em pedido fixo e use cinco dias seguidos.
Pedido fixo
Toda manhã, quando eu mandar "dia", liste as minhas três prioridades a partir do que eu te contei ontem.
03Modelo do desenho e a instalação
Copie o modelo, preencha e só depois instale.
meu-jarvis.md
# Meu Jarvis ## Nome e jeito de falar Nome: Como fala (formal, direto, bem-humorado): ## Deve fazer toda semana 1. 2. 3. ## Nunca deve fazer 1. 2. 3. ## O que precisa lembrar de mim - Profissão: - Rotina: - Preferências:
Terminal · baixar e provar o exemplo
git clone https://github.com/inematds/intelecto.git cd intelecto/exemplo-jarvis python3 -m unittest discover -s . -p 'test_*.py' -v python3 smoke.py
Exemplo do repositório
- O token do Telegram (do @BotFather), só no .env.
- O modelo: na nuvem (OpenRouter) ou local (Ollama).
- A personalidade: o seu meu-jarvis.md.
Rode a mesma pergunta nos dois e anote numa tabela:
- Tempo de resposta
- Qualidade da resposta
- Custo por uso
O objetivo é saber, com os seus números, qual modelo usar para quê.
04Prática: os 6 exercícios da sequência 2
Pré-requisito: a sequência 1 feita (terminal, pastas, .env).
E2 · O bot no Telegram
10 minCrie o bot no @BotFather com /newbot e guarde o token no .env.
Pronto quando: você tem o token e ele não aparece em nenhum arquivo além do .env.
E3 · Instalar
30 minClone o INTELECTO, exporte o briefing e peça ao agente que construa o seu Jarvis com testes (aula 4 do curso do degrau 2).
Pronto quando: você manda "oi" e ele responde com o nome e o jeito que você definiu.
E4 · Teste de memória
2 diasDia 1: conte três fatos seus. Dia 2, numa conversa nova: pergunte sobre eles.
Pronto quando: ele lembra sem você repetir.
E5 · Nuvem ou local
20 minMesma pergunta num modelo da nuvem (OpenRouter) e num local (Ollama). Anote tempo, qualidade e custo.
Pronto quando: você sabe dizer qual modelo usar para quê, com os seus números.
E6 · Uma rotina de verdade
20 minTransforme uma das tarefas do E1 em pedido fixo e use por uma semana.
Pronto quando: você usou 5 dias seguidos e anotou o que melhorar.
Exercícios completos: jornada-agentes/exercicios/02-jarvis.md. O desafio extra (a lista de tarefas para mandar e ir dormir) é a entrada do degrau 3.
05A sequência 2 em vídeo
O INTELECTO no Telegram, com memória e personalidade.
Crie o seu Jarvis · 1 min 33 sPágina do vídeo com roteiro →
06Teste o que aprendeu
A explicação aparece depois da sua resposta.
Pergunta 1 de 3
Por que escrever o meu-jarvis.md antes de instalar?competência
Correto
O desenho vem antes: com nome, jeito, o que fazer e o que nunca fazer escritos, você responde à configuração guiada sem improvisar e tem como avaliar se o assistente está certo.Não é essa
O desenho vem antes: com nome, jeito, o que fazer e o que nunca fazer escritos, você responde à configuração guiada sem improvisar e tem como avaliar se o assistente está certo.Rever: Do desenho à rotinaPergunta 2 de 3
O assistente não lembrou o que você contou ontem. Qual o primeiro passo?
Correto
O exercício E4 diz exatamente isso: se não lembrar, veja no curso do INTELECTO como a memória é guardada e ajuste.Não é essa
O exercício E4 diz exatamente isso: se não lembrar, veja no curso do INTELECTO como a memória é guardada e ajuste.Rever: Do desenho à rotinaPergunta 3 de 3
Quando faz sentido um modelo local (Ollama)?
Correto
A escolha é medida: mesma pergunta nos dois, tabela com tempo, qualidade e custo, e decisão com os seus números.Não é essa
A escolha é medida: mesma pergunta nos dois, tabela com tempo, qualidade e custo, e decisão com os seus números.Rever: Modelo do desenho e a instalaçãoTeste 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.