📖 O agente lê a própria documentação
A documentação oficial do Hermes está em https://hermes-agent.nousresearch.com/docs e o próprio agente sabe consultá-la. Quando você pede algo que ele não sabe fazer, ele pode buscar na própria doc, em links de X/Twitter, em GitHub READMEs ou em URLs que você fornecer.
🪄 Frases que destravam o agente
- →"Pesquise como fazer X e me diga o que você precisa de mim."
- →"Leia esta doc <link> e implemente no nosso ambiente."
- →"Não sei configurar Y. Pesquise e me dê instruções passo a passo."
- →"Esse erro apareceu: <cola erro>. Investigue e proponha solução."
💡Por que isso reduz a curva
Você não precisa decorar comandos, sintaxe de cron ou estrutura de skills. Pergunta e ele acha. Use o agente como tutor pessoal de si mesmo.
🔗 Drop links e ele implementa
Cole um post no X, um repositório do GitHub ou uma doc de produto, e peça pra ele ler e tentar implementar a ideia ou ferramenta no seu ambiente.
🧪 Padrão "vi demo → cola → testa"
Esse fluxo acelera experimentação radicalmente. Você converte conteúdo em capacidade real do seu agente em minutos:
- Vê alguém demonstrando uma skill nova no Twitter
- Cola o link no Hermes
- Pede: "Avalie se faz sentido pro meu setup. Se sim, instale e teste."
- Ele lê, planeja e te faz as perguntas certas no caminho
⚠️Cuidado
Sempre revise antes de aprovar permissões permanentes. Nem tudo o que aparece no X é seguro ou aplicável ao seu setup. Comece com permissão "uma vez" antes de "sempre permitir".
🐛 Erros viram tarefa do próprio agente
Quando algo quebra (Telegram não responde, .env errado, cron falha), você cola o erro ou descreve o sintoma e pede pra ele diagnosticar. Ele tem ferramentas pra checar processos, ler logs e reiniciar serviços.
✓ Bom prompt de diagnóstico
"Mandei mensagem no Telegram às 14h32 e o bot não respondeu. Outras mensagens funcionaram. Verifique o gateway, leia gateway.log das últimas 10 min e me diga o que aconteceu."
✗ Prompt ruim
"Não funciona."
Sem comando, sem mensagem de erro, sem contexto. O agente vai gastar 5 turnos só pra entender o que você quis dizer.
🪜 Comece pequeno, evolua sempre
Não tente configurar tudo no primeiro dia. Um MVP do agente bem montado vale mais que um frankenstein ambicioso difícil de debugar.
🎯 MVP recomendado para os primeiros 7 dias
- VPS ou container Docker no ar
- Telegram conectado e respondendo
- GitHub privado configurado para backup
- Um cron simples (backup diário à meia-noite)
- Onboarding inicial: você falou quem é, projetos, preferências
Só isso. Use por uma semana. Depois adicione skills e crons conforme a vida pedir.
💡Princípio
"Primeiro que funcione, depois que melhore." Cada peça nova testada isoladamente é mais fácil de manter que 10 peças configuradas juntas no sábado de tarde.
👷 Trate como funcionário novo
Mentalidade de onboarding: você não dá acesso total a um estagiário no dia 1. Mesma coisa com o Hermes — comece com escopos limitados, expanda conforme confiança aumenta.
✓ Boas práticas
- ✓Tokens com escopo apertado
- ✓Contas separadas (AgentMail, Gmail dedicado)
- ✓IPs travados quando possível
- ✓Permissões revogáveis em 1 clique
- ✓Chaves nomeadas por agente
✗ O que evitar
- ✗Token com permissão admin completa
- ✗Sua conta pessoal logada no agente
- ✗Mesma chave compartilhada entre agentes
- ✗"Sempre permitir" para tudo no dia 1
- ✗Cartão de crédito direto na API
📝 Treinar é continuar usando
O Hermes não termina de ser configurado. Cada erro é oportunidade de atualizar memória ou skill. Cada acerto é candidato a virar processo reutilizável.
🔁 Regra dos 2 erros
- →Errou uma vez: corrige e segue.
- →Errou duas vezes: pare, atualize a skill ou memória.
- →Repetiu instrução: vira skill.
- →Tom errado: ajusta o soul.
- →Pediu informação que ele já tinha: salva na memória.
📈O que muda em 30/60/90 dias
- Dia 1-7: agente genérico, ainda errando tom e detalhes
- Dia 30: memória estabilizada, primeiras skills úteis, crons rodando
- Dia 60: tom alinhado, processos da sua rotina já automatizados
- Dia 90: agente proativo de verdade — reduz fricção em vez de criar
🎯Resumo do módulo
Próximo módulo:
1.3 - 🖥️ Onde rodar o Hermes