E1 · Desenhe o seu Jarvis
15 minEscreva o meu-jarvis.md com o modelo: nome, jeito, três deve, três nunca e o que lembrar de você.
Pronto quando: o arquivo cabe numa tela e outra pessoa entenderia quem é o seu assistente.
Aula 2 · 20 min
Desenhe o seu Jarvis antes de instalar
O assistente vira seu nos arquivos de texto, não no código. Antes de instalar qualquer coisa, você escreve quem ele é, o que deve e o que nunca deve fazer, e o que precisa lembrar de você. Esse desenho responde às perguntas da instalação e vira os quatro arquivos da identidade.
Começar a aula
Nesta aula você vai
- 1Escrever o desenho do assistente numa tela
- 2O que vai no SOUL, no AGENTS, no USER e no MEMORY
- 3Diferença entre um SOUL eficaz e um fraco
- 4Transformar uma vontade vaga num pedido concreto
Objetivo: escrever o meu-jarvis.md e transformá-lo nos quatro arquivos da identidade: SOUL, AGENTS, USER e MEMORY.
01Do desenho aos quatro arquivos
Clique em cada bloco.
Clique em cada bloco do diagrama para ver o que ele faz.
A cada mensagem, o agente junta SOUL, AGENTS e USER no começo da conversa. Editar um arquivo de texto muda o assistente, sem mexer em código.
02Como escrever cada parte
Clique em cada aba.
1. O desenho
Responda cinco perguntas: 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ê.
Seja concreto. "Cuide do meu e-mail" é vago; "toda segunda, liste as três prioridades da semana a partir do que eu contei" é um pedido.
Pronto quando
O arquivo cabe numa tela e outra pessoa entenderia quem é o seu assistente.
2. A alma
Um SOUL eficaz tem valores claros, tom específico com exemplo, limites explícitos e estilo de resposta definido.
Um SOUL fraco diz "seja útil e amigável", se contradiz (formal e casual ao mesmo tempo) ou é longo demais e dilui o foco.
Do exemplo do repositório
Direto e conciso. Honesto: se não sabe, diz. Quero um parceiro que discorde, não alguém que só concorda.
3. As regras
Separe em SEMPRE e NUNCA. As regras do exemplo: consultar a memória antes de responder, salvar o que aprender sobre você, perguntar quando estiver em dúvida.
Para ferramentas: preferir comandos seguros, só de leitura, e recusar os destrutivos.
Regra do NUNCA
Nunca apagar arquivo sem a minha confirmação. Nunca colocar senha ou chave numa resposta.
4. Você e os fatos
No USER vai o que ele precisa saber de você sem perguntar toda vez: o que você faz, como gosta das respostas, em que língua.
No MEMORY, poucos fatos que valem desde o primeiro dia. Fique curto: o que vier depois, ele aprende conversando.
USER do exemplo
Prefere conselho prático a teoria. Valoriza tempo: seja conciso. Fala português (pt-BR).
03Modelos para copiar
Preencha primeiro o meu-jarvis.md; os outros saem dele.
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:
workspace/SOUL.md
# Soul Você é <NOME>, assistente pessoal de <SEU NOME>. ## Personalidade - <tom, com um exemplo de como fala> - Honesto: se não sabe, diz. ## Valores - Privacidade primeiro: nunca compartilhar meus dados. - <um valor inegociável seu>
workspace/AGENTS.md
# Regras ## SEMPRE - Consultar a memória antes de responder. - Salvar na memória o que aprender sobre mim. - Perguntar quando estiver em dúvida, em vez de adivinhar. ## NUNCA - <as três do seu meu-jarvis.md> - Rodar comando destrutivo; preferir comandos só de leitura.
workspace/USER.md e MEMORY.md
# USER.md ## Sobre <SEU NOME> - Profissão: - Rotina: - Como gosto das respostas: - Idioma: português (pt-BR) # MEMORY.md ## Fatos - <fato que ele deve saber desde o dia 1> - <outro fato>
Exemplo do repositório
Personalidade: direto e conciso, sem enrolação; proativo, sugere quando é relevante; honesto, se não sabe, diz; lembra o contexto das conversas anteriores.
Valores: privacidade primeiro, nunca compartilhar os dados do dono; ter opinião, porque o dono quer um parceiro de discussão, não alguém que só concorda.
- Eficaz: valores claros e testáveis, tom com exemplo, limites explícitos, estilo de resposta definido.
- Fraco: "seja útil e amigável", só comportamentos e nenhum valor, contradições, longo demais.
04Prática: o desenho do seu Jarvis
Exercício E1 da sequência 2, aprofundado.
E1b · Os quatro arquivos
25 minA partir do desenho, escreva SOUL.md, AGENTS.md, USER.md e MEMORY.md numa pasta workspace/.
Pronto quando: cada "nunca" do desenho virou uma linha no NUNCA do AGENTS.md e o SOUL não tem a frase "seja útil e amigável".
Exercício original: jornada-agentes/exercicios/02-jarvis.md.
05Teste o que aprendeu
A explicação aparece depois da sua resposta.
Pergunta 1 de 3
Qual destes trechos de SOUL.md é o mais fraco?competência
Correto
"Seja útil e amigável" é vago demais: não dá para testar e todo modelo já tenta isso. Os outros dizem um tom, um valor ou um limite concreto.Não é essa
"Seja útil e amigável" é vago demais: não dá para testar e todo modelo já tenta isso. Os outros dizem um tom, um valor ou um limite concreto.Rever: Como escrever cada partePergunta 2 de 3
"Nunca apagar arquivo sem confirmação" vai em qual arquivo?
Correto
AGENTS.md é o contrato de trabalho: o que fazer sempre e o que nunca fazer. O SOUL diz quem ele é; o USER, quem é você.Não é essa
AGENTS.md é o contrato de trabalho: o que fazer sempre e o que nunca fazer. O SOUL diz quem ele é; o USER, quem é você.Rever: Do desenho aos quatro arquivosPergunta 3 de 3
Você quer o assistente mais formal. O que fazer?
Correto
A personalidade é texto. O agente relê os arquivos a cada mensagem: editou o SOUL, mudou o jeito de falar.Não é essa
A personalidade é texto. O agente relê os arquivos a cada mensagem: editou o SOUL, mudou o jeito de falar.Rever: Do desenho aos quatro arquivosTeste 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.