Email — IA Envia e Recebe Mensagens | Easy Understand Hermes Agent

Email — IA Envia e Recebe Mensagens

Imagine isto: você envia um e-mail para o seu agente de IA, e ele responde — direto na mesma conversa. Nada de app de chat sofisticado, nada de API de bot, nada de software extra. Apenas o bom e velho e-mail. É exatamente isso que o adaptador de gateway de Email faz para o Hermes.

Neste post, vamos mostrar como configurá-lo, como ele funciona por baixo dos panos e como manter sua caixa de entrada segura.

Por que Email?

E-mail é universal. Todo mundo tem um endereço. Ao conectar o Hermes à sua caixa postal via IMAP padrão (para receber) e SMTP (para enviar), você obtém uma IA conversacional que funciona com Gmail, Outlook, Yahoo, Fastmail ou qualquer provedor que suporte esses protocolos.

E aqui está a melhor parte: zero dependências externas. O adaptador usa os módulos nativos do Python imaplib, smtplib e email. Sem pacotes extras, sem serviços de terceiros.

Nota: Isso é diferente da skill de e-mail Himalaya inclusa, que permite ao agente gerenciar sua caixa postal através de comandos de terminal. Essa requer o CLI externo himalaya. Este adaptador de gateway é o caminho mais simples e autossuficiente.

Antes de Começar

Você vai precisar de três coisas:

Uma conta de e-mail dedicada para o seu agente (por favor, não use sua caixa pessoal)
IMAP habilitado nessa conta
Uma senha de app se você estiver usando Gmail ou qualquer provedor com autenticação de dois fatores

Para Gmail: ative a verificação em duas etapas e crie uma Senha de App em myaccount.google.com/apppasswords. Você receberá uma senha de 16 caracteres — use essa em vez da sua senha normal.

Para Outlook/Microsoft 365: ative a verificação em duas etapas, crie uma senha de app em “Opções de segurança adicionais” e use outlook.office365.com para IMAP e smtp.office365.com para SMTP.

Para outros provedores, consulte a documentação deles para hosts e portas IMAP/SMTP (geralmente 993 para IMAP SSL, 587 para SMTP STARTTLS).

Passo 1: Configurar o Hermes

O jeito mais fácil é o assistente de configuração:

hermes gateway setup

Selecione Email no menu e siga as instruções. Ele vai pedir seu endereço, senha de app, hosts IMAP/SMTP e remetentes permitidos.

Prefere configuração manual? Adicione isto ao ~/.hermes/.env:

# Obrigatório
EMAIL_ADDRESS=hermes@gmail.com
EMAIL_PASSWORD=abcd efgh ijkl mnop    # Senha de app, não a sua senha normal
EMAIL_IMAP_HOST=imap.gmail.com
EMAIL_SMTP_HOST=smtp.gmail.com

# Segurança (recomendado)
EMAIL_ALLOWED_USERS=your@email.com,colleague@work.com

# Opcional
EMAIL_IMAP_PORT=993                    # Padrão: 993
EMAIL_SMTP_PORT=587                    # Padrão: 587
EMAIL_POLL_INTERVAL=15                 # Segundos entre verificações da caixa de entrada
EMAIL_HOME_ADDRESS=your@email.com      # Destino padrão para jobs agendados

Passo 2: Iniciar o Gateway

hermes gateway              # Executar em primeiro plano
hermes gateway install      # Instalar como serviço do usuário
sudo hermes gateway install --system   # Linux: serviço do sistema na inicialização

Na inicialização, o adaptador testa as conexões IMAP e SMTP, marca todas as mensagens existentes na caixa de entrada como “lidas” (para processar apenas e-mails novos) e começa a verificar periodicamente.

Como Funciona

Recebendo mensagens. O adaptador verifica e-mails NÃO LIDOS a cada 15 segundos por padrão. Para cada nova mensagem:

A linha de assunto é incluída como contexto (ex.: [Subject: Deploy to production])
Respostas (assunto começando com Re:) pulam o prefixo do assunto — o contexto da conversa já está lá
Anexos são armazenados em cache localmente: imagens ficam disponíveis para a ferramenta de visão, documentos como PDFs e ZIPs para acesso a arquivos
E-mails somente HTML têm as tags removidas para extração de texto simples
Mensagens para si mesmo são filtradas para evitar loops de resposta
Remetentes automatizados são ignorados silenciosamente — noreply@, mailer-daemon@, bounce@ e e-mails com cabeçalhos Auto-Submitted, Precedence: bulk ou List-Unsubscribe

Enviando respostas. As respostas saem via SMTP com encadeamento adequado: os cabeçalhos In-Reply-To e References mantêm a conversa unida, o assunto mantém o prefixo Re: (sem Re: Re: duplicado) e as respostas são enviadas como texto UTF-8 simples.

Anexos de arquivo. Quer que o agente envie um arquivo de volta? Basta incluir MEDIA:/caminho/para/arquivo na resposta e ele será anexado automaticamente.

Ignorando anexos. Preocupado com malware ou largura de banda? Adicione isto ao config.yaml:

platforms:
  email:
    skip_attachments: true

O corpo do texto do e-mail ainda é processado normalmente — apenas os anexos são ignorados.

Controle de Acesso: Seja Restritivo por Padrão

O Email é mais bloqueado que plataformas de chat por design:

EMAIL_ALLOWED_USERS definido → apenas e-mails desses endereços são processados
Sem lista de permissões → remetentes desconhecidos são ignorados silenciosamente
EMAIL_ALLOW_ALL_USERS=true → qualquer remetente é aceito (use com cautela!)
platforms.email.unauthorized_dm_behavior: pair → remetentes desconhecidos recebem um código de pareamento

A regra de ouro: use uma caixa de entrada dedicada e sempre configure EMAIL_ALLOWED_USERS. O pareamento por e-mail é opcional porque caixas compartilhadas frequentemente contêm mensagens não lidas não relacionadas — o Hermes não deve responder a esses contatos por padrão.

Solução de Problemas

Problema	Solução
“Falha na conexão IMAP” na inicialização	Verifique `EMAIL_IMAP_HOST` e `EMAIL_IMAP_PORT`. Certifique-se de que o IMAP está habilitado na conta (Gmail: Configurações → Encaminhamento e POP/IMAP)

Concluindo

O adaptador de gateway de Email transforma qualquer caixa postal padrão em um canal de comunicação para o seu agente de IA. Sem dependências externas, sem clientes especiais — apenas IMAP, SMTP e um pouco de configuração. Configure uma conta dedicada, restrinja seus remetentes permitidos e deixe os e-mails fluírem.

Boas mensagens! 📧